Docsesportsodds.gg
V1GamePlayers

List players for a game

GET
/v1/{game}/players

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.

Query Parameters

slug?string

Exact-match filter on the resource's URL slug (e.g. slug=navi), scoped to {game}. Returns the single matching row — or an empty page when nothing matches — in the standard list envelope, so it is a direct by-slug lookup that never depends on page size or the cursor position. Composes with the endpoint's other filters (AND).

team?string

Filter to one team's roster (UUID).

Formatuuid
role?string
ids?string

Batch lookup by player id: a comma-separated list of 1–500 UUIDs, composed with the other filters (a malformed or out-of-range value returns 400). Resolves many players in one call.

sort?string

e.g. rating, adr (TARGET — not yet implemented; default order is nickname).

limit?integer

Page size. Clamped to a per-resource maximum; cursor carries the page position.

Range1 <= value
Default100
cursor?string

Opaque forward pagination cursor — pass the previous page's meta.next_cursor verbatim. Omit for the first page. Never construct one by hand.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/players"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "game_id": "129babd7-0a5a-4108-81e4-77c8f2b49aed",      "slug": "s1mple",      "nickname": "s1mple",      "real_name": "Oleksandr Kostyljev",      "nationality": "UA",      "role": "AWP",      "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "count": 0,    "next_cursor": "string"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}