> ## Documentation Index
> Fetch the complete documentation index at: https://docs.djigui.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel a quote

> Cancel a quote nobody is paying.

Cancels a quote that is `awaiting_payment`. The quote stays in [`GET /quote`](https://docs.djigui.io/api-reference/quotes/list) with the status `cancelled`, and can no longer be paid. See [Quotes](https://docs.djigui.io/guides/quotes.md#cancelling-a-quote).

Cancelling a cancelled quote again changes nothing: it answers `200` with the quote.

**id** `string` *required*

The quote's id.

## Response

`200 OK`, with the quote and the fields of [Create a quote](https://docs.djigui.io/api-reference/quotes/create.md#response). Its `status` is `cancelled`.

## Errors

| Status | `code` | |
| - | - | - |
| 404 | `quote_not_found` | No quote with this id in your company. |
| 409 | `payment_in_progress` | A payment is waiting for the payer. Wait for it to settle. `paymentId` and `paymentUrl` are that payment's. |
| 409 | `quote_already_paid` | The quote already has a contract. |
| 410 | `quote_expired` | The quote was not paid within 24 hours. |

```bash cURL theme={null}
curl -X POST https://businessapi-staging-civ.djigui.io/api/v1.0/quote/6c1d8f0e-3b7a-4f5e-9a51-2d0c7e8b4a12/cancel \
  -H "x-api-key: $DJIGUI_API_KEY"
```

```json 200 theme={null}
{
  "id": "6c1d8f0e-3b7a-4f5e-9a51-2d0c7e8b4a12",
  "status": "cancelled",
  "contractId": null,
  "amount": 98450,
  "duration": 12,
  "usage": "pleasure",
  "startDate": "2026-11-01",
  "policyHolderName": "Kouamé Yao Serge",
  "policyHolderPhone": "+2250757468458",
  "coverageId": "20000000-0000-4000-8000-000000000001",
  "coverage": { "id": "20000000-0000-4000-8000-000000000001", "name": "Tiers simple", "description": "Responsabilité civile", "order": 1, "properties": [] },
  "vehicle": { "id": "0f9b2abd-2fe8-4346-b49e-4a6aefd89a89", "licencePlate": "1234AB01", "...": "..." },
  "created": "2026-10-20T09:16:41.007Z",
  "expires": "2026-10-21T09:16:41.007Z"
}
```

```json 409 theme={null}
{
  "code": "payment_in_progress",
  "message": "A payment for this quote is already waiting for the payer.",
  "paymentId": "b4e8a2c6-7d1f-4a3b-9e5c-8f0a1b2c3d4e",
  "paymentUrl": "https://pay.wave.com/c/cos-1a2b3c4d5e6f"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.