Inventory

Requires authentication, and answers 401 for anyone but the inventory owner or an administrator. Rows are one per inventory item (never grouped by skin) because the purchase price is recorded per item. Every money field is in the resolved display currency.

curl "https://api.scmm.app/api/inventory/<profileId>/investment?search=<search>" \
  -H "x-api-key: YOUR_KEY_HERE"

Requires authentication, and answers 401 for anyone but the inventory owner or an administrator. Every figure is null until more than half the inventory carries purchase data — below that the numbers describe the missing data, not the portfolio.

curl "https://api.scmm.app/api/inventory/<profileId>/investment/totals?currency=USD" \
  -H "x-api-key: YOUR_KEY_HERE"

Resolves the identifier to a 64-bit Steam id (resolving vanity names via Steam when needed), creates a lightweight profile on first sight, and enqueues an inventory import. The import runs asynchronously — poll GET /api/inventory/import-status/{steamId} with the returned steamId until importing is false. Anonymous callers share an hourly import budget (per address and site-wide); when it is spent the response is 429 with a Retry-After header for the top of the hour. A caller signed in with a session is not subject to that budget. An x-api-key header is not a session on this route, so a key holder is budgeted as an anonymous caller.

curl -X POST "https://api.scmm.app/api/inventory/calculate" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"<identifier>"}'

Requires authentication and your own Steam Web API key. For every item held in more than one stack, moves each other stack into the stack with the lowest asset id on Steam, one stack at a time. Stacks that cannot be traded or sold are left out unless stackUntradableAndUnmarketable is true. One request makes at most 25 changes, starts none after 45 seconds, and returns how many it made and how many remain; repeat it until remaining is 0. Each change Steam confirms is saved even if a later one fails. To see how many stacks it would combine before making any change, and without a key, use GET /api/inventory/combine-all/plan. Answers 400 when Steam refuses the change (its reason is in message), 401 when Steam rejects the key, 409 when another stack change is running for your inventory, 429 when Steam is rate-limiting the key, and 502 when Steam did not confirm a change; after a 502, queue a fresh import with POST /api/inventory/import/{steamId}?force=true and poll GET /api/inventory/import-status/{steamId} until importing is false before retrying, because the change may have happened. This request is not safe to retry automatically: a repeated request repeats the change, so turn off automatic retries for it in your HTTP client. Instead, after a timeout or a 502, import the inventory and read the stacks again before sending anything. Allow at least 60 seconds per request.

curl -X PUT "https://api.scmm.app/api/inventory/combine-all" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY_HERE" \
  -H "steam-api-key: YOUR_STEAM_API_KEY" \
  -d '{"stackUntradableAndUnmarketable":true}'

Requires authentication; no Steam Web API key, and nothing is sent to Steam. Returns how many items in your inventory are held in more than one stack and how many stacks PUT /api/inventory/combine-all would move into another stack, with the same rules and the same stackUntradableAndUnmarketable default. stacks is the number of changes that operation would make, so it is the combined plus remaining of its first response if nothing changes in between. requests is the fewest requests that operation takes at 25 changes each; it takes more when a request stops at its 45-second budget. All three are 0 when there is nothing to combine.

curl "https://api.scmm.app/api/inventory/combine-all/plan?stackUntradableAndUnmarketable=true" \
  -H "x-api-key: YOUR_KEY_HERE"

The poll target for an import queued by POST /api/inventory/calculate. It reports whether the import has produced a value, is still running, or finished without one — the third case is a real answer rather than a failure, and it is what a private or empty Steam inventory returns. Takes a 64-bit Steam id.

curl "https://api.scmm.app/api/inventory/import-status/<steamId>"

Queues a refresh of the profile’s Steam inventory and returns at once. Poll GET /api/inventory/import-status/{steamId} until importing is false; a newer lastUpdatedInventoryOn means the import completed. Requires authentication. Throttled to once per hour per profile; force=true skips that hourly window but is honored only for the owner of the Steam id (or an admin) — other callers stay throttled. Even forced, one profile is queued at most once a minute, and a request made while an import for that profile is already queued or running answers queued: false with reason: "already-running" rather than adding a second one.

curl -X POST "https://api.scmm.app/api/inventory/import/<steamId>?force=false" \
  -H "x-api-key: YOUR_KEY_HERE"

Requires authentication, and answers 401 unless the item belongs to you (or you are an administrator). Absent fields are left unchanged; an explicit null clears one. Choosing a free acquisition source (gambling, gift, game drop) always clears the price.

curl -X PUT "https://api.scmm.app/api/inventory/item/<itemId>" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY_HERE" \
  -d '{"buyPrice":0}'

Requires authentication and your own Steam Web API key. Moves the given quantity of each source stack into the destination stack on Steam, one source at a time in body order, and returns the item’s stacks afterwards. A source that is not in your inventory is skipped. One request makes at most 25 changes and starts none after 45 seconds; unreached lists the source asset ids it did not reach, so send exactly those again, with the same quantities, until it is empty. Each change Steam confirms is saved even if a later source fails. Answers 400 when Steam refuses the change (its reason is in message), 401 when Steam rejects the key, 409 when another stack change is running for your inventory, 429 when Steam is rate-limiting the key, and 502 when Steam did not confirm a change; after a 502, queue a fresh import with POST /api/inventory/import/{steamId}?force=true and poll GET /api/inventory/import-status/{steamId} until importing is false before retrying, because the change may have happened. This request is not safe to retry automatically: a repeated request repeats the change, so turn off automatic retries for it in your HTTP client. Instead, after a timeout or a 502, import the inventory and read the stacks again before sending anything. Allow at least 60 seconds per request.

curl -X PUT "https://api.scmm.app/api/inventory/item/<itemId>/combine" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY_HERE" \
  -H "steam-api-key: YOUR_STEAM_API_KEY" \
  -d '{"<key>":1}'

Requires authentication and your own Steam Web API key. Moves quantity units out of the stack on Steam, into one new stack when stackNewItems is true (the default) or into single items when it is false, and returns the item’s stacks afterwards. quantity must be less than the stack holds. A split into single items makes at most 25 changes per request and starts none after 45 seconds; remaining says how many units are left, so repeat the request with that quantity until it is 0. Answers 400 when Steam refuses the change (its reason is in message), 401 when Steam rejects the key, 409 when another stack change is running for your inventory, 429 when Steam is rate-limiting the key, and 502 when Steam did not confirm a change; after a 502, queue a fresh import with POST /api/inventory/import/{steamId}?force=true and poll GET /api/inventory/import-status/{steamId} until importing is false before retrying, because the change may have happened. This request is not safe to retry automatically: a repeated request repeats the change, so turn off automatic retries for it in your HTTP client. Instead, after a timeout or a 502, import the inventory and read the stacks again before sending anything. Allow at least 60 seconds per request.

curl -X PUT "https://api.scmm.app/api/inventory/item/<itemId>/split" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY_HERE" \
  -H "steam-api-key: YOUR_STEAM_API_KEY" \
  -d '{"quantity":1}'

Requires authentication. Returns every stack of the same item in your own inventory, largest first, with its asset id, quantity and trade lock. Answers 404 for an asset id that is not in your inventory.

curl "https://api.scmm.app/api/inventory/item/<itemId>/stacks" \
  -H "x-api-key: YOUR_KEY_HERE"

Serves the top 500 inventories for the requested sort, not every inventory tracked. total is therefore capped at 500 and totalPages with it; pages beyond the cap return no entries. For the true, uncapped count of valued inventories use inventoriesTracked on GET /api/inventory/leaderboard/stats.

curl "https://api.scmm.app/api/inventory/leaderboard?page=1"

Uncapped on purpose — this is the counterpart to the leaderboard's 500-row cap, and the only place the true number of valued inventories is published.

curl "https://api.scmm.app/api/inventory/leaderboard/stats"

Lightweight companion to the inventory list — hydrates the "Owned" badge across the app. Distinct ids only, no quantities and no ordering. Scoped to the resolved app, so a Rust session never reports a CS2 item.

curl "https://api.scmm.app/api/inventory/owned/item-ids" \
  -H "x-api-key: YOUR_KEY_HERE"