**版本：202601**

# 查询库存列表

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

分页返回库存层级列表。

## 请求

**Query参数**

- `inventory_item_ids` string[]

  库存项 ID 列表。 示例：?inventory\_item\_ids=1003&inventory\_item\_ids=1004
- `location_ids` string[]

  地点 ID 列表。 示例：?location\_ids=3001&location\_ids=3002
- `cursor` string

  分页游标
- `page_size` int32

  每页记录数
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `updated_at_min` string

  筛选最后更新时间不早于该时间点的库存层级；ISO 8601 格式，例如：`2018-10-01T16:15:47-04:00`

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `inventory_levels` object[]

    库存层级列表

    *   Array \[

    - `inventory_item_id` string

      库存项 ID
    - `location_id` string

      地点 ID
    - `stock` int64

      库存数量
    - `updated_at` string

      最后更新时间，ISO-8601 格式
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```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
  }
}
```