---
title: "Cancel an order"
method: POST
path: "/v1/orders/{id}/cancel"
tags: ["Orders"]
---

# Cancel an order

`POST /v1/orders/{id}/cancel`

Cancel an order that is still `awaiting_payment`. Any other state returns
`409` (you can't cancel an order that's already paid or processing).

## Path parameters

- `id` string, uuid, required

## Response `200`

Order cancelled.

- object
  - `order_id` string, uuid, required
  - `status` 'cancelled', required

## Other responses

- `401` — Missing or invalid `X-Api-Key`.
- `404` — No such order for this tenant.
- `409` — The order is not in `awaiting_payment` and cannot be cancelled.
- `429` — A rate limit was reached — the per-minute request budget, the tighter pricing/recipient-check probe cap (60 req/min), the daily order cap, or the per-recipient flood guard. See **Rate limits** in the overview. The per-minute-budget responses also carry `RateLimit-*` + `Retry-After` headers.

---

[API](https://skmtc.net/mystars/apis/mystars-faas-fulfilment-api.md) · [All operations](https://skmtc.net/mystars/apis/mystars-faas-fulfilment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mystars/mystars-faas-fulfilment-api/revisions/3c24cb3dfa12/schema)