---
search:
  tags:
    - Orders
    - POST
seo:
  description: >-
    Reads 1–20 known order IDs in request order using… Reference for the POST
    /v1/organizations/{orgId}/orders/batch endpoint in the Stashtab Vault
    Warehouse API.
sidebar:
  label: Get multiple orders
  badge: POST
title: Get multiple orders
type: openapi-operation
---
Reads 1–20 known order IDs in request order using the same customer-safe recipient, status and tracking facts as each individual order read. Duplicate IDs repeat the same result and are read once. Foreign or missing IDs return missing. A provider-unavailable item returns unavailable with retryAfterSeconds when validated timing is available; wait that long before polling that ID again. An available order can still have null current facts when the warehouse no longer reports it. Read-capable organization keys may use this operation within their immutable organization and mode. Provider budgets and current authority still apply. An available redemption includes the same packingException as getOrder, so a batch read is the discovery path for packing exceptions: poll every redemption that has not shipped at least once an hour.

`POST /v1/organizations/{orgId}/orders/batch`

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

- `orderIds` (string[], required)

Request body example:

```json
{
  "orderIds": [
    "order_example_1",
    "order_example_missing"
  ]
}
```

**Responses**

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

Response example, 200:

```json
{
  "data": {
    "items": [
      {
        "order": {
          "customerLabel": null,
          "id": "order_example_1",
          "kind": "ordinary",
          "receipt": {
            "operationId": null,
            "recordedAt": "2026-11-05T15:00:00.000Z"
          },
          "visibleOrderNumber": null,
          "current": null,
          "sourceOrderId": null
        },
        "orderId": "order_example_1",
        "status": "available"
      },
      {
        "orderId": "order_example_missing",
        "status": "missing"
      }
    ]
  },
  "meta": {
    "requestId": "example-batchGetOrders"
  }
}
```
