---
search:
  tags:
    - Orders
    - POST
seo:
  description: >-
    Cancel one whole order using its… Reference for the POST
    /v1/organizations/{orgId}/orders/{orderId}/cancel endpoint in the Stashtab
    Vault Warehouse API.
sidebar:
  label: Cancel an eligible whole order
  badge: POST
title: Cancel an eligible whole order
type: openapi-operation
---
Cancel one whole order using its current expectedRevision and a stable submissionKey. A redemption requires its persisted server hold to remain open strictly before cancellation.deadlineAt; it uses its native On hold order and does not require the ordinary picking acknowledgement. An ordinary order is eligible while it is On hold or Ready with no established shipment and the current customer policy allows cancellation; only a Ready order requires acknowledgePickingMayHaveStarted: true, and an On hold order accepts it without needing it. Vault rechecks native identity, store, revision and absence of an established shipment before a preserved-field cancellation, then confirms only from exact cancelled-order readback and its atomic receipt. An unknown result remains unresolved and is observed without another cancellation write. A successful receipt does not prove stopped physical picking, carrier handoff, refund, token restoration or escrow changes. Shared Test uses only its current simulated realm and never falls back to Live.

`POST /v1/organizations/{orgId}/orders/{orderId}/cancel`

**Request body** (`application/json`, required)

- `acknowledgePickingMayHaveStarted` (boolean)
- `expectedRevision` (string, required)
- `submissionKey` (string, required)

Request body example:

```json
{
  "acknowledgePickingMayHaveStarted": true,
  "expectedRevision": "string",
  "submissionKey": "stringst"
}
```

**Responses**

- `200` — Success
- `default` — Error

Response example, 200:

```json
{
  "data": {
    "effects": [
      "string"
    ],
    "operationId": "string",
    "outcome": "confirmed",
    "order": {
      "id": "string"
    }
  },
  "meta": {
    "requestId": "string"
  }
}
```
