---
title: "List Inventory Items"
method: GET
path: "/stores/{storeId}/inventory-items"
tags: ["Inventory Items"]
---

# List Inventory Items

`GET /stores/{storeId}/inventory-items`

List in-stock inventory items. Only items with on-hand quantity greater than zero are returned. Sorted by most recently updated first.
Requires the [`inventory_read`](/docs/api-reference/scopes) scope.

## Query parameters

- `location_id` string
- `kind` 'PRODUCT' | 'RETURN' | 'UNDECLARED' | 'UNKNOWN'

## Headers

- `X-Page-Continue` string
- `X-Page-Size` integer

## Response `200`

Success

- object
  - `inventory_items` InventoryItemListSchema[], required
    - `id` string, required — Prefixed inventory item ID (`ii_...`).
    - `sku` string, nullable, required — Stock keeping unit from the linked product.
    - `name` string, nullable, required — Product title including variant options.
    - `kind` 'PRODUCT' | 'RETURN' | 'UNDECLARED' | 'UNKNOWN', required — Inventory item kind.
    - `quantity` integer, required — On-hand quantity. When `location_id` is supplied as a query filter, this is the quantity at that location; otherwise it is the total across all locations.
    - `locations` InventoryItemLocationSchema[], required — Per-location quantities for this inventory item.
      - `location_id` string, required — Prefixed location ID (`loc_...`).
      - `location_name` string, required — Location name.
      - `quantity` integer, required — On-hand quantity at this location.
    - `created_at` string, date-time, required — Creation timestamp (ISO 8601).
    - `updated_at` string, date-time, required — Last updated timestamp (ISO 8601).

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/redoapp/apis/redo-api.md) · [All operations](https://skmtc.dev/redoapp/apis/redo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redoapp/redo-api/revisions/119714540a45/schema)