CS2.SPACEDocumentationAPI
HomeDASHBOARD →
Base URL: https://cs2.space

CS2 inventory summary

GETx-api-key requiredPRO & DEVELOPER

Totals only: item count, tradable/StatTrak/Souvenir counts, total USD value, and counts per category and rarity.

OpenAPI 3.1 llms.txt
HTTP ENDPOINT

Endpoint URI

GET/api/inventory/{id}/summary

Full example URL: https://cs2.space/api/inventory/76561198074762801/summary

PARAMETERS

Path parameters

idSTRINGREQUIRED

SteamID64 (17 digits, e.g. 76561197963540638) or custom profile URL name (e.g. ChetCS).

PARAMETERS

Query parameters

freshBOOLEAN

PRO and DEVELOPER keys only: skip the 30 minute cache and fetch from Steam.Default: false

USAGE

Example request

curl -H "x-api-key: YOUR_KEY" "https://cs2.space/api/inventory/76561198074762801/summary"
PAYLOAD

Example response

RESPONSE · 200 OK · long arrays shortened to one entry
{  "steamId": "76561198074762801",  "summary": {    "totalCount": 474,    "tradableCount": 433,    "statTrakCount": 33,    "souvenirCount": 12,    "totalValue": 42995.38,    "totalValueFormatted": "$42,995.38",    "categoryCounts": {      "smgs": 16,      "gloves": 5,      "cases": 5,      "knives": 14,      "rifles": 18,      "pins_coins": 82,      "pistols": 96,      "other": 11,      "stickers": 187,      "sniper_rifles": 15,      "shotguns": 7,      "music_kits": 13,      "agents": 5    },    "rarityCounts": {      "Mil-Spec Grade": 88,      "Extraordinary": 54,      "Base Grade": 10,      "Covert": 24,      "Restricted": 24,      "Classified": 18,      "Industrial Grade": 10,      "High Grade": 185,      "Remarkable": 39,      "Exotic": 10,      "Consumer Grade": 3,      "Master": 3,      "Stock": 4,      "Exceptional": 2    }  },  "cached": true}
TROUBLESHOOTING

Status codes

401 UnauthorizedNo API key was sent.
{
  "error": "API key required"
}
403 ForbiddenInvalid API key, the player's inventory is private (code INVENTORY_PRIVATE), or the endpoint needs a PRO or DEVELOPER plan (code PLAN_UPGRADE_REQUIRED).
{
  "error": "Inventory data requires a PRO or DEVELOPER plan.",
  "code": "PLAN_UPGRADE_REQUIRED",
  "upgradeUrl": "https://cs2.space/#pricing"
}
404 Not FoundThe SteamID or profile name doesn't match a player.
{
  "error": "Player not found",
  "code": "PLAYER_NOT_FOUND"
}
429 Too Many RequestsRate limit or monthly quota exceeded, or Steam is rate limiting inventory requests (code STEAM_RATE_LIMIT). Retry later.
{
  "error": "Monthly API quota exceeded",
  "tier": "FREE",
  "limit": 500,
  "usage": 500,
  "message": "Please upgrade your plan or wait for next month's reset."
}
502 Bad GatewaySteam failed to return the inventory. Retry shortly.
{
  "error": "Failed to load inventory from Steam. Please retry shortly."
}

See all error responses on the Errors reference page.

Was this page helpful?
← PREVIOUS PAGE
CS2 inventory
NEXT PAGE →
CS2 inventory (raw Steam data)

Ready to build?

GET YOUR FREE KEY NOW →