Skip to content

API Reference / Inventory

Fetch multiple inventory items by ID

Returns the inventory items matching the given IDs within a workspace, alongside the IDs that did not resolve.

POST/contracts.v1.Contracts/GetInventoryItems

Request body

application/jsonRequired

Request for several inventory items in the caller's workspace by identifier, in one call.

inventoryItemIds?array<string>

Opaque 16-byte identifiers of the inventory items to fetch, each base64-encoded in JSON.

Response body

application/json

Success

inventoryItems?array<InventoryItem>

The inventory items that exist in the caller's workspace.

Show attributes
accountName?string

The Steam account holding the item, the account the purchase was delivered to.

acquiredAt?string

When the item reached the Steam inventory. Unset while it is still arriving.

Format"date-time"

buyPriceCents?string

Price paid when this item was purchased, in cents.

Format"int64"

buyPriceMicros?string

Price 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?string

Contract that originally bought the item.

Format"byte" base64

createdAt?string

When the inventory item was created.

Format"date-time"

currentAssetId?string

Current Steam asset_id. Steam rotates this value on every trade. Use ListAssetIDLinks to see the full history.

deletedAt?string

When the inventory item was soft-deleted. Unset for active items.

Format"date-time"

delistedAt?string

When 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?number

The 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?string

Per-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?string

Opaque 16-byte inventory item identifier.

Format"byte" base64

listPriceCents?string

The 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?string

When the newest listing went up. Unset when the item was never listed.

Format"date-time"

listingContractId?string

The 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?string

The 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?string

Why the item was lost. Set only when status is LOST, unspecified otherwise.

Value in"INVENTORY_ITEM_LOSS_REASON_TAKEN_UNPAID""INVENTORY_ITEM_LOSS_REASON_VOIDED_AFTER_DELIVERY""INVENTORY_ITEM_LOSS_REASON_REVERSED_NOT_RETURNED""INVENTORY_ITEM_LOSS_REASON_SETTLEMENT_MISSING""INVENTORY_ITEM_LOSS_REASON_WRITTEN_OFF"

lostAt?string

When 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?string

Canonical Steam market_hash_name of the owned item.

paidOutAt?string

When 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?integer

The 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?string

Purchase that produced this inventory item.

Format"byte" base64

receipt?string

Whether the item the purchase became has been found in the receiving Steam account. Unspecified until a delivery is accepted.

Value in"INVENTORY_ITEM_RECEIPT_AWAITING""INVENTORY_ITEM_RECEIPT_PAIRED""INVENTORY_ITEM_RECEIPT_UNPAIRED""INVENTORY_ITEM_RECEIPT_GONE"

receiptInterchangeable?boolean

True 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?string

Why the item could not be paired or left the account: not_found, ambiguous or left_account. Empty otherwise.

sellPriceCents?string

Price received when this item was sold, in cents. Unset until the sale completes.

Format"int64"

sellingContractId?string

The 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?string

The 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?string

When 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?string

Current inventory item lifecycle state.

Value in"INVENTORY_ITEM_STATUS_PENDING_TRADE""INVENTORY_ITEM_STATUS_IN_INVENTORY""INVENTORY_ITEM_STATUS_LISTED""INVENTORY_ITEM_STATUS_SOLD""INVENTORY_ITEM_STATUS_LOST"

tradable?boolean

Steam'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?string

When 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?string

When the inventory item was last modified.

Format"date-time"

version?string

Optimistic concurrency version. Incremented on every update.

Format"int64"

workspaceId?string

Workspace that owns the item.

Format"byte" base64

notFoundIds?array<string>

Requested identifiers with no inventory item in the caller's workspace.

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/GetInventoryItems" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inventoryItemIds": [
      "aW52ZW50b3J5LWl0ZW0tMDAx",
      "aW52ZW50b3J5LWl0ZW0tMDAy"
    ]
  }'
{
  "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"
    }
  ],
  "notFoundIds": [
    "aW52ZW50b3J5LWl0ZW0tMDAy"
  ]
}