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

Errors

CS2.SPACE uses standard HTTP response status codes with JSON error payloads and machine-readable error codes.

TROUBLESHOOTING

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.

HTTP STATUS

400 Bad Request

Invalid parameter, e.g. a non-numeric Premier rating.

RESPONSE · 400
Invalid rating

No API key was sent.

RESPONSE · 401
{  "error": "API key required"}
HTTP STATUS

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).

RESPONSE · 403
{  "error": "Inventory data requires a PRO or DEVELOPER plan.",  "code": "PLAN_UPGRADE_REQUIRED",  "upgradeUrl": "https://cs2.space/#pricing"}
HTTP STATUS

404 Not Found

The SteamID or profile name doesn't match a player.

RESPONSE · 404
{  "error": "Player not found",  "code": "PLAYER_NOT_FOUND"}

Rate limit or monthly quota exceeded, or Steam is rate limiting inventory requests (code STEAM_RATE_LIMIT). Retry later.

RESPONSE · 429
{  "error": "Monthly API quota exceeded",  "tier": "FREE",  "limit": 500,  "usage": 500,  "message": "Please upgrade your plan or wait for next month's reset."}

Something went wrong on our side.

RESPONSE · 500
{  "error": "Internal Server Error"}
HTTP STATUS

502 Bad Gateway

Steam failed to return the inventory. Retry shortly.

RESPONSE · 502
{  "error": "Failed to load inventory from Steam. Please retry shortly."}
Was this page helpful?

Ready to build?

GET YOUR FREE KEY NOW →