Cancel a claim
Cancels an insurance claim that is still in a cancellable state.
Cancellable States:
- `pending` - Claim is waiting for review
- `under_review` - Claim is being reviewed
- `ready_to_submit` - Carrier claim ready but not submitted
Non-Cancellable States:
- Claims already submitted to carrier
- Approved claims (payment in progress)
- Denied claims
- Already cancelled or closed claims
Parameters
Path Parameters
id
string
Required
Shipping label ID
claimId
string
Required
Insurance claim ID
Request Body
reason
string
Optional reason for cancellation
Returns
200
Claim cancelled successfully
400
Claim cannot be cancelled
401
Authentication required
403
Not authorized to cancel this claim
404
Claim not found
Related
Insurance
POST/api/v1/insurances/[id]/claim/[claimId]/cancel