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


[Powered by Bump.sh](https://bump.sh)