Skip to navigation
API ReferenceGames

List games

A schedule page, ordered by start time. Pass either date, a schedule day, or a from-to range of start times up to 31 days long. Games are listed once the league publishes them with both teams known, up to the end of its season, and a game the league withdraws before it starts is removed. A range matches time_tbd games by their scheduled_at, the start of their US Eastern day.

Authentication

AuthorizationBearer

An API key, sent as Authorization: Bearer <key>.

Path parameters

leaguestringRequiredformat: "^[a-z][a-z0-9]*$"
The league's alias.

Query parameters

datedateOptional

A schedule day, in the time zone tz. A time_tbd game has no start time, so it is matched by its US Eastern day whatever tz is.

tzstringOptionalDefaults to America/New_York

IANA time zone that date is in.

fromdatetimeOptional
Earliest start time, inclusive.
todatetimeOptional
Latest start time, exclusive.
team_idstringOptionalformat: "uuid"
Only games this team plays in.
cursorstringOptional

next_cursor from the previous page. Omit it for the first page.

limitintegerOptional1-500Defaults to 100
Page size.

Response headers

RateLimit-PolicystringOptional

Your plan’s allowance: q requests per period of w seconds. See Rate limits.

RateLimitstringOptional

Requests left this period after this response (r) and seconds until it resets (t). See Rate limits.

Response

A page of games with the teams they reference.
datalist of objects
teamslist of objects
The teams the page's games reference.
next_cursorstring or null

Pass as cursor for the next page; null on the last page.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error