Docsesportsodds.gg
V1GamePlayersId

A single player

GET
/v1/{game}/players/{id}

Authorization

AuthorizationBearer <token>

Primary auth (live). Authorization: Bearer <api-key> — the header takes precedence over the query fallback. The raw key is hashed (SHA-256, hex) and looked up in api.keys.key_hash; the raw value is never stored.

In: header

Path Parameters

game*string

Game slug. cs2 is the only populated title today; an un-onboarded game 404s cleanly.

id*string

Resource identifier. UUID today; slug-or-UUID (TARGET) — a human slug (e.g. navi, s1mple) resolves to the same row, scoped to {game}.

Query Parameters

rank?string

Set rank=1 (or include=rank) to compute own_rank, our leaderboard position for this player. It runs a trailing-3-month window query over match stats, so it is opt-in — omit it and own_rank returns null (the window is skipped).

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/players/018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "game_id": "129babd7-0a5a-4108-81e4-77c8f2b49aed",    "slug": "s1mple",    "nickname": "s1mple",    "real_name": "Oleksandr Kostyljev",    "nationality": "UA",    "role": "AWP",    "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba",    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z",    "own_rank": 8  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}