A single player
One player by id. Adds `own_rank` — the player's position on our own leaderboard — but only when you ask for it with `?rank=1` or `?include=rank`. Players carry no `external_rank`.
One player by id. Adds own_rank — the player's position on our own leaderboard — but only when you ask for it with ?rank=1 or ?include=rank. Players carry no external_rank.
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 slug. cs2 is the only populated title today; an un-onboarded game 404s cleanly.
Resource identifier — either a UUID or the resource's human-readable slug, scoped to {game}. /v1/cs2/teams/natus-vincere and /v1/cs2/teams/019f23d1-fb5c-7987-b522-47c3a5e72111 address the same row, so you can go straight from a slug you already have without first looking up its id.
Slugs work on teams, players and tournaments. Matches have no slug, so a match id must be a UUID. Either way, an identifier that resolves to nothing returns 404 not_found.
Query Parameters
Set to rank to populate own_rank, this entity's current position on the 3-month leaderboard. ?rank=1 is an equivalent shorthand.
Off by default because it costs a window query over the whole board (roughly 30–120ms) that most callers don't want to pay per request. Without it own_rank is null — which means "not requested", not "unranked". An entity below the ranking sample floor is also null.
Value in
- "rank"
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/019f2858-e253-7f3d-bdff-bc7738bd1036"{ "data": { "id": "019f28e1-e6ae-7032-8255-4c7e26548918", "game_id": "019f23d1-fb5b-7d24-935d-e4d68f6f565a", "slug": "decenty", "nickname": "decenty", "real_name": "Lucas Bacelar", "nationality": "BR", "role": "Lurker", "team_id": "019f2858-e253-7f3d-bdff-bc7738bd1036", "created_at": "2026-07-03T16:48:41.138416Z", "updated_at": "2026-07-25T23:06:56.921667Z", "own_rank": 95 }}{ "error": { "code": "not_found", "message": "not found", "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578" }}{ "error": { "code": "not_found", "message": "not found", "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578" }}{ "error": { "code": "not_found", "message": "not found", "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578" }}A player's all-time career aggregate GET
Derived career totals + averages over the player's whole-match stat rows (maps are not double-counted). Averages are null for a player with no rated maps. 404 for an unknown player. Enveloped `{"data": PlayerCareerStats}`.
List players for a game GET
Every player in the game, alphabetically by nickname, cursor-paginated. Filter by `team`, `slug` or `role`, or fetch a specific batch with `?ids=` (1–500 comma-separated ids) — which is the efficient way to resolve the player ids you got back from a match's stats in a single request instead of one call per player.