Matches

What a match used to say, and when it stopped saying it

The changes made to a match's own fields, newest first, each with the value before and after.

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

The changes made to a match's own fields, newest first, each with the value before and after. Everywhere else reports THAT a match moved — ?changed_since= on the match list and the WebSocket changed field — because every other record is updated in place; this is the only surface that retains the prior value, which is what lets you reconcile a stored copy rather than overwrite it.

Only the match's own observable fields are tracked: status, score_a, score_b, winner_team_id, scheduled_at, started_at, ended_at, stage, format, result_type, team_a_id, team_b_id, tournament_id. An entry whose changed is ["data_available"] and whose changes is {} is an ARRIVAL, not a change — a sub-resource (maps, stats, rounds, depth, lineups) landed for the first time and the match's own fields did not move.

was_completed marks whether the match was ALREADY completed when it moved, which is the line between a correction to something we published as final and ordinary lifecycle progress.

History begins when this endpoint shipped and cannot be backfilled — earlier values were overwritten in place. Entries are retained for 180 days. A match with no recorded changes yields an empty list, as does an unknown id. Not cursor-paginated (next_cursor is null); page backwards with before. Ids inside changes are as recorded at the time and are never rewritten by a later merge, so one may no longer resolve.

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.

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.

Query Parameters

limit?integer

Maximum entries to return. Default 50, maximum 200.

Range1 <= value <= 200
Default50
before?string

RFC 3339 timestamp. Returns only entries strictly EARLIER than this instant. Exclusive, so passing the changed_at of the last entry you received returns the next page with no overlap and no gap. A malformed value is a 400.

Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/matches/019f2858-e253-7f3d-bdff-bc7738bd1036/history"
{  "data": [    {      "changed_at": "2026-09-21T19:42:07.318402Z",      "changed": [        "data_available"      ],      "changes": {},      "was_completed": true    },    {      "changed_at": "2026-09-21T11:08:44.901233Z",      "changed": [        "score_b",        "winner_team_id"      ],      "changes": {        "score_b": {          "from": 1,          "to": 0        },        "winner_team_id": {          "from": "019f2858-e255-78e4-9e7c-32f307dfac91",          "to": "01a0916e-90e4-7469-903a-463c4fc69c4b"        }      },      "was_completed": true    },    {      "changed_at": "2026-09-20T21:15:02.447810Z",      "changed": [        "status",        "score_a",        "ended_at"      ],      "changes": {        "status": {          "from": "live",          "to": "completed"        },        "score_a": {          "from": 1,          "to": 2        },        "ended_at": {          "from": null,          "to": "2026-09-20T21:14:58Z"        }      },      "was_completed": false    }  ],  "meta": {    "count": 3,    "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": "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"  }}