API Reference / Inventory
List inventory items in a workspace
Returns a paged list of inventory items owned by the workspace, filtered by lifecycle status and the shared InventoryItemFilter (contract, purchases, item name search, exact item names, account, arrival time, purchase strategy, status values including trade hold, and sellability), in the requested order. Each page carries hydrated entities, so no follow-up GetInventoryItems is needed.
/ contracts. v1. Contracts/ ListInventoryItemsRequest body
application/jsonRequired
Request for one page of the inventory items the caller's workspace owns, filtered by status and filter, in the requested order.
cursor?stringOpaque pagination cursor from a previous ListInventoryItemsResponse. Empty for the first page.
descending?booleanOrder descending instead of ascending.
filter?InventoryItemFilterOptional filters applied before pagination. Keep unchanged when continuing with a cursor.
Show attributes
accountGroupIds?array<string>Items held by an account that is a member of one of these account groups of the workspace, OR within the field, compared as ListInventoryItemGroups groups them. A deleted group selects nothing. Empty includes every item. At most 200 ids.
accountNames?array<string>Exact Steam account names holding the item, OR within the field. Empty includes every account. At most 200 names, each nonempty.
acquiredBefore?stringOnly items that reached the Steam inventory before this time. Absent sets no upper bound.
Format"date-time"
acquiredFrom?stringOnly items that reached the Steam inventory at or after this time. An item still arriving has no acquired_at and never matches a bound. Absent sets no lower bound.
Format"date-time"
contractId?stringOnly items attributed to this buying contract, the one that bought them.
Format"byte" base64
coveringSellingContractIds?array<string>Held items (arriving, in the inventory or listed) whose covering selling contract, resolved now exactly as GetCoveringSellingContract resolves it (Sell from account groups honoured), is one of these, OR within the field. Items that left never match. Empty includes every item. At most 200 ids.
currentAssetIds?array<string>Exact current Steam asset ids, OR within the field, matching current_asset_id, so a page of Steam inventory tiles resolves what each item cost in one call. A tile with no match was not bought through the platform. Empty includes every item. At most 200 ids, each nonempty.
hasCoveringSellingContract?booleanTrue selects only held items (arriving, in the inventory or listed) a selling contract covers now, as GetCoveringSellingContract resolves it. False selects only held items none covers, the items nothing will list. Items that left never match either value. Omitted includes every item.
listingContractIds?array<string>Listing contracts, OR within the field: the selling contract pricing the item's newest listing (listing_contract_id). An item never listed, or listed with no contract, never matches. Combine with the LISTED status for what a contract has listed now. Empty includes every item. At most 200 ids.
listingMarketplaces?array<string>Listing marketplaces, OR within the field: the marketplace of the item's newest listing (listing_marketplace), salespanel for the listing. An item never listed never matches. Combine with the LISTED status for what is listed there now. Empty includes every item. At most 50 values, each nonempty.
marketHashNames?array<string>Exact market_hash_name set, OR within the field, for an item's own holdings. Empty includes every item.
paintSeeds?array<integer>Exact paint seeds (pattern indexes, 0 to 1000), OR within the field. An item with no known seed never matches. Empty includes every item. At most 200 seeds.
purchaseIds?array<string>Only the items produced by these purchases, OR within the field. A purchase resolves to at most one inventory item, so a purchases page resolves its page of items in one call, and a purchase detail page resolves the real inventory_item_id before calling ListAssetIDLinks. Empty includes every purchase.
purchaseStrategies?array<string>Buying mechanisms of the purchase that produced the item, OR within the field. Empty includes every strategy.
Value in"PURCHASE_"PURCHASE_"PURCHASE_"PURCHASE_
query?stringCase-insensitive literal substring of the item's market_hash_name or of the Steam account name holding it, or the item's full id in its canonical text form. Not a regular expression or wildcard pattern. Absent or empty matches every item.
sellable?booleanTrue selects only items outside Valve's post-trade hold: tradable rows whose tradable_after is absent or no longer in the future. False selects only held or untradable items. Omitted includes both. Every selling market service sets true, so the hold logic lives in contracts once and no market offers an undeliverable held item.
sellingContractIds?array<string>Selling contracts, OR within the field: the contract that sold the item (selling_contract_id). An item not sold, or sold with no contract, never matches. Empty includes every item. At most 200 ids.
sellingMarketplaces?array<string>Selling marketplaces, OR within the field: the marketplace that sold the item (selling_marketplace). An item not sold, or sold with no market named, never matches. Empty includes every item. At most 50 values, each nonempty.
soldBefore?stringOnly items sold before this time, exclusive, with the same sale time as sold_from. Absent sets no upper bound.
Format"date-time"
soldFrom?stringOnly items sold at or after this time. Sale time is sold_at, or updated_at for a legacy sold row with none, the same time the SOLD_AT order uses. Only sold items ever match a bound. Absent sets no lower bound.
Format"date-time"
statusValues?array<string>Status set, OR within the field, including TRADE_HOLD for a held item and NOT_DELIVERED or ARRIVING for a pending trade past or within its delivery deadline. Empty includes every status. Unlike the list's statuses, this is part of the shared filter, so counts, groups and facets take it too.
Value in"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_
tradableAfterBefore?stringOnly items whose post-trade hold lifts before this time, exclusive. An item with no recorded hold is excluded. With a lower bound of now this lists the items coming off hold soonest.
Format"date-time"
limit?integerMaximum number of IDs to return. Server caps this at a service-defined upper bound.
Format"int32"
sortField?stringField to order the page by. Unspecified orders by creation time. SOLD_AT uses sold_at with updated_at fallback when sold_at is absent. Keep the same sort and filters when continuing with a cursor.
Value in"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_
statuses?array<string>Optional lifecycle status set, the grouping dimension CountInventoryItems breaks down by. Empty includes every status.
Value in"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_
Response body
application/json
Success
inventoryItems?array<InventoryItem>Full inventory items for this page. A page carries the hydrated entities, not bare ids, so the caller needs no follow-up GetInventoryItems.
Show attributes
accountName?stringThe Steam account holding the item, the account the purchase was delivered to.
acquiredAt?stringWhen the item reached the Steam inventory. Unset while it is still arriving.
Format"date-time"
buyPriceCents?stringPrice paid when this item was purchased, in cents.
Format"int64"
buyPriceMicros?stringPrice paid when this item was purchased, in millionths of a dollar: the exact amount the market charged (Market.CSGO charges $0.005 as 5000). buy_price_cents is the same price rounded up to a cent, kept for limits. Show and sum this field.
Format"int64"
contractId?stringContract that originally bought the item.
Format"byte" base64
createdAt?stringWhen the inventory item was created.
Format"date-time"
currentAssetId?stringCurrent Steam asset_id. Steam rotates this value on every trade. Use ListAssetIDLinks to see the full history.
deletedAt?stringWhen the inventory item was soft-deleted. Unset for active items.
Format"date-time"
delistedAt?stringWhen the newest listing was taken down without a sale. Unset while it is up, after a sale, and when the item was never listed.
Format"date-time"
floatValue?numberThe bought item's real Steam float value, recorded at purchase for sell-side float-window matching and audit. Unset when no real float was recorded, distinct from a 0.0 wear.
Format"double"
iconUrl?stringPer-instance Valve economy icon hash for this exact item, rendered at community.cloudflare.steamstatic.com/economy/image/{icon_url}. Empty falls back to the catalog per-finish base icon.
id?stringOpaque 16-byte inventory item identifier.
Format"byte" base64
listPriceCents?stringThe price the newest listing asks, in cents: the market's list price, or for a listing listing the lowest price of its range. Unset when the item was never listed.
Format"int64"
listedAt?stringWhen the newest listing went up. Unset when the item was never listed.
Format"date-time"
listingContractId?stringThe selling contract pricing the newest listing. Unset when the item was never listed or the listing named no contract. The contract credited with a sale is selling_contract_id.
Format"byte" base64
listingMarketplace?stringThe marketplace of the newest listing: the market the item is listed on, or salespanel for an item the listing lists on several markets at once (the market that sold it is selling_marketplace). Unset when the item was never listed.
lossReason?stringWhy the item was lost. Set only when status is LOST, unspecified otherwise.
Value in"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_
lostAt?stringWhen the item was lost: it left the account and no money came for it. Set only when status is LOST. Its cost counts as a loss in realised profit.
Format"date-time"
marketHashName?stringCanonical Steam market_hash_name of the owned item.
paidOutAt?stringWhen the market pays the sale's money out: the date it is due while the market still holds it, the date it was paid after. Unset before a sale and when the market gave no date. Profit before this time is pending.
Format"date-time"
paintSeed?integerThe item's pattern index (paint seed, 0 to 1000), from the listing at purchase or decoded from the delivered item's inspect link. Unset when unknown, distinct from seed 0.
Format"int32"
purchaseId?stringPurchase that produced this inventory item.
Format"byte" base64
receipt?stringWhether the item the purchase became has been found in the receiving Steam account. Unspecified until a delivery is accepted.
Value in"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_
receiptInterchangeable?booleanTrue when the item was paired as one unit of identical, interchangeable items (a case, a sticker) rather than as the one physical item bought.
receiptReason?stringWhy the item could not be paired or left the account: not_found, ambiguous or left_account. Empty otherwise.
sellPriceCents?stringPrice received when this item was sold, in cents. Unset until the sale completes.
Format"int64"
sellingContractId?stringThe selling contract that sold the item, stamped when the sale closes. Unset until then, and when the sale carried no contract.
Format"byte" base64
sellingMarketplace?stringThe marketplace that sold the item, stamped when the sale closes: the market the sale settled on, also for a sale made through the listing. Unset until then, and when the sale named no market.
soldAt?stringWhen the sale completed. Unset before sale or for legacy sold rows without a recorded sale timestamp. Use updated_at as the display fallback for those legacy rows, matching SOLD_AT_DESC order.
Format"date-time"
status?stringCurrent inventory item lifecycle state.
Value in"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_"INVENTORY_
tradable?booleanSteam's authoritative per-item tradable flag. False while the item is under a post-trade hold. The sell-candidate read (ListInventoryItems with sellable_only) excludes any item that is not tradable, so it is the safety floor that keeps a held item off every market.
tradableAfter?stringWhen a held item's post-trade hold lifts, parsed from Steam. Unset when there is no hold or when Steam withheld a parseable date for a held item. The precise reactivation and Tradable-after badge signal.
Format"date-time"
updatedAt?stringWhen the inventory item was last modified.
Format"date-time"
version?stringOptimistic concurrency version. Incremented on every update.
Format"int64"
workspaceId?stringWorkspace that owns the item.
Format"byte" base64
nextCursor?stringCursor to pass to fetch the next page. Empty when there are no more results.
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"limit": 100,
"cursor": "",
"statuses": [
"INVENTORY_ITEM_STATUS_IN_INVENTORY"
]
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"limit": 100,
"cursor": "",
"statuses": [
"INVENTORY_ITEM_STATUS_IN_INVENTORY"
]
}),
});
const data = await res.json();body := strings.NewReader(`{
"limit": 100,
"cursor": "",
"statuses": [
"INVENTORY_ITEM_STATUS_IN_INVENTORY"
]
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"limit": 100,
"cursor": "",
"statuses": [
"INVENTORY_ITEM_STATUS_IN_INVENTORY"
]
},
)
data = res.json(){
"inventoryItems": [
{
"id": "aW52ZW50b3J5LWl0ZW0tMDAx",
"workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
"purchaseId": "MDEyMzQ1Njc4OWFiY2RlZg==",
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"status": "INVENTORY_ITEM_STATUS_IN_INVENTORY",
"version": "2",
"currentAssetId": "29384710999",
"buyPriceCents": "4200",
"tradable": true,
"createdAt": "2026-04-10T09:12:00Z",
"updatedAt": "2026-04-10T09:45:00Z"
}
],
"nextCursor": ""
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"limit": 1,
"cursor": "",
"filter": {
"purchaseIds": [
"MDEyMzQ1Njc4OWFiY2RlZg=="
]
}
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"limit": 1,
"cursor": "",
"filter": {
"purchaseIds": [
"MDEyMzQ1Njc4OWFiY2RlZg=="
]
}
}),
});
const data = await res.json();body := strings.NewReader(`{
"limit": 1,
"cursor": "",
"filter": {
"purchaseIds": [
"MDEyMzQ1Njc4OWFiY2RlZg=="
]
}
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"limit": 1,
"cursor": "",
"filter": {
"purchaseIds": [
"MDEyMzQ1Njc4OWFiY2RlZg=="
]
}
},
)
data = res.json(){
"inventoryItems": [
{
"id": "aW52ZW50b3J5LWl0ZW0tMDAx",
"workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
"purchaseId": "MDEyMzQ1Njc4OWFiY2RlZg==",
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"status": "INVENTORY_ITEM_STATUS_IN_INVENTORY",
"version": "2",
"currentAssetId": "29384710999",
"buyPriceCents": "4200",
"tradable": true,
"createdAt": "2026-04-10T09:12:00Z",
"updatedAt": "2026-04-10T09:45:00Z"
}
],
"nextCursor": ""
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"limit": 50,
"cursor": "eyJvZmZzZXQiOjUwfQ==",
"filter": {
"sellable": true
}
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"limit": 50,
"cursor": "eyJvZmZzZXQiOjUwfQ==",
"filter": {
"sellable": true
}
}),
});
const data = await res.json();body := strings.NewReader(`{
"limit": 50,
"cursor": "eyJvZmZzZXQiOjUwfQ==",
"filter": {
"sellable": true
}
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"limit": 50,
"cursor": "eyJvZmZzZXQiOjUwfQ==",
"filter": {
"sellable": true
}
},
)
data = res.json(){
"inventoryItems": [
{
"id": "aW52ZW50b3J5LWl0ZW0tMDAx",
"workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
"purchaseId": "MDEyMzQ1Njc4OWFiY2RlZg==",
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"marketHashName": "AK-47 | Redline (Field-Tested)",
"status": "INVENTORY_ITEM_STATUS_IN_INVENTORY",
"version": "2",
"currentAssetId": "29384710999",
"buyPriceCents": "4200",
"tradable": true,
"createdAt": "2026-04-10T09:12:00Z",
"updatedAt": "2026-04-10T09:45:00Z"
}
],
"nextCursor": "eyJvZmZzZXQiOjEwMH0="
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"limit": 100,
"cursor": "",
"filter": {
"contractId": "MDEyMzQ1Njc4OWFiY2RlZg=="
},
"statuses": [
"INVENTORY_ITEM_STATUS_SOLD"
]
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"limit": 100,
"cursor": "",
"filter": {
"contractId": "MDEyMzQ1Njc4OWFiY2RlZg=="
},
"statuses": [
"INVENTORY_ITEM_STATUS_SOLD"
]
}),
});
const data = await res.json();body := strings.NewReader(`{
"limit": 100,
"cursor": "",
"filter": {
"contractId": "MDEyMzQ1Njc4OWFiY2RlZg=="
},
"statuses": [
"INVENTORY_ITEM_STATUS_SOLD"
]
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/contracts.v1.Contracts/ListInventoryItems",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"limit": 100,
"cursor": "",
"filter": {
"contractId": "MDEyMzQ1Njc4OWFiY2RlZg=="
},
"statuses": [
"INVENTORY_ITEM_STATUS_SOLD"
]
},
)
data = res.json(){
"inventoryItems": [],
"nextCursor": ""
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}