locations_read
Arguments
ID!
required
The id of the location to fetch.
Returns
A physical or logical location where inventory is held or shipped from.
Show 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.
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).Show fields
Show fields
String!
required
Opaque cursor for this item; pass to
after/before to page from here.required
The item at this edge.
required
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.Show fields
Show fields
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.
Pagination metadata for the current page.
Show fields
Show fields
String
Cursor of the last edge in this page; pass to
after to page forward.Boolean!
required
Whether more items exist after this page (drives forward pagination with
first/after).Boolean!
required
Whether more items exist before this page (drives backward pagination with
last/before).String
Cursor of the first edge in this page; pass to
before to page backward.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”.
String
The first line of the street address.
String
The second line of the street address.
Example
query {
location(id: "...") {
city
company
countryCode
createdAt
id
inventoryLevels {
nodes {
available
buildable
committed
createdAt
id
quantity
reserved
updatedAt
}
pageInfo {
hasNextPage
endCursor
}
}
name
phone
# ...
}
}