List inventory items

GET 
/openapi/2026-07/inventory_items

Returns a paginated list of inventory items.

Request

Query Parameters

inventory_item_ids string[]

List of inventory ids, must contain at least one ID. Example: ?inventory_item_ids=1001&inventory_item_ids=1002

cursor string

Cursor for pagination

page_size int32

A limit on the number of objects to return

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

inventory_items object[]

List of inventory items

Array [

idstring

Inventory item ID

product_idstring

Product ID

variant_idstring

Variant ID

trackingboolean

Tracking information

tracking_policystring

Tracking policy

created_atstring

Creation timestamp, in ISO-8601 format

updated_atstring

Last update timestamp, in ISO-8601 format

]

cursorstring

Cursor for pagination

has_moreboolean

Whether there are more records

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "inventory_items": [
      {
        "id": "string",
        "product_id": "string",
        "variant_id": "string",
        "tracking": true,
        "tracking_policy": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}