Head-to-head record between two teams
Completed-match record between the path team and `opponent`. Enveloped `{"data": HeadToHead}`.
Completed-match record between the path team and opponent. Enveloped {"data": HeadToHead}.
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 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.
Query Parameters
The opposing team — a UUID or a slug, exactly like the {id} path segment (e.g. opponent=faze). Required: without it there is no pair to compare.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/cs2/teams/019f2858-e253-7f3d-bdff-bc7738bd1036/h2h?opponent=019f23d1-fb5c-7940-be14-c8b28e2d90e8"{ "data": { "team_id": "019f2858-e253-7f3d-bdff-bc7738bd1036", "opponent_id": "019f23d1-fb5c-7940-be14-c8b28e2d90e8", "team_wins": 5, "opponent_wins": 1, "total": 6 }}{ "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" }}Team or player rankings (leaderboard) GET
Ranked leaderboard over a rolling **3-month** window. `?type=team` (default) or `?type=player` — the two are ranked on different metrics, reported in each row's `metric` field. **Teams** rank on `glicko2_conservative`: a Glicko-2 rating discounted by twice its rating deviation (`rating − 2·RD`), so a team with a volatile, thinly-evidenced rating sorts below an equally-rated team the model is confident about. **Players** rank on `rating`. Sorting rows by `value` reproduces `rank` exactly. Entities below the sample floor are omitted rather than ranked on noise: teams need at least 5 rated matches in the window, players at least 30 rated maps. This is always our own rating, never a third party's — a team's separately-sourced `external_rank` is reported alongside for comparison, not used for ordering. Not cursor-paginated: `limit` truncates the computed board and `meta.next_cursor` is always null.
A team's round-level playstyle profile GET
Aggregate round-level rates for the team (CT/T side win %, pistol %, opening-duel %, eco %, clutch %), derived over the team's recorded rounds. Each rate is a percentage in [0,100], or null when its denominator is empty. Enveloped `{"data": TeamRoundStats}`.