Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Game Play Statistics

MLB Game Play Statistics provides hitting, pitching, and fielding statistics for each individual pitch of a given game.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache:

  • 60 seconds when a game is in scheduled status
  • 3 seconds when a game moves to inprogress
  • 600 seconds when a game moves to closed
  • 4 hours when seven days have passed since closed

Data Updates: Realtime

📘

Tracking Live Games

Learn how to enrich each pitch and at-bat with detailed hitting, pitching, and fielding outcomes in our Tracking Live Games integration scenario.


Data Points

Boxscore
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
abbrawayStringAbbreviation of the away team

ex. MIN (Minnesota)
durationgameStringDuration of a game in hours and minutes

ex. 3:18
delay_durationgameStringDuration of a game delay in hours and minutes

ex. 0:18
errorsscoring - awayIntegerNumber of errors for the away team
errorsinning - scoring - awayStringNumber of errors while the away team was batting in an inning

Value will be X when an inning is unplayed
hitsscoring - awayIntegerNumber of hits for the away team
hitsinning - scoring - awayStringNumber of hits for the away team in an inning

Value will be X when an inning is unplayed
idscoring - awayGUIDUnique ID of the away team

ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
marketscoring - awayStringMarket name of the away team

ex. Colorado
namescoring - awayStringTeam name of the away team

ex. Rockies
runsscoring - awayIntegerNumber of runs for the away team in the game
runsinning - scoring - awayStringNumber of runs for the away team in an inning

Value will be X when an inning is unplayed
abbrscoring - homeStringAbbreviation of the home team

ex. CLE (Cleveland)
errorsscoring - homeIntegerNumber of errors for the home team
errorsinning - scoring - homeStringNumber of errors while the home team was batting in an inning

Value will be X when an inning is unplayed
hitsscoring - homeIntegerNumber of hits for the home team
hitsinning - scoring - homeStringNumber of hits for the home team in an inning

Value will be X when an inning is unplayed
idscoring - homeGUIDUnique ID of the home team

ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
marketscoring - homeStringMarket name of the home team

ex. Cleveland
namescoring - homeStringTeam name of the home team

ex. Guardians
runsscoring - homeIntegerNumber of runs for the home team in the game
runsinning - scoring - homeStringNumber of runs for the home team in an inning

Value will be X when an inning is unplayed
lossawayIntegerNumber of away team losses year-to-date. Team win-loss data updates after a game moves to complete status.
losshomeIntegerNumber of home team losses year-to-date. Team win-loss data updates after a game moves to complete status.
winawayIntegerNumber of away team wins year-to-date. Team win-loss data updates after a game moves to complete status.
winhomeIntegerNumber of home team wins year-to-date. Team win-loss data updates after a game moves to complete status.
Game
AttributeParent ElementTypeDescription
away_teamgameGUIDUnique ID of the away team

ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
coveragegameStringCoverage level of a game

full, boxscore
deletedgameBooleanSignifies a game was deleted when true
double_headergameBooleanSignifies whether a game is part of a double header
day_nightgameStringSignifies a day or night game

D, N
entry_modegameStringSignifies the type of data entry

STOMP, LDE
gameday_typegameStringCoverage level of a game defined as Premium, Enhanced, or Regular

P - Premium
Pitch tracking, player tracking, and full Statcast product experience

E - Enhanced
Pitch tracking but not full Statcast product experience

Y - Regular
Pitch-by-Pitch resulting but no Statcast product experience

ex. gameday_type="E"
home_teamgameGUIDUnique ID of the home team

ex. ef64da7f-cfaf-4300-87b0-9313386b977c
idgameGUIDUnique ID of the game

ex. 1b554f5e-d8b7-4268-95da-2f4191015c84
is_game_poolgameBooleanSignifies a World Baseball Classic game (WBC) is part of opening "pool play" when true. See our FAQ for further details on the WBC.
is_game_bracketgameBooleanSignifies a World Baseball Classic game (WBC) is part of the elimination bracket when true. See our FAQ for further details on the WBC.
game_numbergameIntegerNumber of the game
parent_idgameGUIDStandard parent ID of a game or series. Use this ID to group events (like the World Series or All-Star Game) across seasons.

ex. 34e4cbbe-0086-4fad-bb08-840cbcfcabf0 (All-Star Game)
referencegameStringUnique MLBAM ID of a game
scheduledgamedateTimeScheduled date and time of a game

ex. 2022-09-25T20:10:00+00:00
tbdgameBooleanSignifies the game start time is to be determined. Placeholder start time is 08:00:00+00:00
season_idgameGUIDUnique ID of the season a game belongs within

ex. 6a5c278f-ebce-41f9-b1ba-2160b6af04ce
season_typegameStringCode type of the season a game belongs within

ex. REG (Regular), PRE (Preseason), PST (Postseason), AST (All-Star), WBC (World Baseball Classic)
season_yeargameIntegerYear of the season a game belongs within
split_squadgameBooleanSignifies a Spring Training split squad game
statusgameStringThe status of a game. See our FAQ for all statuses and their definitions.

scheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance
ideventGUIDUnique ID of a deleted event

ex. 5e3a0b5d-72fa-40e5-8f9d-a10e6a46a831
awaygame-time_zonesStringTime zone of the away team

ex. US/Pacific
homegame-time_zonesStringTime zone of the home team

ex. US/Eastern
venuegame-time_zonesStringTime zone of the venue

ex. US/Eastern
Lineup
AttributeParent ElementTypeDescription
descriptionlineupStringText description of a lineup change

ex. Louis Varland (P) replaces Max Scherzer (P).
idlineupGUIDUnique ID of a lineup entry

ex. 616d0907-26f1-4adf-875f-c0928d6d1b22
Play-By-Play - Inning
AttributeParent ElementTypeDescription
typeinning_halfStringIndicates top or bottom inning half

T, B
numberinningIntegerNumber of an inning
sequenceinningIntegerSequential number of an inning
Play-By-Play - At Bat
AttributeParent ElementTypeDescription
idat_batGUIDUnique ID of an at bat entry

ex. c1e69331-8909-4f1c-b132-5b33079355b4
description-StringText description of a play

ex. Will Smith singles to center field. Freddie Freeman to third.
Play-By-Play - At Bat Hitter
AttributeParent ElementTypeDescription
first_nameat_bat - hitterStringFirst name of a hitter

ex. Markus
full_nameat_bat - hitterStringFull name of a hitter

ex. Mookie Betts
suffixat_bat - hitterStringName suffix of a hitter

ex. Jr.
idat_bat - hitterGUIDUnique ID of a player of a hitter

ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberat_bat - hitterIntegerNumber of a hitter's jersey
last_nameat_bat - hitterStringLast name of a hitter

ex. Betts
preferred_nameat_bat - hitterStringPreferred name of a hitter

ex. Mookie
Play-By-Play - At Bat Pitcher
AttributeParent ElementTypeDescription
first_nameat_bat - pitcherStringFirst name of a pitcher

ex. Clayton
full_nameat_bat - pitcherStringFull name of a pitcher

ex. Clayton Kershaw
suffixat_bat - pitcherStringName suffix of a pitcher

ex. Jr.
idat_bat - pitcherGUIDUnique ID of a player of a pitcher

ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberat_bat - pitcherIntegerNumber of a pitcher's jersey
last_nameat_bat - pitcherStringLast name of a pitcher

ex. Kershaw
preferred_nameat_bat - pitcherStringPreferred name of a pitcher

ex. Clayton
Play Statistics - Hitting - Record
AttributeParent ElementTypeDescription
idat_bat - pitchGUIDUnique ID of a pitch

ex. 37d94861-7ce4-4547-802c-f97f93e434b4
abpitch - statistics - hitting - recordIntegerSignifies a pitch ended in an official at bat for the hitter when 1. Appears for the last event in an at bat.
appitch - statistics - hitting - recordIntegerSignifies a plate appearance when 1
pitch_countpitch - statistics - hitting - recordIntegerSignifies an official pitch when 1
lob_risp_2outpitch - statistics - hitting - recordIntegerNumber of runners a hitter left in scoring position with two outs. Appears for the last event in an at bat.
team_lobpitch - statistics - hitting - recordIntegerNumber of runners a hitter left on base. Appears for the last event in an at bat.
ab_risppitch - statistics - hitting - recordIntegerSignifies an at bat with runners in scoring position when 1. Appears for the last event in an at bat.
linedrivepitch - statistics - hitting - recordIntegerSignifies a line drive batted ball when 1
flyballpitch - statistics - hitting - recordIntegerSignifies a fly ball batted ball when 1
groundballpitch - statistics - hitting - recordIntegerSignifies a ground ball batted ball when 1
popuppitch - statistics - hitting - recordIntegerSignifies a pop-up batted ball when 1
bippitch - statistics - hitting - recordIntegerSignifies a a ball was put in play when 1
abkpitch - statistics - hitting - recordIntegerSignifies a batter strikeout when 1
rbipitch - statistics - hitting - recordIntegerNumber of runs batted in for a hitter for a pitch
babippitch - statistics - hitting - recordIntegerSignifies a pitch resulted in a hit when 1
isopitch - statistics - hitting - recordIntegerISO (Isolated Power) for a pitch

HR = 3, 3B = 2, 2B = 1
obppitch - statistics - hitting - recordIntegerSignifies a player reached base when 1
opspitch - statistics - hitting - recordIntegerOPS (On-Base + Slugging) for a pitch

For example, obp of 1 + slg of 4 (HR) = ops of 5
secapitch - statistics - hitting - recordIntegerSecondary average on a pitch. Only available if the ball in play is a home run.
slgpitch - statistics - hitting - recordIntegerSlugging value for a pitch.

1 = single, 2 = double, 3 = triple, 4 = home run
xbhpitch - statistics - hitting - recordIntegerSignifies an extra base hit when 1
hit_risppitch - statistics - hitting - recordIntegerSignifies a hit with runners in scoring position when 1. Appears for the last event in an at bat.
rbi_2outpitch - statistics - hitting - recordIntegerSignifies a run batted in with 2 outs when 1. Appears for the last event in an at bat.
abhrpitch - statistics - hitting - recordIntegerSignifies a home run when 1
bbpapitch - statistics - hitting - recordIntegerSignifies a base on balls when 1
Play Statistics - Hitting - Outcome
AttributeParent ElementTypeDescription
ballpitch - statistics - hitting - record - outcomeIntegerSignifies a pitch is a ball when 1
klookpitch - statistics - hitting - record - outcomeIntegerSignifies a pitch is a strike looking when 1
kswingpitch - statistics - hitting - record - outcomeIntegerSignifies a pitch is a strike swinging when 1
foulpitch - statistics - hitting - record - outcomeIntegerSignifies a pitch is fouled by the batter when 1
ktotalpitch - statistics - hitting - record - outcomeIntegerSignifies a pitch is a strike when 1
dirtballpitch - statistics - hitting - record - outcomeIntegerSignifies a pitch is a dirtball when 1
Play Statistics - Hitting - Outs
AttributeParent ElementTypeDescription
fopitch - statistics - hitting - record - outsIntegerSignifies an at bat ended in a fly out when 1
lopitch - statistics - hitting - record - outsIntegerSignifies an at bat ended in a lineout when 1
gopitch - statistics - hitting - record - outsIntegerSignifies an at bat ended in a groundout when 1
popitch - statistics - hitting - record - outsIntegerSignifies an at bat ended in a pop out when 1
kswingpitch - statistics - hitting - record - outsIntegerSignifies an at bat ended in a stikeout swinging when 1
ktotalpitch - statistics - hitting - record - outsIntegerSignifies an at bat ended in a stikeout when 1
klookpitch - statistics - hitting - record - outsIntegerSignifies an at bat ended in a stikeout looking when 1
gidppitch - statistics - hitting - record - outsIntegerSignifies an at bat ended in a groundout double play when 1
Play Statistics - Hitting - On Base
AttributeParent ElementTypeDescription
dpitch - statistics - hitting - record - onbaseIntegerSignifies an at bat ended in a double when 1
tbpitch - statistics - hitting - record - onbaseIntegerThe number of total bases for a hit
hpitch - statistics - hitting - record - onbaseIntegerSignifies an at bat ended in a hit when 1
spitch - statistics - hitting - record - onbaseIntegerSignifies an at bat ended in a single when 1
bbpitch - statistics - hitting - record - onbaseIntegerSignifies an at bat ended in a base on balls when 1
fcpitch - statistics - hitting - record - onbaseIntegerSignifies an at bat ended in a fielder's choice when 1
hrpitch - statistics - hitting - record - onbaseIntegerSignifies an at bat ended in a homerun when 1
ibbpitch - statistics - hitting - record - onbaseIntegerSignifies an at bat ended in an intentional base on balls when 1
Play Statistics - Hitting - Pitches
AttributeParent ElementTypeDescription
countpitch - statistics - hitting - record - pitchesIntegerSignifies an official pitch when 1
btotalpitch - statistics - hitting - record - pitchesIntegerSignifies a pitch is a ball when 1
ktotalpitch - statistics - hitting - record - pitchesIntegerSignifies a pitch is a strike when 1
Play Statistics - Hitting - Runs
AttributeParent ElementTypeDescription
totalpitch - statistics - hitting - record - runsIntegerNumber of runs scored for an offensive player on a pitch
Play Statistics - Hitting - Steals
AttributeParent ElementTypeDescription
caughtpitch - statistics - hitting - record - stealIntegerSignifies a runner was caught stealing when 1
stolenpitch - statistics - hitting - record - stealIntegerSignifies a stolen base when 1
pctpitch - statistics - hitting - record - stealDecimalSignifies a stolen base when 1 and caught stealing if 0
Play Statistics - Pitching - Record
AttributeParent ElementTypeDescription
lobpitch - statistics - pitching - recordIntegerNumber of runners left on base. Appears for the last event in an at bat.
pitch_countpitch - statistics - pitching - recordIntegerSignifies an official pitch when 1
ip_1pitch - statistics - pitching - recordIntegerSignifies an at bat ended in an out when 1
bfpitch - statistics - pitching - recordIntegerSignifies a batter faced when 1. Appears for the last event in an at bat.
k9pitch - statistics - pitching - recordIntegerStrikeouts per nine innings based on pitch outcome
oabpitch - statistics - pitching - recordIntegerSignifies an official at bat when 1
bf_ippitch - statistics - pitching - recordIntegerBatters faced per inning pitched
obapitch - statistics - pitching - recordIntegerSignifies a pitcher allowed a base runner for an at bat when 1
babippitch - statistics - pitching - recordIntegerSignifies a pitch resulted in a hit when 1
obppitch - statistics - pitching - recordIntegerSignifies a player reached base when 1
opspitch - statistics - pitching - recordIntegerOPS (On-Base + Slugging) for a pitch

For example, obp of 1 + slg of 4 (HR) = ops of 5
slgpitch - statistics - pitching - recordIntegerSlugging value for a pitch.

1 = single, 2 = double, 3 = triple, 4 = home run
wppitch - statistics - pitching - recordIntegerSignifies a wild pitch when 1
Play Statistics - Pitching - Outcome
AttributeParent ElementTypeDescription
ballpitch - statistics - pitching - record - outcomeIntegerSignifies a pitch is a ball when 1
klookpitch - statistics - pitching - record - outcomeIntegerSignifies a pitch is a strike looking when 1
kswingpitch - statistics - pitching - record - outcomeIntegerSignifies a pitch is a strike swinging when 1
foulpitch - statistics - pitching - record - outcomeIntegerSignifies a pitch is fouled by the batter when 1
ktotalpitch - statistics - pitching - record - outcomeIntegerSignifies a pitch is a strike when 1
dirtballpitch - statistics - pitching - record - outcomeIntegerSignifies a pitch is a dirtball when 1
Play Statistics - Pitching - Outs
AttributeParent ElementTypeDescription
fopitch - statistics - pitching - record - outsIntegerSignifies an at bat ended in a fly out when 1
lopitch - statistics - pitching - record - outsIntegerSignifies an at bat ended in a lineout when 1
gopitch - statistics - pitching - record - outsIntegerSignifies an at bat ended in a groundout when 1
popitch - statistics - pitching - record - outsIntegerSignifies an at bat ended in a pop out when 1
kswingpitch - statistics - pitching - record - outsIntegerSignifies an at bat ended in a stikeout swinging when 1
ktotalpitch - statistics - pitching - record - outsIntegerSignifies an at bat ended in a stikeout when 1
klookpitch - statistics - pitching - record - outsIntegerSignifies an at bat ended in a stikeout looking when 1
gidppitch - statistics - pitching - record - outsIntegerSignifies an at bat ended in a groundout double play when 1
Play Statistics - Pitching - On Base
AttributeParent ElementTypeDescription
dpitch - statistics - pitching - record - onbaseIntegerSignifies an at bat ended in a double when 1
tbpitch - statistics - pitching - record - onbaseIntegerThe number of total bases for a hit
hpitch - statistics - pitching - record - onbaseIntegerSignifies an at bat ended in a hit when 1
spitch - statistics - pitching - record - onbaseIntegerSignifies an at bat ended in a single when 1
bbpitch - statistics - pitching - record - onbaseIntegerSignifies an at bat ended in a base on balls when 1
fcpitch - statistics - pitching - record - onbaseIntegerSignifies an at bat ended in a fielder's choice when 1
hrpitch - statistics - pitching - record - onbaseIntegerSignifies an at bat ended in a homerun when 1
ibbpitch - statistics - pitching - record - onbaseIntegerSignifies an at bat ended in an intentional base on balls when 1
Play Statistics - Pitching - Pitches
AttributeParent ElementTypeDescription
countpitch - statistics - pitching - record - pitchesIntegerSignifies an official pitch when 1
btotalpitch - statistics - pitching - record - pitchesIntegerSignifies a pitch is a ball when 1
ktotalpitch - statistics - pitching - record - pitchesIntegerSignifies a pitch is a strike when 1
per_ippitch - statistics - pitching - record - pitchesIntegerBatters faced per inning pitched
per_bfpitch - statistics - pitching - record - pitchesIntegerBatters faced per inning pitched
Play Statistics - Pitching - In Play
AttributeParent ElementTypeDescription
linedrivepitch - statistics - pitching - record - in_playIntegerSignifies a batted ball was a line drive when 1
flyballpitch - statistics - pitching - record - in_playIntegerSignifies a batted ball was a fly ball when 1
groundballpitch - statistics - pitching - record - in_playIntegerSignifies a batted ball was a groundball when 1
popuppitch - statistics - pitching - record - in_playIntegerSignifies a batted ball was a pop up when 1
Play Statistics - Pitching - Runs
AttributeParent ElementTypeDescription
totalpitch - statistics - pitching - record - runsIntegerNumber of runs allowed for a pitcher on a pitch
earnedlineup - statistics - pitching - record - runsIntegerNumber of earned runs allowed for a pitcher on a pitch
irlineup - statistics - pitching - record - runsIntegerNumber of inherited runners for a pitcher
bqrlineup - statistics - pitching - record - runsIntegerNumber of bequeathed runners for a pitcher
Play Statistics - Pitching - Steals
AttributeParent ElementTypeDescription
caughtpitch - statistics - pitching - record - stealIntegerSignifies a runner was caught stealing when 1
stolenpitch - statistics - pitching - record - stealIntegerSignifies a stolen base allowed when 1
Play Statistics - Fielding - Record
AttributeParent ElementTypeDescription
popitch - statistics - fielding - recordIntegerSignifies a fielder recorded a putout for an at bat when 1
apitch - statistics - fielding - recordIntegerSignifies a fielder recorded an assist for an at bat when 1
tcpitch - statistics - fielding - recordIntegerSignifies a fielder recorded a chance for an at bat when 1.

Total Chances (tc) = putouts + assists + errors.
fpctpitch - statistics - fielding - recordIntegerFielding percentage on a pitch. 0 signifies an error
inn_1pitch - statistics - fielding - recordIntegerIndicates a player was in the field for the recorded out.

ex. If Player X received 13 inn_1 values, they played 4.1 innings in the field
dppitch - statistics - fielding - recordIntegerSignifies a fielder was involved in a double play when 1
c_wppitch - statistics - fielding - recordIntegerSignifies a wild pitch (under the catcher's entry) when 1
Play Statistics - Fielding - Assists
AttributeParent ElementTypeDescription
totalpitch - statistics - fielding - record - assistsIntegerSignifies a fielder recorded an assist when 1
Play Statistics - Fielding - Steals
AttributeParent ElementTypeDescription
caughtpitch - statistics - fielding - record - stealIntegerSignifies a runner was caught stealing when 1
stolenpitch - statistics - fielding - record - stealIntegerSignifies a stolen base allowed when 1
pctpitch - statistics - fielding - record - stealDecimalSignifies a stolen base when 1 and caught stealing if 0
Player

The player element represents the player associated with a pitch result. It may be a pitcher, hitter, base runner, or fielder.

AttributeParent ElementTypeDescription
first_namestatistics - hitting / pitching / fielding - record - playerStringFirst name of a hitter

ex. Markus
full_namestatistics - hitting / pitching / fielding - record - playerStringFull name of a hitter

ex. Mookie Betts
suffixstatistics - hitting / pitching / fielding - record - playerStringName suffix of a hitter

ex. Jr.
idstatistics - hitting / pitching / fielding - record - playerGUIDUnique ID of a player of a hitter

ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberstatistics - hitting / pitching / fielding - record - playerIntegerNumber of a hitter's jersey
last_namestatistics - hitting / pitching / fielding - record - playerStringLast name of a hitter

ex. Betts
preferred_namestatistics - hitting / pitching / fielding - record - playerStringPreferred name of a hitter

ex. Mookie
Team

The team element represents the team associated with a pitch result

AttributeParent ElementTypeDescription
abbrstatistics - hitting / pitching / fielding - record - teamStringAbbreviation of a team

ex. TOR (Toronto)
idstatistics - hitting / pitching / fielding - record - teamGUIDUnique ID of a team

ex. 481dfe7e-5dab-46ab-a49f-9dcc2b6e2cfd
namestatistics - hitting / pitching / fielding - record - teamStringName of a team

ex. Blue Jays
marketstatistics - hitting / pitching / fielding - record - teamStringMarket name of a team

ex. Toronto
Venue
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue

ex. 1000 Vin Scully Avenue
capacityvenueStringCapacity of a venue

ex. 56000
cityvenueStringCity of a venue

ex. Los Angeles
countryvenueStringCountry of a venue

ex. USA
field_orientationvenueStringField orientation of a venue

ex. NE
idvenueGUIDUnique ID of a venue

ex. 66a19c3d-24fe-477d-bee7-c6ef1b98352f
latlocationDecimalLatitude of a venue

ex. 34.0745409
lnglocationDecimalLongitude of a venue

ex. -118.2408881
marketvenueStringMarket of a venue

ex. Los Angeles
namevenueStringName of a venue

ex. Dodger Stadium
stadium_typevenueStringType of a venue

ex. outdoor
statevenueStringState of a venue

ex. CA
surfacevenueStringSurface type of a venue

ex. grass
time_zonevenueStringTime zone of a venue

ex. US/Central
zipvenueIntegerZIP code of a venue

ex. 90012

Path Params
string
enum
required
Defaults to trial

The access level of your API key

production (Production), trial (Trial),
tracking (Statcast Production), trial-tracking (Statcast Trial)

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English)

Allowed:
string
required
Defaults to 1d0697cd-72c4-4776-a76e-cea91348504d

Unique Id of a game, found in a Schedule endpoint.

Example: b0beb9a4-9276-4766-8ae6-c64469ded0da

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json