Skip to navigation

Get a game with its live state

Authentication

AuthorizationBearer

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

Path parameters

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

Headers

If-None-MatchstringOptional

An ETag from an earlier response. When it still matches, the response is 304 with no body.

Response headers

ETagstringOptional

Identifies this version of the response, for If-None-Match.

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

The game, its live state, teams and venue, and the stream position they reflect.
gameobject
live_stateobject or null
Null until the game has live data.
home_teamobject
away_teamobject
venueobject or null
period_scoreslist of objects
seqlong>=0
The position in the game's stream this response reflects. Resume a subscription from it.

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