Cancel an assignment

POST /api/v1/assignments/cancel

Cancels an existing assignment based on the provided job ID. If you attempt to cancel an assignment after it has started, the request will fail. If you need the option to cancel an assignment after its start date, please contact us.

Servers

• Production server: https://api.1099policy.com (Production server)

Parameters

Body: application/json (object)

• job_id (string)
  The ID of the job associated with the assignment

• reason (string)
  Optional reason for cancellation

Responses

200

Assignment successfully cancelled

Body: application/json (object)

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

• certificates (object)

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

• created (integer(int64))

• effective_date (integer(int64))
  The job assignment start date, measured in seconds since the Unix epoch.

• eligible (object)

• end_date (integer(int64))
  The projected job assignment end date, measured in seconds since the Unix epoch.

• id (string)

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

400

Invalid request or assignment cannot be cancelled

404

No assignment found for the associated job id.