List Inventory Items

Retrieve a paginated list of inventory items for an item-tracked store product.

Endpoint

GET /v1/store-products/{id}/inventory-items

Authentication

Requires an API key with the store:read scope.

Parameters

Parameter	Type	Location	Description
id	integer	path	The store product ID

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
per_page	integer	15	Items per page (max 100)
search	string	-	Search by identifier or unique identifier
variation_id	integer	-	Filter by product variation ID
location_id	integer	-	Filter by supplier location ID (see Locations)

Response

Success (200 OK)

{
  "data": [
    {
      "id": 1,
      "store_product_id": 5,
      "store_product_variation_id": null,
      "identifier": "WIDGET-1",
      "unique_identifier": "INV-00001",
      "total_quantity": 1,
      "supplier_location": {
        "id": 1,
        "name": "Main Store"
      },
      "has_barcode": true,
      "created_at": "2026-02-13T12:00:00+00:00",
      "updated_at": "2026-02-13T12:00:00+00:00"
    },
    {
      "id": 2,
      "store_product_id": 5,
      "store_product_variation_id": 3,
      "identifier": "WIDGET-2",
      "unique_identifier": "INV-00002",
      "total_quantity": 1,
      "supplier_location": null,
      "has_barcode": false,
      "created_at": "2026-02-13T12:00:00+00:00",
      "updated_at": "2026-02-13T12:00:00+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 15,
    "total": 2,
    "total_pages": 1,
    "request_id": "req_abc123",
    "timestamp": "2026-02-13T12:00:00+00:00"
  }
}

Response Fields

Inventory Item

Field	Type	Description
id	integer	Unique inventory item identifier
store_product_id	integer	The parent store product ID
store_product_variation_id	integer|null	Associated product variation ID (null if not variation-specific)
identifier	string|null	Item identifier (e.g., serial number, asset tag)
unique_identifier	string|null	System-generated unique identifier
total_quantity	integer	Always 1 for item-tracked products
supplier_location	object|null	Supplier location (id, name) if assigned
has_barcode	boolean	Whether this item has a barcode attached
created_at	string	ISO 8601 datetime
updated_at	string	ISO 8601 datetime

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks store:read scope
404	resource_not_found	Store product does not exist
422	not_item_tracked	Product does not use item-level inventory tracking

Example Request

curl -X GET "https://app.equipdash.com/api/v1/store-products/5/inventory-items?per_page=25" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..."