Skip to content
GGScore logoGGScore

CS2 schedule API

API key

Get keys in the cabinet

Fixtures that do not have a final score yet: teams, event, and start time. This is the upcoming list, not a live round feed.

GET/api/v2/upcoming_matches

List upcoming matches

Paginated scheduled CS2 matches (no final scores yet, played_at still in the future), soonest first. team1 / team2 may be strings or embedded objects depending on source row. Optional filters match GET /matches: team_id (either side), event_id, played_from (inclusive UTC), and played_to (exclusive UTC). meta.total is the filtered count. Authenticate with the X-API-Key header.

Authorizations

X-API-Keyheader

Required. API key from the GGScore cabinet. Do not send this key as Authorization: Bearer. Bearer is a cabinet session token.

Parameters

pageoptionalquery

1-based page index.

limitoptionalquery

Page size (max 100).

team_idoptionalquery

Team UUID. A match is included when this team won or lost. The parameter name is team_id.

event_idoptionalquery

Event UUID. Only matches from this tournament.

played_fromoptionalquery

Inclusive UTC lower bound on played_at (upcoming: play_at). YYYY-MM-DD is midnight at the start of that UTC day. An offset is converted to UTC. A value with no timezone is UTC.

played_tooptionalquery

Exclusive UTC upper bound on played_at (upcoming: play_at). YYYY-MM-DD is midnight at the start of that UTC day and is not included. September 2026 is played_from=2026-09-01&played_to=2026-10-01. The calendar day 2026-09-15 is played_from=2026-09-15&played_to=2026-09-16.

Request

curl -sS 'https://ggscore.net/api/v2/upcoming_matches?page=1&limit=5' \
  -H "X-API-Key: YOUR_API_KEY"

Try it

GET https://ggscore.net/api/v2/upcoming_matches?page=1&limit=5

Get keys in the cabinet