Cancellation

The cancellation policy transaction can be applied to a bound policy that is in force. A cancellation request must include the requesting source (insurer or insured), a reason for the cancellation, and an effective date. The effective date of the cancellation will depend on several factors, related to the requesting source and product configuration. For a general overview of how to conduct policy transactions using the system APIs, see Policy transactions. For details on cancellations and other policy transactions in PolicyCenter, see Application Guide.

Cancel the policy

Initiate the cancellation policy transaction.
Submit a business action POST to the /policy/v1/policies/{policyId}/cancel endpoint.

The request payload must contain at minimum the following fields and value types:
- cancellationReasonCode.code: A typecode from the ReasonCode typelist
- cancellationSource.code: A typecode from the CancellationSource typelist
- jobEffectiveDate: A date string
```
{
    "data": {
        "attributes": {
            "cancellationReasonCode": {
                "code": "cancel"
            },
            "cancellationSource": {
                "code": "carrier"
            },
            "jobEffectiveDate": "2020-08-15"
        }
    }
}
```
The response payload contains the associated job, which is in Quoted state. Use the job ID in the subsequent call.

Complete the cancellation.

The following table illustrates the various ways that a quoted cancellation job can be completed:


Transaction outcome	Action	Endpoint
Accepted	Cancel the policy immediately	`/job/v1/jobs/{jobId}/bind-and-issue`
Pending	Schedule a cancellation for a future date	`/job/v1/jobs/{jobId}/pending-cancel`
Rescheduled	Change the process date for the scheduled cancellation	`/job/v1/jobs/{jobId}/reschedule`
Rescinded	Rescind the scheduled cancellation	`/job/v1/jobs/{jobId}/rescind`
Withdrawn	Withdraw the cancellation job	`/job/v1/jobs/{jobId}/withdrawn`

Submit a business action POST to the relevant endpoint.