Players

A player's figures per map

Per competitive map the player has at least one recorded map on in the last 12 months: the maps played, ADR and KAST weighted by rounds, and kills per death. Each figure is `null` below 10 maps on that map; `n_adr` and `n_kast` count the maps that carry it. `active_pool` says whether the map is in the current Active Duty pool. Most played first; a map the player has not played in the window is absent. Enveloped `{"data": PlayerMaps}`.

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

Per competitive map the player has at least one recorded map on in the last 12 months: the maps played, ADR and KAST weighted by rounds, and kills per death. Each figure is null below 10 maps on that map; n_adr and n_kast count the maps that carry it. active_pool says whether the map is in the current Active Duty pool. Most played first; a map the player has not played in the window is absent. Enveloped {"data": PlayerMaps}.

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

A team or a player also answers to a slug it was renamed away from, as long as no current team or player holds that slug — so a link made before a rename keeps working. The row returned carries its current slug.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/players/019f2858-e253-7f3d-bdff-bc7738bd1036/maps"
{  "data": {    "window": {      "months": 12,      "through": "2026-10-10T13:45:00Z"    },    "maps": [      {        "map_name": "de_dust2",        "active_pool": true,        "maps": 45,        "adr": 89.9,        "kast": 80.9,        "kd": 1.69,        "n_adr": 45,        "n_kast": 45      },      {        "map_name": "de_mirage",        "active_pool": true,        "maps": 35,        "adr": 87.2,        "kast": 78.4,        "kd": 1.54,        "n_adr": 35,        "n_kast": 35      },      {        "map_name": "de_inferno",        "active_pool": true,        "maps": 32,        "adr": 84.1,        "kast": 79.5,        "kd": 1.37,        "n_adr": 32,        "n_kast": 32      },      {        "map_name": "de_nuke",        "active_pool": true,        "maps": 32,        "adr": 86.7,        "kast": 75.4,        "kd": 1.38,        "n_adr": 32,        "n_kast": 32      },      {        "map_name": "de_overpass",        "active_pool": false,        "maps": 20,        "adr": 89.7,        "kast": 79.1,        "kd": 1.69,        "n_adr": 20,        "n_kast": 20      },      {        "map_name": "de_anubis",        "active_pool": true,        "maps": 18,        "adr": 77,        "kast": 73.9,        "kd": 1.22,        "n_adr": 18,        "n_kast": 18      },      {        "map_name": "de_cache",        "active_pool": true,        "maps": 7,        "adr": null,        "kast": null,        "kd": null,        "n_adr": 7,        "n_kast": 7      },      {        "map_name": "de_train",        "active_pool": false,        "maps": 5,        "adr": null,        "kast": null,        "kd": null,        "n_adr": 5,        "n_kast": 5      },      {        "map_name": "de_ancient",        "active_pool": true,        "maps": 3,        "adr": null,        "kast": null,        "kd": null,        "n_adr": 3,        "n_kast": 3      }    ]  }}
{  "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": "rate_limited",    "message": "rate limit exceeded",    "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578"  }}