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 theReasonCode
typelistcancellationSource.code
: A typecode from theCancellationSource
typelistjobEffectiveDate
: 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.