# Preview an order cancellation (/docs/api-reference/orders/get-cancellation-preview)

`GET /v1/orders/{id}/cancellation-preview`

Previews cancelling every item of an order now, with the totals.

Requires the `read` order permission. Returns `{ orderId, currency, items, totals }`, every amount
in the order currency. Each item has `orderItemId`, `productType` and `status`.
`previewable` items carry `preview`, the same payload as
`GET order-items/{id}/cancellation-preview` (`isRefundable: false` included). An item whose
`actions.cancellation` is `available` is `previewable`, unless its refund failed; a rejected
one previews a full refund with no penalty. `notCancellable` items carry a `reason`:
`notFulfilled` (not delivered: unpaid, still being delivered, or rejected while its outcome is
confirmed), `refunded`, `refundInProgress` (a refund was started and has not finished, or it failed
and cancelling the item retries it), `amendmentInProgress`,
`manualReview` (contact support) or `notAllowed` (the product's rules do not allow cancelling it
now). `totals` sums `penaltyAmount`, `cancellationFee` and `refundAmount` over the
`previewable` items; `totals.isComplete` is `true` only when every item is
`previewable`.
            
The preview cancels nothing, changes no state and locks no amount: cancelling an item prices its
cancellation again. Only an item the item preview refuses is `notAllowed`: a booking system that cannot answer
right now fails this whole call, with `503` when it is unavailable, as it fails the item preview.
Retry later. An order of another partner, or an unknown id, returns `404` with code `10004`.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `id` | path | yes | `string` | Order id (`id` from the order response). |

## Responses

### 200

OK

- `text/plain`: `OrderCancellationPreview`
- `application/json`: `OrderCancellationPreview`
- `text/json`: `OrderCancellationPreview`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 403

Forbidden

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 404

Not Found

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

### 503

Service Unavailable

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.