v2

latestOpenAPI 3.1.02026-07-265966163.8 KB

V2 Events

Get play-by-play for an event

Returns the play-by-play timeline for a live or completed event — one entry per play with description, period, game clock, running score, and (as attribution rolls out) the players involved. Live game state and play-by-play require an Ultra plan or higher; keys on lower tiers receive a 403. The companion live_game_state snapshot (current inning/quarter, count, base runners, possession, and more) is embedded on live event payloads for entitled keys. Also available for streaming via the plays channel on the V2 WebSocket.

get/api/v2/events/{eventID}/plays

Path parameters

eventIDstring required

Canonical V2 event ID from the event_id field returned by event endpoints

Query parameters

limitinteger

Number of plays to return. The most recent plays are selected, then returned in ascending sequence order. Values above 500 are capped.

before_sequenceinteger

Pagination cursor — returns plays with sequence lower than this value. Use the lowest sequence from the previous page to walk backwards through long games.

Response

Play-by-play timeline

event_idstring

sport_idinteger

sportstring

Example response

{
  "sport": "mlb",
  "plays": [
    {
      "description": "Bobby Witt Jr. singles on a line drive to center field.",
      "participants": [
        {
          "role": "batter"
        }
      ]
    }
  ]
}