List group lots
Balances
List group lots
List lots for a group wallet by asset. Only applicable to LOT inventory mode assets. When program_id is provided, lots are scoped to original issuer lineage for that program.
GET
List group lots
Returns individual lots for one
LOT mode asset held by a group. The asset_id query parameter is required. For SIMPLE mode assets, use the group balances endpoint.
Pass program_id to return only lots whose original economic issuance came from that program. This filter follows the lot’s issuer lineage, including after lot splits or transfers. It does not filter by the program associated with later ledger activity.
Each lot includes its original amount, current remaining amount, status, lifecycle timestamps, and reference_id. You can filter by status, expires_before, expires_after, or reference_id.
A successful response contains a data array and pagination metadata. Treat a missing or malformed response envelope as an error, not as confirmed empty inventory.
For lot lifecycle and expiration behavior, see the Lots and expiration guide.
Authorizations
API key passed in the X-API-Key header.
Path Parameters
Group ID
Query Parameters
Scope lots to original economic issuance by this program
Asset ID
Filter by status: AVAILABLE, HELD, DEFERRED, CONSUMED, EXPIRED
Filter lots expiring on or before this time (RFC 3339)
Filter lots expiring on or after this time (RFC 3339)
Filter lots by reference_id correlation key
Maximum number of results (default 50, max 200)
Required range:
x >= 1Pagination cursor from previous response