Teams

A team's roster timeline (the five it actually fielded)

The five players a team actually fielded in each recent completed match, newest first, with the derived roster-change facts. `limit` default 20, max 100. Enveloped `{"data": [TeamRosterEntry, ...], "meta": {...}}` (not cursor-paginated). Read `continuity` BEFORE interpreting `changed_count`: `stable` (same five as last match), `changed` (1–4 players swapped — the only value for which `has_debutant` is asserted), `reset` (all five swapped, i.e. an organisation rename or full rebuild, NOT five stand-ins), `resumed` (previous match beyond a 60-day gap — a transfer window, not a stand-in), and `new` (no prior match, so `players_in`/`players_out` are empty because there is no baseline to diff against). A match where a team used more than five players across maps is omitted rather than guessed at.

GET
/v1/{game}/teams/{id}/roster-history

The five players a team actually fielded in each recent completed match, newest first, with the derived roster-change facts. limit default 20, max 100. Enveloped {"data": [TeamRosterEntry, ...], "meta": {...}} (not cursor-paginated).

Read continuity BEFORE interpreting changed_count: stable (same five as last match), changed (1–4 players swapped — the only value for which has_debutant is asserted), reset (all five swapped, i.e. an organisation rename or full rebuild, NOT five stand-ins), resumed (previous match beyond a 60-day gap — a transfer window, not a stand-in), and new (no prior match, so players_in/players_out are empty because there is no baseline to diff against). A match where a team used more than five players across maps is omitted rather than guessed at.

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.

Query Parameters

limit?integer

How many roster entries to return, newest first. Default 20, maximum 100. Not paginated.

Range1 <= value <= 100
Default20

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/teams/019f2858-e253-7f3d-bdff-bc7738bd1036/roster-history"
{  "data": [    {      "match_id": "019f8c3b-dfb9-7ae2-8d56-07ea339d4292",      "scheduled_at": "2026-07-23T19:00:00Z",      "player_ids": [        "019f23d2-5a34-794e-85fa-ae2f2009ef4f",        "019f28e1-e6ae-7032-8255-4c7e26548918"      ],      "continuity": "stable",      "changed_count": 0,      "players_in": [],      "players_out": [],      "has_debutant": false,      "days_since_prev": 3.83    },    {      "match_id": "019f77b7-6726-7180-b25b-f907e328ee7a",      "scheduled_at": "2026-07-19T23:00:00Z",      "player_ids": [        "019f23d2-5a34-794e-85fa-ae2f2009ef4f",        "019f28e1-e6ae-7032-8255-4c7e26548918"      ],      "continuity": "stable",      "changed_count": 0,      "players_in": [],      "players_out": [],      "has_debutant": false,      "days_since_prev": 1.08    }  ],  "meta": {    "count": 2,    "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"  }}