inventory_read
Arguments
ID!
required
The id of the ledger entry to fetch.
Returns
An append-only ledger row describing a quantity change at a bin-level inventory level.
Show fields
Show fields
Int!
required
On-hand quantity at this inventory level immediately after this entry.
The bin-level inventory record this ledger row belongs to.Requires:
inventory_readShow fields
Show fields
ID!
required
The id of this bin-level inventory record.
The specific inventory item this level tracks, when item-scoped.Requires:
inventory_readShow fields
Show fields
required
Bin-level quantity rows for this inventory item.Requires:
inventory_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.Planned disposition for return inventory.
Condition grade, when applicable.
ID!
required
The id of this inventory item.
Item classification.
required
The kind of inventory unit.
The warehouse this unit is associated with.Requires:
locations_readString
Lot number, when lot tracking applies.
The product this unit is tied to, when applicable.Requires:
inventory_readInt!
required
The number of units this record represents.
The bin or slot where this unit currently resides.Requires:
locations_readThe product this quantity belongs to, when the level is product-scoped.Requires:
inventory_readShow fields
Show fields
[String!]!
required
Barcodes associated with this product, for scanning.
The product’s length, width, and height in a single shared unit, for box sizing.
String
The Harmonized System code used for customs.
ID!
required
The id of this product.
The first (default) image for this product, if any.Requires:
inventory_readString
The country of origin, as a country code, for customs.
String
The stock keeping unit identifying this product.
String!
required
The product’s title.
String
The Universal Product Code for this product.
Append-only quantity change history for this bin-level inventory record. Load via
binInventoryLevel(id) { ledgerEntries(...) } or StorageLocation.binInventoryLevels { ledgerEntries(...) }.Requires: inventory_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Only return entries with one of these adjustment kinds.
Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.Which key to sort by (defaults to the first key, newest-first). Combine with
reverse to flip direction.Boolean
Reverses the sort direction selected by
orderBy (or its default).The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.The warehouse this quantity is held at.Requires:
locations_readShow fields
Show fields
String
The city of the location’s address.
String
The company name associated with the location.
String
The country code, e.g. “US”.
ID!
required
The id of this location.
required
Traceable inventory units at this warehouse.Requires:
inventory_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.Per-product inventory levels held at this location.Requires:
inventory_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.String!
required
The location’s display name.
String
The contact phone number for the location.
String
The postal or ZIP code, e.g. “84101”.
String
The state or province code, e.g. “UT”.
required
Bins and other storage locations within this warehouse.Requires:
locations_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.String
The first line of the street address.
String
The second line of the street address.
Int
Maximum quantity allowed in the bin, when capped.
Int!
required
Quantity on hand in the storage location.
required
The bin or slot holding this quantity.Requires:
locations_readShow fields
Show fields
required
Product quantities held in this storage location.Requires:
inventory_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Boolean
true returns only rows holding stock (quantity above zero). false returns only empty or negative rows, such as emptied assignments and LOST balancing entries.
Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.Which key to sort by (creation time, newest first). Combine with
reverse to flip direction.Boolean
Reverses the sort direction selected by
orderBy (or its default).ID!
required
The id of this storage location.
required
Inventory items currently in this storage location.Requires:
inventory_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.Boolean!
required
Whether on-hand quantity in this slot counts as sellable inventory.
The warehouse this storage location belongs to.Requires:
locations_readString!
required
The display name of the bin or slot.
Pick priority relative to other bins, when set.
required
How this record was created.
Int!
required
How many product levels in this storage location have a quantity above zero.
Int!
required
The sum of every level’s quantity in this storage location.
required
The kind of storage location.
Int!
required
Signed quantity change applied by this entry (negative reduces on-hand).
ID!
required
The id of this ledger entry.
required
What caused this inventory change.
The warehouse location where this adjustment occurred.Requires:
locations_readShow fields
Show fields
String
The city of the location’s address.
String
The company name associated with the location.
String
The country code, e.g. “US”.
ID!
required
The id of this location.
required
Traceable inventory units at this warehouse.Requires:
inventory_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.Per-product inventory levels held at this location.Requires:
inventory_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.String!
required
The location’s display name.
String
The contact phone number for the location.
String
The postal or ZIP code, e.g. “84101”.
String
The state or province code, e.g. “UT”.
required
Bins and other storage locations within this warehouse.Requires:
locations_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.String
The first line of the street address.
String
The second line of the street address.
String
Lot number on the linked inventory item today (not a snapshot at adjustment time).
String
Free-text notes stored on the entry.
The product whose inventory changed, when applicable.Requires:
products_readShow fields
Show fields
Look up a single attribute on this product by its name, if set.Requires:
products_readShow fields
Show fields
ArgumentsFields
String!
required
The machine name of the attribute to look up.
String
An optional description of what the attribute represents.
String!
required
The human-readable label shown for the attribute.
ID!
required
The unique identifier of the attribute’s definition.
String!
required
The attribute’s machine name, unique within the account.
required
The data type of the attribute’s value.
required
The merchant-defined attributes set on this product.
Show fields
Show fields
String
An optional description of what the attribute represents.
String!
required
The human-readable label shown for the attribute.
ID!
required
The unique identifier of the attribute’s definition.
String!
required
The attribute’s machine name, unique within the account.
required
The data type of the attribute’s value.
[String!]!
required
Barcodes associated with this product.
String!
required
The product’s long-form description.
The product’s length, width, and height, expressed in a single shared unit.
Show fields
Show fields
Float
The height, in
unit.Float
The length, in
unit.required
The unit all three measurements are expressed in.
Float
The width, in
unit.String
The Harmonized System code used for customs.
ID!
required
The id of this product.
The first (default) image for this product, if any.Requires:
products_readrequired
A paginated list of the product’s images.Requires:
products_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.required
Traceable inventory units for this product.Requires:
inventory_readShow fields
Show fields
ArgumentsFields
String
String
Int
Int
required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.This product’s inventory level at a single location, if any.Requires:
inventory_readShow fields
Show fields
ArgumentsFields
ID!
required
The id of the location to fetch the level at.
Int!
required
The quantity available to sell.
Int!
required
The quantity that can be built from components.
Int!
required
The quantity committed to existing orders.
ID!
required
The id of this inventory level.
A fulfillment-oriented view of the product, readable by anyone who can see this level (e.g. a 3PL). For the full product, use
product.Requires: inventory_readThe location these inventory levels are held at.Requires:
locations_readThe full product these inventory levels are for. Only readable by the account that owns the product; use
inventoryProduct otherwise.Requires: products_readInt!
required
The total quantity on hand at the location.
Int!
required
The quantity reserved across all reservation buckets.
Per-location inventory levels for this product.Requires:
inventory_readShow fields
Show fields
ArgumentsFields
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The list of edges (each a node plus its pagination
cursor).required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.required
String
The country of origin, as a country code.
Boolean!
required
Whether the product is a physical, shippable item.
The product family this product belongs to, if any.Requires:
products_readShow fields
Show fields
Look up a single attribute on this family by its name, if set.Requires:
products_readShow fields
Show fields
Arguments
String!
required
The machine name of the attribute to look up.
required
The merchant-defined attributes set on this family.
String!
required
The product family’s long-form description.
ID!
required
The id of this product family.
The first (default) image for this family, if any.Requires:
products_readrequired
A paginated list of the family’s images.Requires:
products_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.required
The variant options (e.g. Size, Color) for this family.
required
A paginated list of the products (variants) in this family.Requires:
products_readShow fields
Show fields
Arguments
String
Forward pagination cursor — returns items after it. Pass an
edges[].cursor or pageInfo.endCursor from a previous page.String
Backward pagination cursor — returns items before it. Pass an
edges[].cursor or pageInfo.startCursor from a previous page.Int
Forward pagination: returns the first N items (max 100, default 25). Use with
after; mutually exclusive with last/before.Int
Backward pagination: returns the last N items (max 100, default 25). Use with
before; mutually exclusive with first/after.[String!]!
required
Free-form tags applied to the product family.
String!
required
The product family’s title.
String
The vendor or manufacturer of the product family.
String
The stock keeping unit identifying this product.
[String!]!
required
Free-form tags applied to the product.
String
The tax code used to classify the product for taxation.
Boolean!
required
Whether the product is subject to tax.
String!
required
The product’s title.
String
The Universal Product Code for this product.
String
The vendor or manufacturer of the product.
The product’s weight.
Show fields
Show fields
required
The unit the value is expressed in.
Float!
required
The numeric magnitude of the weight.
String
Opaque reference tying this entry to a source record (fulfillment, count session, etc.).
String
Name of the bin or storage location for the linked inventory level today (not a snapshot at adjustment time).
String
Display name of the user who performed the adjustment.
Example
query {
inventoryLevelLedgerEntry(id: "...") {
balance
createdAt
delta
expirationDate
id
kind
lotNumber
notes
# ...
}
}