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

# Cancel a member order

> Cancel an order owned by a member of the API client

Cancels an order that belongs to a member of the API client. The order's status
flips from `Active` to `Terminated`, escrowed funds are reversed, and an
`order.cancelled` webhook event is fired.

<ParamField path="id" type="string" required>
  The ID of the member who owns the order.
</ParamField>

<ParamField path="orderId" type="string" required>
  The ID of the order to cancel.
</ParamField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "message": "Order has been cancelled successfully",
    "data": {
      "_id": "665f2a1c9d3e4b0012ab34cd",
      "token": "660018c2f4a1b20011a9e0b1",
      "user": "65fe0a7c1b2c3d0011223344",
      "price": 1.5,
      "currency": "USD",
      "amount": 100,
      "type": "Buy",
      "owner_model": "organisation",
      "status": "Terminated",
      "createdAt": "2026-07-20T10:15:00.000Z",
      "updatedAt": "2026-07-23T12:43:48.000Z"
    }
  }
  ```
</ResponseExample>

## Error responses

| Status | Error code                          | When                               |
| ------ | ----------------------------------- | ---------------------------------- |
| 403    | `USER_MISMATCH_ERROR`               | Order doesn't belong to the member |
| 400    | `ORDER_TERMINATED_ERROR`            | Order is already cancelled         |
| 400    | `ORDER_FULFILLED_ERROR`             | Order is already fulfilled         |
| 403    | `ORDER_OPERATION_NOT_ALLOWED_ERROR` | Order type can't be cancelled      |

```json theme={null}
{
  "status": "error",
  "message": "You do not have access to this order"
}
```