GET
/
v1
/
{league}
/
games
List games / matches in a league
curl --request GET \
  --url http://localhost:8082/v1/{league}/games \
  --header 'Authorization: Bearer <token>'

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>
​
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>
Available options:
scheduled,
live,
final,
postponed
​
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.