Responses

• 200 application/json

  Assignment end date updated, or unchanged (no-op) when end_date matches the current value. COIs are always regenerated asynchronously, so the response includes certificate_refresh_pending: true to indicate that certificate URLs are stale and fresh URLs will be available in the webhook.

  One of:

  Assignment object Quote object

  To secure coverage for independent contractors that have previously had a policy issued through the 1099Policy platform, you create an Assignment object.

  Independent contractors with an existing insurance policy procured using the 1099Policy platform have the option to receive per-job-assignment insurance coverage without having to complete additional insurance applications, provided certain eligibility criteria are met.

  You can find the result of the eligibility check in the API response. Eligiblity is determined by parameters provided, including job and contractor. In particular, we look to see if the job category_code is the same as previously approved and the time since the independent contractor completed their insurance application.

  1099Policy automatically charges the independent contractor's credit card on file, if a credit card exists and bind is true. 1099Policy first notifies the contractor via email and then charges the contractor the premium amount due 24hrs later.

  Hide attributes Show attributes

  • bind

    Indicates whether to start the process of binding coverage, which includes notifying and subsequently charging the independent contractor for the premium amount due. Defaults to true. When false, 1099Policy does not notify or schedule a charge. Note that the independent contractor will not be issued coverage if bind is set to false.

    Default value is true.

  • certificates 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 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.

  • contractor string

    ID of the contractor.

  • coverage_type array[string]

    An array of coverage types that can include one or more of the following insurance coverage values: general, professional and workers-comp. If provided, coverage type is factored into the eligibility determination (i.e., does contractor have an active workers-comp policy, etc). Defaults to the coverage types of the most recent active policy if coverage_type is not provided.

    Values are general, professional, or workers-comp.

  • created integer(int64)

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

  • effective_date integer(int64)

    The job assignment start date, measured in seconds since the Unix epoch.

  • eligible object

    Object with the result of the insurance eligiblity check for a given job assignment.

    Hide eligible attributes Show eligible attributes object

    • message string

      A message with more detail related to the eligibility result.

    • result boolean

      The result of the insurance eligibility check.

  • end_date integer(int64)

    The projected job assignment end date, measured in seconds since the Unix epoch.

  • id string

    Unique identifier for the object.

  • job string

    ID of the job that the contractor intends to accept.

  • net_rate integer

    The amount of money the 1099 contractor pays in premium per every $100 earned.

    A positive integer representing the premium owed per $100 earned. The net_rate is stored in cents (e.g., 48 represents $0.48).

  • policy string

    ID of the policy that you want attached to the assignment. Defaults to the most recent active policy with a matching job category code, work state and contractor home state.

  The Quote object reflects whether a contractor is eligible for insurance and the premium owed for every $100 earned.

  Important note: In North Dakota, Ohio, Washington and Wyoming, workers compensation can only be purchased through a government operated insurance company. As a result, the quote API returns an error when a quote request is made for workers compensiation for any one of these four states.

  Hide attributes Show attributes

  • contractor string

    ID of the contractor.

  • coverage_type array[string]

    An array of coverage types that can include one or more of the following insurance coverage values: general, professional, workers-comp, media, and cyber.

    Values are general, professional, workers-comp, media, or cyber.

  • created integer(int64)

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

  • effective_date string(int64)

    The date when the insurance coverage is set to take effect. Measured in seconds since the Unix epoch. This date must be set in the future. The default effective_date is the next day.

  • eligible boolean

    Indicates whether a contractor is elgible for insurance or not.

    Default value is true.

  • end_date string(int64)

    The date when the insurance coverage is set to expire. Measured in seconds since the Unix epoch. This date must be after the effective date. The default end_date is 30 days after the effective date.

  • gl_net_rate integer

    The amount of money the 1099 contractor pays in general liability premium per every $100 earned.

    A positive integer representing the premium owed per $100 earned. The gl_net_rate is stored in cents (e.g., 48 represents $0.48).

  • id string

    Unique identifier for the object.

  • job string

    ID of the job that the contractor was paid to do.

  • net_rate integer

    The amount of money the 1099 contractor pays in premium per every $100 earned.

    A positive integer representing the premium owed per $100 earned. The net_rate is stored in cents (e.g., 48 represents $0.48).

  • quote_json object

    The JSON representation of component parts that make up the total premium amount due including, for example, the net rate, taxes, and fees.

  • wc_net_rate integer

    The amount of money the 1099 contractor pays in workers comp premium per every $100 earned.

    A positive integer representing the premium owed per $100 earned. The wc_net_rate is stored in cents (e.g., 48 represents $0.48).

• 400

  Invalid input, voided or cancelled record, expired coverage, attempted shortening, or same end date when no-op is not allowed.

• 404

  Job not found, or no assignment found for the associated job id.