Cancel Extended Warranty
You can cancel an extended warranty by individualCustomerProductId using this service. This endpoint supports idempotent behavior - if the warranty is already canceled, it returns the existing cancellation data without error.
Request
curl --location --request POST '<BASE_URL>/individual-customer-products/{individualCustomerProductId}/extended-warranty/cancel'
--header 'Content-Type: application/json'
--header 'Authorization: <jwtToken>'
--data '{
"deletedReason": "<string>"
}'
Info
The request body is optional. You can send the request without a body to cancel the extended warranty without specifying a reason.
Path Variables
| Parameter | Type | Required | Description |
|---|---|---|---|
| individualCustomerProductId | Integer | Yes | The ID of the individual customer product |
Request Body
| Parameter | Type | Required | Max Length | Description |
|---|---|---|---|---|
| deletedReason | String | No | 1000 | Reason for cancellation |
Response
{
"deletedDate": "2026-01-13T10:30:00",
"deleted": true,
"deletedId": 1,
"individualCustomerProductId": 12345
}
Response Body
| Parameter | Type | Description |
|---|---|---|
| deletedDate | LocalDateTime | The date and time when the warranty was canceled |
| deleted | Boolean | Always true after successful cancellation |
| deletedId | Integer | Unique cancellation ID |
| individualCustomerProductId | Integer | The ID of the individual customer product |
Error Responses
| Error | HTTP Status | Description |
|---|---|---|
| Extended warranty not found | 404 | No extended warranty exists for the given individualCustomerProductId |
| Invalid request | 400 | deletedReason exceeds 1000 characters |
Idempotent Behavior
This endpoint is idempotent. If you call it multiple times with the same individualCustomerProductId, subsequent calls will return the existing cancellation data without modifying the record or throwing an error.