List games / matches in a league
Schedule list for the given league. Soccer leagues also expose this
as /v1/{league}/matches. Cursor-paginated; default limit 25, max 200.
Sport-specific filters: week applies to NFL only (regular-season
weeks 1–18; postseason weeks 1–4); game_type applies to NHL only
(preseason | regular | postseason | all-star | other).
Both are accepted on every league and ignored by the sports that
don’t use them.
Baseball leagues (mlb, kbo, npb) also support date ranges via
date_from / date_to and duplicate-safe upcoming lists via
upcoming=true, for example
/v1/npb/games?team_id=npb-SF&upcoming=true&limit=10.
If date is supplied it wins over date_from / date_to.
Authorizations
Send a workspace API token in the Authorization: Bearer <token> header.
Path Parameters
League identifier from the /v1/leagues catalog (e.g. mlb, nba,
epl, nfl, nhl). Unknown values return 404 unsupported_league.
Query Parameters
Exact schedule date. Overrides date_from / date_to.
Baseball date range start, inclusive, in league-local schedule date.
Baseball date range end, inclusive, in league-local schedule date.
NFL-only week filter; ignored by other leagues.
NHL-only season-phase filter; ignored by other leagues.
preseason, regular, postseason, all-star, other Optional exact status filter. With upcoming=true, explicit postponed/cancelled filters are honored instead of the default playable-status set.
scheduled, live, final, postponed, cancelled Baseball-only duplicate-safe upcoming list. Defaults to league-local today through +30 days and excludes postponed/cancelled/final rows unless status is supplied.
1 <= x <= 200When true, the response envelope includes per-field provenance
metadata under _meta.provenance (source adapter, ingest run id,
timestamp). Default: omitted.
Response
Page of games / matches.