BaseballData API
Data
Coverage
MLB seasons held129MLB 2026 games2,469Postseason line scores40WBC and Premier12 games242Czech box scores1,430
See all coverage
DocsPricingStatus

Documentation/Games

GET /v1/{league}/games/{id}/plays | Baseball Data API

Every plate appearance of one game in order, with the pitches where they were recorded.
GEThttps://api.baseballapi.net/v1/{league}/games/{id}/plays

Try it

Run calls the API with your key.
// The answer appears here.

Returns

FieldWhat it holds
seqinteger: order in the game, from 1
inninginteger
halfstring: top or bottom
batterobject: id (pl_..., where held) and name
pitcherobject: id and name
outs_beforeinteger or null
ballsinteger or null
strikesinteger or null: the final count
pitchesarray or null: each pitch as ball, called_strike, swinging_strike, foul, in_play, hit_by_pitch or other
resultstring: single, double, triple, home_run, walk, intentional_walk, strikeout, hit_by_pitch, out, error, fielders_choice, sacrifice, catcher_interference or other
batted_ballstring or null: ground, line, fly or popup
runsinteger: runs scored on the play
rbiinteger or null
away_scoreinteger or null
home_scoreinteger or null: the score after the play

Example answer

The example is being collected; it appears here once the daily sample job has run.

Errors

Every endpoint can answer unauthorized, unknown_parameter, rate_limited, quota_exceeded and server_error, and not_found for an id or league that is not ours. See Errors.