Skip to main content

inventoryItem

Get a single inventory item by ID.

inventoryItem(
  id: ID!
): InventoryItem!

Arguments​

inventoryItem.id ● ID! non-null scalar​

The ID of the inventory item to retrieve.

Type​

InventoryItem object​

Represents an inventory item that tracks stock quantities and locations for a specific product within a brand's warehouses.

Inventory Calculations​

The inventory system uses a hierarchical structure where:

  • **Physical** = Total units present in the building
  • **Available** = Physical - Reserved (units available for sale)
  • **Stock** = Physical - Unavailable (usable inventory)
  • **Allocated** = Units assigned to specific orders

Warehouse Filtering​

Most quantity fields accept an optional warehouse_id argument to get inventory levels for a specific warehouse. When omitted, returns totals across all active warehouses.

Depth Status​

The depth field indicates stock availability:

  • FULL_STOCK: Available inventory exceeds ordered quantities
  • OUT_OF_STOCK: No available inventory
  • OVERSOLD: Ordered quantities exceed available inventory

Incoming Items​

The incoming_items field shows ASN (Advanced Shipping Notice) items that haven't been closed yet, ordered by expected arrival date (earliest first).