Matches

Per-player performance stats for one match

Player stat lines — whole-match aggregates (null map_number) first, then per-map rows.

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). Already fetching the match? ?include=stats on GET /v1/{game}/matches/{id} returns this inside that response, in the same request (several at once: include=maps,stats,depth).

Authorization

AuthorizationBearer <token>

The primary way to authenticate: Authorization: Bearer <api-key>. When a request also carries ?apiKey=, the header wins. We store only a SHA-256 hash of a key, never the key itself. To try the API with no account, use the public sample key eo_sample_public: one published key, shared by everyone, that reads a fixed sample of past matches within daily limits. For evaluation; our Terms apply.

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

application/json

curl -X GET "https://example.com/v1/cs2/matches/019f2858-e253-7f3d-bdff-bc7738bd1036/stats"
{  "data": [    {      "id": "01a0b3e9-6b32-77f4-9d23-513fb188d334",      "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",      "player_id": "019f28e2-22cb-74ea-af0f-0408f360cec2",      "map_number": null,      "team_id": "019f2858-e255-78e4-9e7c-32f307dfac91",      "kills": 30,      "assists": 12,      "deaths": 12,      "adr": 108.42,      "rating": 3,      "kast": 0.8708333333333333,      "headshots": 19,      "first_kills": 0,      "first_deaths": 1,      "trade_kills": 3,      "trade_deaths": 6,      "clutches": 0,      "multikills_2k": 6,      "multikills_3k": 1,      "multikills_4k": 1,      "multikills_5k": 0,      "damage": 3361,      "utility_value": 6400,      "created_at": "2026-09-18T09:47:13.853948Z",      "updated_at": "2026-09-19T13:18:03.676691Z"    },    {      "id": "01a0b3e9-6b32-73e1-8a41-50d910a77834",      "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678",      "player_id": "019f28e2-76af-7029-97b5-70686851cd14",      "map_number": null,      "team_id": "019f2858-e255-78e4-9e7c-32f307dfac91",      "kills": 29,      "assists": 10,      "deaths": 17,      "adr": 91.84,      "rating": 2,      "kast": 0.8708333333333333,      "headshots": 14,      "first_kills": 7,      "first_deaths": 3,      "trade_kills": 6,      "trade_deaths": 4,      "clutches": 0,      "multikills_2k": 4,      "multikills_3k": 4,      "multikills_4k": 0,      "multikills_5k": 0,      "damage": 2847,      "utility_value": 7500,      "created_at": "2026-09-18T09:47:13.853948Z",      "updated_at": "2026-09-19T13:18:03.676691Z"    }  ],  "meta": {    "count": 30,    "next_cursor": null  }}
{  "error": {    "code": "match_merged",    "message": "this match id was merged into 01a0d06b-4e06-7e01-905d-7384ae3c7ce1; use that id",    "request_id": "01a12d10-6b2e-7d3a-9a4f-2c1d0e9b8a77"  }}
{  "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"  }}