Skip to main content
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

X-API-Key
string
header
required

Tenant API key issued during onboarding

Headers

accept
string
default:application/json

Query Parameters

status
string | null

Filter by status: one of ('upcoming', 'live', 'finished', 'cancelled').

limit
integer
default:50
Required range: 1 <= x <= 200

Response

Successful Response

Last modified on May 25, 2026