Upload one or more COI certificates and create/update contractor information.

POST /api/v1/files/external_certificates/tracker

This endpoint accepts one or more PDF certificate files via the 'certificates' parameter and creates or updates contractor information based on the provided details. All certificates will be associated with the same contractor.

multipart/form-data

Body

  • business_name string Required

    Business name of the contractor

  • certificates array[string(binary)] Required

    One or more certificate PDF files

  • create_new_contractor boolean

    Whether to create a new contractor (true) or select existing (false). Defaults to false.

  • email string Required

    Email of the contractor

  • first_name string Required

    First name of the contractor

  • insurance_requirement_id string

    Insurance requirement ID (optional)

  • last_name string Required

    Last name of the contractor

  • purchase_order_contact_email string

    Purchase order contact email (optional)

  • purchase_order_contact_name string

    Purchase order contact name (optional)

  • tracker_id string

    Tracker ID for coverage rules (optional, but either tracker_id or tracker_session_id must be provided)

  • tracker_session_id string

    Tracker session ID (optional, but either tracker_id or tracker_session_id must be provided)

Responses

  • 201 application/json

    Certificates uploaded successfully

    Hide response attributes Show response attributes object
    • assignment string

      The ID of the assignment

    • certificates array[object]
      Hide certificates attributes Show certificates attributes object
      • filename string

        The filename of the uploaded certificate

      • id string

        The ID of the uploaded certificate

    • contractor string

      The ID of the contractor

    • job string

      The ID of the job
POST /api/v1/files/external_certificates/tracker 
curl \
 --request POST 'https://api.1099policy.com/api/v1/files/external_certificates/tracker' \
 --header "Content-Type: multipart/form-data" \
 --form "business_name=string" \
 --form "certificates[]=@file" \
 --form "create_new_contractor=true" \
 --form "email=string" \
 --form "first_name=string" \
 --form "insurance_requirement_id=string" \
 --form "last_name=string" \
 --form "purchase_order_contact_email=string" \
 --form "purchase_order_contact_name=string" \
 --form "tracker_id=string" \
 --form "tracker_session_id=string"
Response examples (201) 
{
  "assignment": "string",
  "certificates": [
    {
      "filename": "string",
      "id": "string"
    }
  ],
  "contractor": "string",
  "job": "string"
}