Matches

Per-player performance stats for one match

Player stat lines — whole-match aggregates (null map_number) first, then per-map rows. Ratings are our own proprietary computation. Enveloped: `{"data": [PlayerMatchStats, ...], "meta": {...}}` (not cursor-paginated; `next_cursor` is null).

GET
/v1/{game}/matches/{id}/stats

Player stat lines — whole-match aggregates (null map_number) first, then per-map rows. Ratings are our own proprietary computation. Enveloped: {"data": [PlayerMatchStats, ...], "meta": {...}} (not cursor-paginated; next_cursor is null).

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.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/matches/019f2858-e253-7f3d-bdff-bc7738bd1036/stats"
{  "data": [    {      "id": "019f438a-abaf-7f37-9751-66e3d94b41e7",      "match_id": "019f3d18-c15f-7319-81a7-343e8a80a578",      "player_id": "019f28e1-e6ae-7032-8255-4c7e26548918",      "map_number": null,      "team_id": null,      "kills": 40,      "assists": 4,      "deaths": 28,      "adr": 88.49,      "rating": 1.5,      "kast": 0.6488095238095238,      "headshots": 27,      "first_kills": 5,      "first_deaths": 3,      "trade_kills": 4,      "trade_deaths": 4,      "clutches": 0,      "multikills_2k": 7,      "multikills_3k": 3,      "multikills_4k": 0,      "multikills_5k": 1,      "damage": 3931,      "utility_value": 8200,      "created_at": "2026-07-08T21:03:09.317112Z",      "updated_at": "2026-07-22T20:56:17.928167Z"    },    {      "id": "019f438a-abaf-798a-a08e-aa3953b2f879",      "match_id": "019f3d18-c15f-7319-81a7-343e8a80a578",      "player_id": "019f23d2-5a34-794e-85fa-ae2f2009ef4f",      "map_number": null,      "team_id": null,      "kills": 38,      "assists": 7,      "deaths": 22,      "adr": 75.85,      "rating": 1.89,      "kast": 0.7589285714285714,      "headshots": 14,      "first_kills": 5,      "first_deaths": 7,      "trade_kills": 11,      "trade_deaths": 6,      "clutches": 0,      "multikills_2k": 5,      "multikills_3k": 4,      "multikills_4k": 0,      "multikills_5k": 0,      "damage": 3374,      "utility_value": 7000,      "created_at": "2026-07-08T21:03:09.317112Z",      "updated_at": "2026-07-22T20:56:17.928167Z"    }  ],  "meta": {    "count": 30,    "next_cursor": null  }}
{  "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"  }}