Cancel a policy

POST

/v1/policy/{policyId}/cancel

Cancels an active or pending policy. reason is required. effectiveDate is optional — when omitted, cancellation is immediate. A policy already cancelled returns 409.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Policy cancelled.

Bodyapplication/json

🟠409

🟠400ValidationError

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/policy//cancel' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "reason": "Customer requested cancellation",
    "effectiveDate": "2026-12-01"
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "policyId": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
        "policyNumber": "26043HJRJTL",
        "status": "cancelled",
        "cancelledAt": "2026-04-29T01:46:03.757Z",
        "cancellationReason": "Customer requested cancellation",
        "effectiveDate": "2026-12-01"
    }
}

Modified at 2026-05-05 23:28:05

Renewal payment

SuccessResponse