Create a policy Run in API Explorer

POST /api/v1/policies

Creates a new policy object.

application/json

Body

  • effective_date string

    A timestamp used to determine the insurance policy start date.

  • expiration_date string

    A timestemp used to determine the insurance policy end date.

  • quote string Required

    The ID of the quote used to create the policy.

Responses

  • 201 application/json

    Returns the policy object if the post succeeded.

    Hide response attributes Show response attributes object
    • certificates object

      URLs to the certificates of insurance for each of the types of coverage issued to the contractor for the specific job assignment.

      Additional properties are allowed.

      Hide certificates attributes Show certificates attributes object
      • gl_coi_pdf_url string

        The general liability certificate of insurance PDF URL.

      • wc_coi_pdf_url string

        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.

    • status

      One of active, cancelled, or expired.

      Values are active, cancelled, or expired.
POST /api/v1/policies 
curl \
 --request POST https://api.1099policy.com/api/v1/policies \
 --header "Content-Type: application/json" \
 --data '{"quote":"qt_5DciVga8Kt","effective_date":1646818364,"expiration_date":1678334737}'
Request example 
{
  "quote": "qt_5DciVga8Kt",
  "effective_date": 1646818364,
  "expiration_date": 1678334737
}
Response examples (201) 
{
  "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"
}