GET
List games / matches in a league

Authorizations

Authorization
string
header
default:tok_public_demo
required

Send a workspace API token in the Authorization: Bearer <token> header.

Path Parameters

league
string
required

League identifier from the /v1/leagues catalog (e.g. mlb, nba, epl, nfl, nhl). Unknown values return 404 unsupported_league.

Query Parameters

date
string<date>

Exact schedule date. Overrides date_from / date_to.

date_from
string<date>

Baseball date range start, inclusive, in league-local schedule date.

date_to
string<date>

Baseball date range end, inclusive, in league-local schedule date.

season
integer
week
integer

NFL-only week filter; ignored by other leagues.

game_type
enum<string>

NHL-only season-phase filter; ignored by other leagues.

Available options:
preseason,
regular,
postseason,
all-star,
other
team_id
string
status
enum<string>

Optional exact status filter. With upcoming=true, explicit postponed/cancelled filters are honored instead of the default playable-status set.

Available options:
scheduled,
live,
final,
postponed,
cancelled
upcoming
boolean

Baseball-only duplicate-safe upcoming list. Defaults to league-local today through +30 days and excludes postponed/cancelled/final rows unless status is supplied.

cursor
string
limit
integer
default:25
Required range: 1 <= x <= 200
provenance
boolean
default:false

When 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.