Errors
CS2.SPACE uses standard HTTP response status codes with JSON error payloads and machine-readable error codes.
Error response format
API errors return a JSON object with an error message and, where applicable, a machine-readable code (such as PLAYER_NOT_FOUND, INVENTORY_PRIVATE, or PLAN_UPGRADE_REQUIRED). Invalid asset parameters under /api/assets/premier/* return plain-text 400 responses.
400 Bad Request
Invalid parameter, e.g. a non-numeric Premier rating.
Invalid rating401 Unauthorized
No API key was sent.
{ "error": "API key required"}403 Forbidden
Invalid 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 Found
The SteamID or profile name doesn't match a player.
{ "error": "Player not found", "code": "PLAYER_NOT_FOUND"}429 Too Many Requests
Rate 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."}500 Internal Server Error
Something went wrong on our side.
{ "error": "Internal Server Error"}502 Bad Gateway
Steam failed to return the inventory. Retry shortly.
{ "error": "Failed to load inventory from Steam. Please retry shortly."}