ListInventoryItems

List inventory items in a workspace

Returns a paged list of inventory items owned by the workspace. Supports filtering by contract_id, purchase_id, and lifecycle status. Each page carries hydrated entities, so no follow-up GetInventoryItems is needed.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

contractId?string

Optional filter: return only items attributed to this contract.

Formatbyte

cursor?string

Opaque pagination cursor from a previous ListInventoryItemsResponse. Empty for the first page.

limit?integer

Maximum number of IDs to return. Server caps this at a service-defined upper bound.

Formatint32

purchaseId?string

Optional filter: return only the item produced by this purchase. A purchase resolves to at most one inventory item, so this is how a caller holding only a purchase_id (for example, a purchase detail page) resolves the real inventory_item_id before calling ListAssetIDLinks.

Formatbyte

sellableOnly?boolean

When true, exclude any item still inside Valve's post-trade hold: any row that is not tradable or whose tradable_after is still in the future. Set by every selling market service so the hold logic lives in contracts once and no venue offers an undeliverable held item.

status?string

Optional filter: return only items in this lifecycle state.

Value in

"INVENTORY_ITEM_STATUS_UNSPECIFIED" | "INVENTORY_ITEM_STATUS_PENDING_TRADE" | "INVENTORY_ITEM_STATUS_IN_INVENTORY" | "INVENTORY_ITEM_STATUS_LISTED" | "INVENTORY_ITEM_STATUS_SOLD"

Response Body

`application/json`

curl -X POST "https://loading/contracts.v1.Contracts/ListInventoryItems" \  -H "Content-Type: application/json" \  -d '{    "limit": 100,    "cursor": "",    "status": "INVENTORY_ITEM_STATUS_IN_INVENTORY"  }'

{
  "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."
}