Cancel A Contract
POST
https://api.getcovent.com/api/v1/offers/{id}/cancel-contractCancel a contract tied to the offer.
How to Call
Use one of the examples below to call this endpoint from your own integration.
curl -X POST "https://api.getcovent.com/api/v1/offers/{id}/cancel-contract" \
-H "Authorization: Bearer <API_KEY>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"cancelled_at": "2026-04-19T11:00:00Z",
"reason": "inspection_issue",
"notes": "Buyer cancelled after contractor walk."
}'Request
Review headers, parameters, and body fields before calling this endpoint.
AuthorizationstringRequired
Bearer token for the proposed external API contract.
Example: Bearer <API_KEY>AcceptstringRequired
Response format header.
Example: application/jsonContent-TypestringRequired
JSON request body header.
Example: application/jsonidstringRequired
id path parameter.
Example: <id>cancelled_atstringRequired
cancelled_at request field.
Example: 2026-04-19T11:00:00ZreasonstringRequired
reason request field.
Example: inspection_issuenotesstringRequired
notes request field.
Example: Buyer cancelled after contractor walk.Response
200application/jsonidstringRequired
id response field.
Example: off_123statusstringRequired
status response field.
Example: cancelledcancelled_atstringRequired
cancelled_at response field.
Example: 2026-04-19T11:00:00Zupdated_atstringRequired
updated_at response field.
Example: 2026-04-19T11:00:00ZResponse Example
{
"id": "off_123",
"status": "cancelled",
"cancelled_at": "2026-04-19T11:00:00Z",
"updated_at": "2026-04-19T11:00:00Z"
}