Teams

A single team

One team by id. Adds `external_rank`, a separately-sourced world ranking where one is on file, and — only when you ask for it with `?rank=1` or `?include=rank` — `own_rank`, the team's position on our own leaderboard.

GET
/v1/{game}/teams/{id}

One team by id. Adds external_rank, a separately-sourced world ranking where one is on file, and — only when you ask for it with ?rank=1 or ?include=rankown_rank, the team's position on our own leaderboard.

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

include?"rank"

Set to rank to populate own_rank, this entity's current position on the 3-month leaderboard. ?rank=1 is an equivalent shorthand.

Off by default because it costs a window query over the whole board (roughly 30–120ms) that most callers don't want to pay per request. Without it own_rank is null — which means "not requested", not "unranked". An entity below the ranking sample floor is also null.

Value in

  • "rank"
rank?string

Set rank=1 (or include=rank) to compute own_rank, our leaderboard position for this team. It runs a trailing-3-month window query, so it is opt-in — omit it and own_rank returns null (the window is skipped). external_rank is always included regardless.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/teams/019f2858-e253-7f3d-bdff-bc7738bd1036"
{  "data": {    "id": "019f2858-e253-7f3d-bdff-bc7738bd1036",    "game_id": "019f23d1-fb5b-7d24-935d-e4d68f6f565a",    "slug": "imperial",    "name": "Imperial",    "short_name": "IMP",    "region": "South America",    "country_code": "BR",    "logo_url": "",    "created_at": "2026-07-03T14:19:01.602907Z",    "updated_at": "2026-07-25T23:06:56.921667Z",    "own_rank": 58,    "external_rank": 91  }}
{  "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"  }}