List Matches
Bucketed list of live, upcoming, and finished CS2 matches
GET
List CS2 matches
What it returns
Without?status: a bucketed list — live matches first, then upcoming, then finished. With a status filter, only that bucket comes back, sorted appropriately. Phantom 0-0 finished/cancelled rows are filtered out — only matches that actually played are returned.
Each row carries the basic match shape (id, teams, event, status, scheduled_at, live score). Internal fields like integration IDs and data_delay_seconds only come through if your key has cs2:matches:internals.
Required scope
- Minimum:
cs2:matches:list
Common queries
Example
Authorizations
Tenant API key issued during onboarding
Headers
Query Parameters
Filter by status: one of ('upcoming', 'live', 'finished', 'cancelled').
Required range:
1 <= x <= 200Response
Successful Response
Last modified on May 25, 2026
List CS2 matches