Docsesportsodds.gg
V1GameMatches

List matches for a game

Matches for the game, newest scheduled first. An unknown `{game}` 404s cleanly.

GET
/v1/{game}/matches

Matches for the game, newest scheduled first. An unknown {game} 404s cleanly.

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

status?string

Filter by match status.

Value in

  • "scheduled"
  • "live"
  • "completed"
tournament?string

Filter by tournament (UUID).

Formatuuid
team?string

Filter by team (UUID).

Formatuuid
date_from?string
Formatdate
date_to?string
Formatdate
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.

include?string

Comma-separated related resources to expand inline, e.g. include=teams,tournament,odds on a match (odds embeds the latest eo_model line pair) (TARGET). Unknown names are ignored.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/matches"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "game_id": "129babd7-0a5a-4108-81e4-77c8f2b49aed",      "tournament_id": "4f5acba7-e5ad-4a94-a930-e70660e2e15d",      "team_a_id": "253fbcab-bb9c-4a93-8989-042f8eae45af",      "team_b_id": "5e24a037-8db3-4a2c-828d-eda65e388d8b",      "format": "bo1",      "status": "scheduled",      "stage": "Quarterfinal",      "scheduled_at": "2019-08-24T14:15:22Z",      "score_a": 0,      "score_b": 0,      "winner_team_id": "a647f0df-a125-4ec0-8793-2d7fc492c451",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "team_a_name": "Natus Vincere",      "team_a_short": "NAVI",      "team_b_name": "FaZe Clan",      "team_b_short": "FaZe",      "tournament_name": "IEM Katowice 2026"    }  ],  "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"  }}