# Batch Retrieve Orders Request

Defines the fields that are included in requests to the
`BatchRetrieveOrders` endpoint.

## Structure

`BatchRetrieveOrdersRequest`

## Fields

| Name | Type | Tags | Description |
|  --- | --- | --- | --- |
| `locationId` | `string \| null \| undefined` | Optional | The ID of the location for these orders. This field is optional: omit it to retrieve<br>orders within the scope of the current authorization's merchant ID. |
| `orderIds` | `string[]` | Required | The IDs of the orders to retrieve. A maximum of 100 orders can be retrieved per request. |

## Example (as JSON)

```json
{
  "location_id": "057P5VYJ4A5X1",
  "order_ids": [
    "CAISEM82RcpmcFBM0TfOyiHV3es",
    "CAISENgvlJ6jLWAzERDzjyHVybY"
  ]
}
```