> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# inventoryLevelLedgerEntries
> Page inventory ledger rows for one bin-level inventory record (`inventoryLevelId`) or one source record (exact `referenceId`), newest first. Same rows as `binInventoryLevel { ledgerEntries }` when scoped to one `inventoryLevelId`. To find a bin's levels first, use `storageLocation { binInventoryLevels }` or `binInventoryLevels(storageLocationId:)`.
**Required scopes:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
## Arguments
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.
DateTime}>
Only return entries recorded at or after this instant.
DateTime}>
Only return entries recorded before this instant.
Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.
Only return entries for this bin-level inventory record (`BinInventoryLevel` id).
[InventoryLevelAdjustmentKind!]}>
Only return entries with one of these adjustment kinds.
Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.
InventoryLevelLedgerEntrySortKey}>
Which key to sort by (defaults to the first key, newest-first). Combine with `reverse` to flip direction.
Only return entries with this exact reference id (fulfillment, count session, etc.).
Reverses the sort direction selected by `orderBy` (or its default).
## Returns
InventoryLevelLedgerEntryConnection!} required>
A paginated list of InventoryLevelLedgerEntry items.
[InventoryLevelLedgerEntryEdge!]!} required>
The list of edges (each a node plus its pagination `cursor`).
Opaque cursor for this item; pass to `after`/`before` to page from here.
InventoryLevelLedgerEntry!} required>
The item at this edge.
On-hand quantity at this inventory level immediately after this entry.
BinInventoryLevel}>
The bin-level inventory record this ledger row belongs to.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
DateTime!} required>
When this ledger entry was recorded.
Signed quantity change applied by this entry (negative reduces on-hand).
Date}>
Expiration date on the linked inventory item today (not a snapshot at adjustment time).
The id of this ledger entry.
InventoryLevelAdjustmentKind!} required>
What caused this inventory change.
Location}>
The warehouse location where this adjustment occurred.
**Requires:** [`locations_read`](/docs/api-reference/v3/reference/scopes#scope-locations_read)
Lot number on the linked inventory item today (not a snapshot at adjustment time).
Free-text notes stored on the entry.
Product}>
The product whose inventory changed, when applicable.
**Requires:** [`products_read`](/docs/api-reference/v3/reference/scopes#scope-products_read)
Opaque reference tying this entry to a source record (fulfillment, count session, etc.).
Name of the bin or storage location for the linked inventory level today (not a snapshot at adjustment time).
Display name of the user who performed the adjustment.
[InventoryLevelLedgerEntry!]!} required>
The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.
On-hand quantity at this inventory level immediately after this entry.
BinInventoryLevel}>
The bin-level inventory record this ledger row belongs to.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
DateTime!} required>
When the record was created.
The id of this bin-level inventory record.
InventoryItem}>
The specific inventory item this level tracks, when item-scoped.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
InventoryProduct}>
The product this quantity belongs to, when the level is product-scoped.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
DateTime}>
When this bin-level quantity was last cycle-counted.
InventoryLevelLedgerEntryConnection!} required>
Append-only quantity change history for this bin-level inventory record. Load via `binInventoryLevel(id) { ledgerEntries(...) }` or `StorageLocation.binInventoryLevels { ledgerEntries(...) }`.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
**Arguments**
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.
DateTime}>
Only return entries recorded at or after this instant.
DateTime}>
Only return entries recorded before this instant.
Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.
[InventoryLevelAdjustmentKind!]}>
Only return entries with one of these adjustment kinds.
Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.
InventoryLevelLedgerEntrySortKey}>
Which key to sort by (defaults to the first key, newest-first). Combine with `reverse` to flip direction.
Reverses the sort direction selected by `orderBy` (or its default).
Location}>
The warehouse this quantity is held at.
**Requires:** [`locations_read`](/docs/api-reference/v3/reference/scopes#scope-locations_read)
Maximum quantity allowed in the bin, when capped.
Quantity on hand in the storage location.
StorageLocation!} required>
The bin or slot holding this quantity.
**Requires:** [`locations_read`](/docs/api-reference/v3/reference/scopes#scope-locations_read)
DateTime!} required>
When the record was last updated.
DateTime!} required>
When this ledger entry was recorded.
Signed quantity change applied by this entry (negative reduces on-hand).
Date}>
Expiration date on the linked inventory item today (not a snapshot at adjustment time).
The id of this ledger entry.
InventoryLevelAdjustmentKind!} required>
What caused this inventory change.
Location}>
The warehouse location where this adjustment occurred.
**Requires:** [`locations_read`](/docs/api-reference/v3/reference/scopes#scope-locations_read)
The city of the location's address.
The company name associated with the location.
The country code, e.g. "US".
DateTime!} required>
When the record was created.
The id of this location.
InventoryItemConnection!} required>
Traceable inventory units at this warehouse.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
**Arguments**
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.
Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.
Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.
LocationInventoryLevelConnection!} required>
Per-product inventory levels held at this location.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
**Arguments**
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.
Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.
Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.
The location's display name.
The contact phone number for the location.
The postal or ZIP code, e.g. "84101".
The state or province code, e.g. "UT".
StorageLocationConnection!} required>
Bins and other storage locations within this warehouse.
**Requires:** [`locations_read`](/docs/api-reference/v3/reference/scopes#scope-locations_read)
**Arguments**
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.
Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.
Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.
The first line of the street address.
The second line of the street address.
DateTime!} required>
When the record was last updated.
Lot number on the linked inventory item today (not a snapshot at adjustment time).
Free-text notes stored on the entry.
Product}>
The product whose inventory changed, when applicable.
**Requires:** [`products_read`](/docs/api-reference/v3/reference/scopes#scope-products_read)
Attribute}>
Look up a single attribute on this product by its name, if set.
**Requires:** [`products_read`](/docs/api-reference/v3/reference/scopes#scope-products_read)
**Arguments**
The machine name of the attribute to look up.
[Attribute!]!} required>
The merchant-defined attributes set on this product.
Barcodes associated with this product.
Money}>
The merchant's unit cost for the product.
DateTime!} required>
When the record was created.
The product's long-form description.
Dimensions}>
The product's length, width, and height, expressed in a single shared unit.
The Harmonized System code used for customs.
The id of this product.
ProductImage}>
The first (default) image for this product, if any.
**Requires:** [`products_read`](/docs/api-reference/v3/reference/scopes#scope-products_read)
ProductImageConnection!} required>
A paginated list of the product's images.
**Requires:** [`products_read`](/docs/api-reference/v3/reference/scopes#scope-products_read)
**Arguments**
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.
Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.
Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.
InventoryItemConnection!} required>
Traceable inventory units for this product.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
**Arguments**
LocationInventoryLevel}>
This product's inventory level at a single location, if any.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
**Arguments**
The id of the location to fetch the level at.
LocationInventoryLevelConnection!} required>
Per-location inventory levels for this product.
**Requires:** [`inventory_read`](/docs/api-reference/v3/reference/scopes#scope-inventory_read)
**Arguments**
Forward pagination cursor — returns items after it. Pass an `edges[].cursor` or `pageInfo.endCursor` from a previous page.
Backward pagination cursor — returns items before it. Pass an `edges[].cursor` or `pageInfo.startCursor` from a previous page.
Forward pagination: returns the first N items (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.
Backward pagination: returns the last N items (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.
[ProductOptionValue!]!} required>
The variant's selected option values (e.g. Size: M, Color: Red), ordered by the family's option positions.
The country of origin, as a country code.
Whether the product is a physical, shippable item.
Money}>
The product's selling price.
ProductFamily}>
The product family this product belongs to, if any.
**Requires:** [`products_read`](/docs/api-reference/v3/reference/scopes#scope-products_read)
The stock keeping unit identifying this product.
Free-form tags applied to the product.
The tax code used to classify the product for taxation.
Whether the product is subject to tax.
The product's title.
The Universal Product Code for this product.
DateTime!} required>
When the record was last updated.
The vendor or manufacturer of the product.
Weight}>
The product's weight.
Opaque reference tying this entry to a source record (fulfillment, count session, etc.).
Name of the bin or storage location for the linked inventory level today (not a snapshot at adjustment time).
Display name of the user who performed the adjustment.
PageInfo!} required>
Pagination metadata for the current page.
Cursor of the last edge in this page; pass to `after` to page forward.
Whether more items exist after this page (drives forward pagination with `first`/`after`).
Whether more items exist before this page (drives backward pagination with `last`/`before`).
Cursor of the first edge in this page; pass to `before` to page backward.
## Example
```graphql theme={null}
query {
inventoryLevelLedgerEntries(after: "...", before: "...", createdAtAfter: "...", createdAtBefore: "...", first: 10, inventoryLevelId: "...", kind: BIN_COUNT, last: 10, orderBy: CREATED_AT, referenceId: "...", reverse: true) {
nodes {
balance
createdAt
delta
expirationDate
id
kind
lotNumber
notes
# ...
}
pageInfo { hasNextPage endCursor }
}
}
```
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.