Update a policy

PUT /api/v1/policies/{policy_id}

Policies can be switched on and off using the is_active flag. Use this functionality if you don't have preset policy start and end times.

application/json

Body

  • effective_date integer(int64)

    A timestamp used to determine the insurance policy start date. Measured in seconds since the Unix epoch. The default effective_date is the next day.

  • expiration_date integer(int64)

    A timestemp used to determine the insurance policy end date. Measured in seconds since the Unix epoch. The default expiration_date is 30 days after the effective_date.

  • id string
  • quote string

    The ID of the quote used to create the policy.

Responses

  • 200 application/json

    Returns the policy object if the update succeeded. Returns an error if update parameters are invalid.

    Hide response attributes Show response attributes object
    • URLs to the certificates of insurance for each of the types of coverage issued to the contractor for the specific job assignment.

      Hide certificates attributes Show certificates attributes
      • The general liability certificate of insurance PDF URL.

      • The workers compensation certificate of insurance PDF URL.

    • created integer(int64)

      Time at which the object was created. Measured in seconds since the Unix epoch.

    • effective_date integer(int64)

      A timestamp used to determine the insurance policy start date. Measured in seconds since the Unix epoch. The default effective_date is the next day.

    • expiration_date integer(int64)

      A timestemp used to determine the insurance policy end date. Measured in seconds since the Unix epoch. The default expiration_date is 30 days after the effective_date.

    • id string
    • pdf_url string

      A URL for the hosted insurnace policy PDF, which contractors can view.

    • quote string

      The ID of the quote used to create the policy.

    • One of active, cancelled, or expired.

      Values are active, cancelled, or expired.

PUT /api/v1/policies/{policy_id}
curl \
 -X PUT https://api.1099policy.com/api/v1/policies/{policy_id} \
 -H "Content-Type: application/json" \
 -d '{"effective_date":1646818364,"expiration_date":1678334737,"quote":"qt_5DciVga8Kt"}'
Request example
{
  "effective_date": 1646818364,
  "expiration_date": 1678334737,
  "quote": "qt_5DciVga8Kt"
}
Response examples (200)
{
  "certificates": {
    "gl_coi_pdf_url": "/bound-policies/prod/gl_coi_pl_wv23Q3lMc1_1691450123.pdf",
    "wc_coi_pdf_url": "/bound-policies/prod/wc_coi_pl_wv23Q3lMc1_1691420903.pdf"
  },
  "created": 1646818364,
  "effective_date": 1646818364,
  "expiration_date": 1678334737,
  "id": "pl_WzFRszJhoY",
  "pdf_url": "http://ten99policy.s3.amazonaws.com/1099policy-coi-sample.pdf",
  "quote": "qt_5DciVga8Kt",
  "status": "active"
}