---
title: "Cancel an order while its current state allows cancellation"
method: POST
path: "/v1/orders/{orderId}/cancel"
---

# Cancel an order while its current state allows cancellation

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

## Request

- Base URL: `https://buyingmesh.com`
- URL: `https://buyingmesh.com/v1/orders/{orderId}/cancel`
- Auth: none declared

## Path parameters

- `orderId` string, uuid, required

## Request body

- object
  - `reason` string

## Response `200`

Cancelled order

- ApiOrderResponse
  - `status` 'ok', required
  - `data` Order, required
    - `id` string, uuid, required
    - `status` 'confirmed' | 'shipped' | 'tracking_updated' | 'eta_updated' | 'delivered' | 'accepted' | 'released' | 'disputed' | 'cancelled', required
    - `tracking` object, nullable
    - `supplier` object
      - `supplierId` string, nullable
      - `supplierName` string, nullable
      - `supplierSlug` string, nullable
    - `supplierIds` string[]
    - `agent` object, nullable
    - `items` object[]
    - `testMode` boolean
    - `eta` string, date-time, nullable
    - `events` object[], required
      - `type` string
      - `occurredAt` string, date-time
    - `payment` object, required
      - `status` string
      - `gross` number
      - `platformFee` number
      - `sellerNet` number
      - `currency` string
  - `error` unknown, required

## Other responses

- `409`: Idempotency or inventory conflict

---

[API](https://skmtc.dev/buyingmesh/apis/buyingmesh-procurement-api.md) · [All operations](https://skmtc.dev/buyingmesh/apis/buyingmesh-procurement-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buyingmesh/apis/buyingmesh-procurement-api/revisions/370360c1315c?raw)