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.
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.
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 slug. cs2 is the only populated title today; an un-onboarded game 404s cleanly.
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
How many roster entries to return, newest first. Default 20, maximum 100. Not paginated.
1 <= value <= 10020Response 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": "rate_limited", "message": "rate limit exceeded", "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578" }}