---
title: "Cancel batch of orders by order IDs"
method: DELETE
path: "/orders/batch"
tags: ["Orders"]
---

# Cancel batch of orders by order IDs

`DELETE /orders/batch`

Queues cancellation for multiple orders by providing identifiers in a batch.

The request body can contain either or both of:
- `order_ids`: Array of order IDs assigned by Paradex
- `client_order_ids`: Array of client-assigned order IDs

```json
{
  "order_ids": ["order-id-1", "order-id-2"],
  "client_order_ids": ["client-id-1", "client-id-2"]
}
```

Returns a 200 OK status code with detailed results for each order:

```json
{
  "results": [
    {
      "id": "order-id-1",
      "client_id": "client-id-X",
      "account": "account-1",
      "market": "BTC-USD-PERP",
      "status": "QUEUED_FOR_CANCELLATION"
    },
    {
      "id": "order-id-2",
      "client_id": "client-id-Y",
      "account": "account-1",
      "market": "ETH-USD-PERP",
      "status": "ALREADY_CLOSED"
    },
    {
      "id": "order-id-3",
      "client_id": "client-id-1",
      "account": "account-1",
      "market": "BTC-USD-PERP",
      "status": "QUEUED_FOR_CANCELLATION"
    },
    {
      "client_id": "client-id-2",
      "status": "NOT_FOUND"
    }
  ]
}
```

Each result includes:
- `id`: Order ID (if the order was found)
- `client_id`: Client order ID (if available)
- `account`: Account that owns the order
- `market`: Market of the order
- `status`: One of:
  + `QUEUED_FOR_CANCELLATION`: Order was successfully queued for cancellation
  + `ALREADY_CLOSED`: Order was already in a closed state
  + `NOT_FOUND`: The order with the provided ID/client ID was not found

Confirmation of cancellation will be sent via websocket or can be verified from
GET /orders/:id endpoint.

Orders that are already in a CLOSED state will be included in the response with
status "ALREADY_CLOSED".

## Request body

- RequestsCancelOrderBatchRequest
  - `client_order_ids` string[] — List of client order IDs to cancel
  - `order_ids` string[] — List of order IDs to cancel

## Response `200`

List of cancellation results

- ResponsesCancelOrderBatchResponse
  - `results` ResponsesCancelOrderResult[] — List of cancellation results
    - `account` string — Account that owns the order
    - `client_id` string — Client order ID
    - `id` string — Order ID
    - `market` string — Market of the order
    - `status` string — Status of the cancellation: QUEUED_FOR_CANCELLATION, ALREADY_CLOSED, NOT_FOUND

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/tradeparadex/apis/paradex-rest-api-2.md) · [All operations](https://skmtc.net/tradeparadex/apis/paradex-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tradeparadex/paradex-rest-api-2/versions/6a76453d754c/schema)