**Version: 202601**

# List inventory

**GET** `/openapi/2026-01/inventory_levels`

Returns a paginated list of inventory levels.

## Request

**Query Parameters**

- `inventory_item_ids` string[]

  List of inventory item IDs. Example: ?inventory\_item\_ids=1003&inventory\_item\_ids=1004
- `location_ids` string[]

  Location to filter inventory details (optional) ID. Example: ?location\_ids=3001&location\_ids=3002
- `cursor` string

  Cursor for pagination
- `page_size` int32

  A limit on the number of objects to return
- `page` int32

  Page number (1-based). Mutually exclusive with cursor
- `updated_at_min` string

  Minimum update time (ISO 8601 format, e.g., 2018-10-01T16:15:47-04:00)

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `inventory_levels` object[]

    List of inventory levels

    *   Array \[

    - `inventory_item_id` string

      Inventory item ID
    - `location_id` string

      Location ID
    - `stock` int64

      Stock quantity
    - `updated_at` string

      Last update timestamp, in ISO-8601 format
    *   \]
  - `cursor` string

    Cursor for pagination
  - `has_more` boolean

    Whether there are more records

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "inventory_levels": [
      {
        "inventory_item_id": "string",
        "location_id": "string",
        "stock": 0,
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```