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.
Authorizations
API key as query parameter
Path Parameters
Canonical V2 event ID from the event_id field returned by event endpoints
Query Parameters
Number of plays to return. The most recent plays are selected, then returned in ascending sequence order. Values above 500 are capped.
x <= 500Pagination cursor — returns plays with sequence lower than this value. Use the lowest sequence from the previous page to walk backwards through long games.