Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Daily Boxscore

MLB Daily Boxscore provides inning-by-inning scoring breakdown, top-level runs, hits and errors by team, as well as details on run-scoring events for all games on a given MLB defined day.

⏱️

Update Frequency

TTL / Cache: 120 seconds

Data Updates: Realtime

* Note: A Major League Baseball day begins at 4am ET and ends at 3:59:59am ET the following day.



Data Points

League:
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league
ex. MLB
idleagueGUIDUnique ID of a league
ex. 2fa448bc-fc17-4d3d-be03-e60e080fdc26
nameleagueStringName of a league
ex. Major League Baseball
Boxscore:
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
abbrawayStringAbbreviation of the away team
ex. MIN (Minnesota)
abbrhomeStringAbbreviation of the home team
ex. CIN (Cincinnati)
datedaily-boxscoreDateDate of the daily boxscore
ex. 2022-07-05
durationgameStringDuration of a game in hours and minutes
ex. 3:18
errorsawayIntegerNumber of errors for the away team
errorshomeIntegerNumber of errors for the home team
errorsaway - inningIntegerNumber of errors for the away team in an inning
hitsawayIntegerNumber of hits for the away team
hitshomeIntegerNumber of hits for the home team
hitsaway - inningIntegerNumber of hits for the away team in an inning
idawayGUIDUnique ID of the away team
ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
idhomeGUIDUnique ID of the home team
ex. 481dfe7e-5dab-46ab-a49f-9dcc2b6e2cfd
lossawayIntegerNumber of losses for the away team
losshomeIntegerNumber of losses for the home team
marketawayStringMarket name of the away team
ex. Colorado
markethomeStringMarket name of the home team
ex. Minnesota
nameawayStringTeam name of the away team
ex. Rockies
namehomeStringTeam name of the home team
ex. Twins
runsawayIntegerNumber of runs for the away team in the game
runshomeIntegerNumber of runs for the home team in the game
runsaway - inningIntegerNumber of runs for the away team in an inning
runshome - inningIntegerNumber of runs for the home team in an inning
winawayIntegerNumber of wins for the away team
winhomeIntegerNumber of wins for the home team
current_inning_halfoutcomeStringThe current inning half as top or bottom
T , B
current_inningoutcomeIntegerThe current inning number
inning_halffinalStringIndicates the final inning half as top or bottom
T , B
inningfinalIntegerIndicates the final inning number
Count:
AttributeParent ElementTypeDescription
ballsoutcome - countIntegerNumber of balls for the current at bat
inning_halfoutcome - countStringIndicates top or bottom inning half
T , B
half_overoutcome - countBooleanIndicates an inning half has ended
inningoutcome - countIntegerNumber of the current inning
outsoutcome - countIntegerNumber of outs
strikesoutcome - countIntegerNumber of strikes for the current at bat
Current Baserunners:
AttributeParent ElementTypeDescription
description-StringText description of a runner outcome
ex. Will Smith to third. or Freddie Freeman scores.
ending_baseoutcome - runnerIntegerRunner's base at the end of a play
first_nameoutcome - runnerStringFirst name of the current runner
ex. Markus
full_nameoutcome - runnerStringFull name of the current runner
ex. Mookie Betts
suffixoutcome - runnerStringName suffix of the current runner
ex. Jr.
idoutcome - runnerGUIDUnique player ID of the current runner
ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberoutcome - runnerIntegerNumber of the current runner's jersey
last_nameoutcome - runnerStringLast name of the current runner
ex. Betts
outoutcome - runnerBooleanSignifies the runner was out on a play
outcome_idoutcome - runnerStringID of a runner outcome on a play. Check our FAQ for a list of valid outcomes and their definitions
preferred_nameoutcome - runnerStringPreferred name of the current runner
ex. Mookie
starting_baseoutcome - runnerIntegerRunner's base at the start of a play
Current Hitter:
AttributeParent ElementTypeDescription
ab_overoutcome - hitterBooleanIndicates an at bat is over
first_nameoutcome - hitterStringFirst name of the current hitter
ex. Markus
full_nameoutcome - hitterStringFull name of the current hitter
ex. Mookie Betts
suffixoutcome - hitterStringName suffix of the current hitter
ex. Jr.
idoutcome - hitterGUIDUnique player ID of the current hitter
ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberoutcome - hitterIntegerNumber of the current hitter's jersey
last_nameoutcome - hitterStringLast name of the current hitter
ex. Betts
outoutcome - hitterBooleanSignifies the hitter was out on a play
outcome_idoutcome - hitterStringID of a hitter outcome on a play. Check our FAQ for a list of valid outcomes and their definitions
preferred_nameoutcome - hitterStringPreferred name of the current hitter
ex. Mookie
Current Pitcher:
AttributeParent ElementTypeDescription
first_nameoutcome - pitcherStringFirst name of the current pitcher
ex. Clayton
full_nameoutcome - pitcherStringFull name of the current pitcher
ex. Clayton Kershaw
suffixoutcome - pitcherStringName suffix of the current pitcher
ex. Jr.
idoutcome - pitcherGUIDUnique player ID of the current pitcher
ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberoutcome - pitcherIntegerNumber of the current pitcher's jersey
last_nameoutcome - pitcherStringLast name of the current pitcher
ex. Kershaw
pitch_speedoutcome - pitcherStringSpeed of a pitch in MPH
ex. 92.0
pitch_typeoutcome - pitcherStringCode for a type of pitch
FA(Fastball), SI(Sinker), CT(Cutter), CU(Curveball), SL(Slider), CH(Changeup), KN(Knuckleball), SP(Splitter), SC(Screwball), FO(Forkball), IB(Intentional Ball), PI(Pitchout), Other
pitch_zoneoutcome - pitcherIntegerNumber corresponding to the pitch strike zone (1-13)
See our FAQ for more detail and a graphic representation
preferred_nameoutcome - pitcherStringPreferred name of the current pitcher
ex. Clayton
eraaway - current_pitcherStringERA of the current away team pitcher
ex. 5.952
first_nameaway - current_pitcherStringFirst name of the current away team pitcher
ex. Bryse
full_nameaway - current_pitcherStringFull name of the current away team pitcher
ex. Bryse Wilson
suffixaway - current_pitcherStringName suffix of the current away team pitcher
ex. Jr.
idaway - current_pitcherGUIDUnique ID of the current away team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02
jersey_numberaway - current_pitcherIntegerNumber of the current away team pitcher's jersey
last_nameaway - current_pitcherStringLast name of the current away team pitcher
ex. Wilson
lossaway - current_pitcherIntegerNumber of losses for the current away team pitcher
preferred_nameaway - current_pitcherStringPreferred name of the current away team pitcher
ex. Bryce
winaway - current_pitcherIntegerNumber of wins for the current away team pitcher
erahome - current_pitcherStringERA of the current home team pitcher
ex. 5.952
first_namehome - current_pitcherStringFirst name of the current home team pitcher
ex. Bryse
full_namehome - current_pitcherStringFull name of the current home team pitcher
ex. Bryse Wilson
suffixhome - current_pitcherStringName suffix of the current home team pitcher
ex. Jr.
idhome - current_pitcherGUIDUnique ID of the current home team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02
jersey_numberhome - current_pitcherIntegerNumber of the current home team pitcher's jersey
last_namehome - current_pitcherStringLast name of the current home team pitcher
ex. Wilson
losshome - current_pitcherIntegerNumber of losses for the current home team pitcher
preferred_namehome - current_pitcherStringPreferred name of the current home team pitcher
ex. Bryce
winhome - current_pitcherIntegerNumber of wins for the current home team pitcher
Probable Pitcher:
AttributeParent ElementTypeDescription
eraaway - probable_pitcherStringERA of the probable away team pitcher
ex. 5.952
first_nameaway - probable_pitcherStringFirst name of the probable away team pitcher
ex. Bryse
full_nameaway - probable_pitcherStringFull name of the probable away team pitcher
ex. Bryse Wilson
suffixaway - probable_pitcherStringName suffix of the probable away team pitcher
ex. Jr.
idaway - probable_pitcherGUIDUnique ID of the probable away team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02
jersey_numberaway - probable_pitcherIntegerNumber of the probable away team pitcher's jersey
last_nameaway - probable_pitcherStringLast name of the probable away team pitcher
ex. Wilson
lossaway - probable_pitcherIntegerNumber of losses for the probable away team pitcher
preferred_nameaway - probable_pitcherStringPreferred name of the probable away team pitcher
ex. Bryce
winaway - probable_pitcherIntegerNumber of wins for the probable away team pitcher
erahome - probable_pitcherStringERA of the probable home team pitcher
ex. 5.952
first_namehome - probable_pitcherStringFirst name of the probable home team pitcher
ex. Luis
full_namehome - probable_pitcherStringFull name of the probable home team pitcher
ex. Luis Cessa
suffixhome - probable_pitcherStringName suffix of the probable home team pitcher
ex. Jr.
idhome - probable_pitcherGUIDUnique ID of the probable home team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02
jersey_numberhome - probable_pitcherIntegerNumber of the probable home team pitcher's jersey
last_namehome - probable_pitcherStringLast name of the probable home team pitcher
ex. Cessa
losshome - probable_pitcherIntegerNumber of losses for the probable home team pitcher
preferred_namehome - probable_pitcherStringPreferred name of the probable home team pitcher
ex. Luis
winhome - probable_pitcherIntegerNumber of wins for the probable home team pitcher
Starting Pitcher:
AttributeParent ElementTypeDescription
eraaway - starting_pitcherStringERA of the starting away team pitcher
ex. 5.952
first_nameaway - starting_pitcherStringFirst name of the starting away team pitcher
ex. Bryse
full_nameaway - starting_pitcherStringFull name of the starting away team pitcher
ex. Bryse Wilson
suffixaway - starting_pitcherStringName suffix of the starting away team pitcher
ex. Jr.
idaway - starting_pitcherGUIDUnique ID of the starting away team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02
jersey_numberaway - starting_pitcherIntegerNumber of the starting away team pitcher's jersey
last_nameaway - starting_pitcherStringLast name of the starting away team pitcher
ex. Wilson
lossaway - starting_pitcherIntegerNumber of losses for the starting away team pitcher
preferred_nameaway - starting_pitcherStringPreferred name of the starting away team pitcher
ex. Bryce
winaway - starting_pitcherIntegerNumber of wins for the starting away team pitcher
erahome - starting_pitcherStringERA of the starting home team pitcher
ex. 5.952
first_namehome - starting_pitcherStringFirst name of the starting home team pitcher
ex. Bryse
full_namehome - starting_pitcherStringFull name of the starting home team pitcher
ex. Bryse Wilson
suffixhome - starting_pitcherStringName suffix of the starting home team pitcher
ex. Jr.
idhome - starting_pitcherGUIDUnique ID of the starting home team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02
jersey_numberhome - starting_pitcherIntegerNumber of the starting home team pitcher's jersey
last_namehome - starting_pitcherStringLast name of the starting home team pitcher
ex. Wilson
losshome - starting_pitcherIntegerNumber of losses for the starting home team pitcher
preferred_namehome - starting_pitcherStringPreferred name of the starting home team pitcher
ex. Bryce
winhome - starting_pitcherIntegerNumber of wins for the starting home team pitcher
Pitcher Outcomes:
AttributeParent ElementTypeDescription
first_nameplayerStringFirst name of the pitcher
ex. Bryse
full_nameplayerStringFirst name of the pitcher
ex. Bryse Wilson
suffixplayerStringName suffix of the pitcher
ex. Jr.
idplayerGUIDUnique ID of the pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02
jersey_numberplayerIntegerNumber of the pitcher's jersey
last_nameplayerStringLast name of the pitcher
ex. Wilson
positionplayerStringPosition of a player
C(Catcher), IF(Infield), OF(Outfield), P(Pitcher), DH(Designated Hitter)
preferred_nameplayerStringPreferred name of the pitcher
ex. Bryce
primary_positionplayerStringPrimary position of a player
C(Catcher), IF(Infield), 1B(First Base), 2B(Second Base), 3B(Third Base), SS(Shortstop), OF(Outfield), LF(Left Field), CF(Centerfield), P(Pitcher), RF(Right Field), RP(Relief Pitcher), SP(Starting Pitcher), DH(Designated Hitter)
statusplayerStringStatus of a player
A(Activated), BRV(Bereavement Leave), D7(7 Day Injured List), D10(10 Day Injured List), D60(60 Day Injured List), DFA(Designated for assignment), FA(Free agent), FME(Family Medical Emergency), LV(Paid Leave), MIN(Minors), NRI(Non-roster Invite), PL(Paternity Leave), RST(Restricted), RET(Retired), SUS(Suspended), UDP(Unsigned Draft Pick), WV(Waivers), DUP(Duplicate Profile), Null(Blank)(Traded or not activated)

*Traded players temporarily have no status listed after they are traded to a new team and are either activated by the MLB club or assigned to a minor league affiliate
blown_saveplayerIntegerCurrent number of seasonal blown saves for a pitcher. Player will appear within the blown_save element if he recorded a blown save in this game
holdplayerIntegerCurrent number of seasonal holds for a pitcher. Player will appear within the hold element if he recorded a hold in this game
lossplayerIntegerCurrent number of seasonal losses for a pitcher. Player will appear within the loss element if he recorded a loss in this game
saveplayerIntegerCurrent number of seasonal saves for a pitcher. Player will appear within the save element if he recorded a save in this game
winplayerIntegerCurrent number of seasonal wins for a pitcher. Player will appear within the win element if he recorded a win in this game
Scoring by Inning:
AttributeParent ElementTypeDescription
errorsscoring - inningStringNumber of errors in an inning for the home or away team
hitsscoring - inningStringNumber of hits in an inning for the home or away team
numberscoring - inningIntegerNumber of an inning
sequencescoring - inningIntegerSequential number of an inning
runsscoring - inningStringNumber of runs in an inning for the home or away team
Runs Scored:
AttributeParent ElementTypeDescription
typeruns - runStringType of action preceding a run scoring play
ex. pitch
hitter_idruns - runGUIDUnique player ID of a hitter for a run scoring play
ex. ea1a2111-44cc-4996-babb-9439465e6760
hitter_outcomeruns - runStringID of a hit outcome on a play. Check our FAQ for a list of valid outcomes and their definitions
inningruns - runIntegerNumber of inning with a scoring play
inning_halfruns - runIntegerNumber of inning half with a scoring play
pitcher_idruns - runGUIDUnique player ID of a pitcher for a run scoring play
ex. ea1a2111-44cc-4996-babb-9439465e6760
first_nameruns - run - runnerStringFirst name of the scoring runner
ex. Markus
full_nameruns - run - runnerStringFull name of the scoring runner
ex. Mookie Betts
suffixruns - run - runnerStringName suffix of the scoring runner
ex. Jr.
jersey_numberruns - run - runnerIntegerNumber of the scoring runner's jersey
last_nameruns - run - runnerStringLast name of the scoring runner
ex. Betts
preferred_nameruns - run - runnerStringPreferred name of the scoring runner
ex. Mookie
idruns - runGUIDUnique ID of a run scoring play
ex. f75b7565-b2ca-4bb3-985b-f4637fed2e0b
idruns - run - runnerGUIDUnique ID of a runner for a run scoring play
ex. f75b7565-b2ca-4bb3-985b-f4637fed2e0b
starting_baseruns - run - runnerIntegerRunner's base at the start of a run scoring play
Game:
AttributeParent ElementTypeDescription
away_teamgameGUIDUnique ID of the away team
ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b
cablebroadcastStringName of the game's broadcast cable station
internetbroadcastStringName of the game's internet stream
networkbroadcastStringName of the game's broadcast network
ex. MLB Network
radiobroadcastStringName of the game's broadcast radio station
satellitebroadcastStringName of the game's broadcast satellite station
coveragegameStringCoverage level of a game
full , boxscore
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
home_teamgameGUIDUnique ID of the home team
ex. ef64da7f-cfaf-4300-87b0-9313386b977c
idgameGUIDUnique ID of the game
ex. 1b554f5e-d8b7-4268-95da-2f4191015c84
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)
season_yeargameIntegerYear of the season a game belongs within
split_squadgameBooleanSignifies a Spring Training split squad game
statusgameStringThe status of a game
scheduled , inprogress , complete , closed , wdelay , fdelay , odelay , canceled , unnecessary , if-necessary , postponed , suspended , maintenance
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
Weather:
AttributeParent ElementTypeDescription
cloud_covercurrent_conditionsIntegerCurrent cloud cover of a game in percentage
conditioncurrent_conditionsStringCurrent weather condition of a game
dew_point_fcurrent_conditionsIntegerCurrent dew point number of a game
humiditycurrent_conditionsIntegerCurrent humidity number of a game
obs_timecurrent_conditionsdateTimeTimestamp of the current weather observation
ex. 2020-02-24T20:24:34.000Z
current_temperature_fcurrent_conditionsIntegerCurrent temperature of a game in Fahrenheit
directionwindStringDirection of wind in a game
speed_mphwindIntegerWind speed in the game in miles per hour
cloud_coverforecastedIntegerForcasted cloud cover of a game in percentage
conditionforecastedStringForecasted weather condition of a game
dew_point_fforecastedIntegerForecasted dew point number of a game
humidityforecastedIntegerForecasted humidity number of a game
obs_timeforecasteddateTimeTimestamp of the forecasted weather observation
ex. 2020-02-24T20:24:34.000Z
current_temperature_fforecastedIntegerForecasted temperature of a game in Fahrenheit
directionwindStringForecasted direction of wind in a game
speed_mphwindIntegerForecasted wind speed in a game in miles per hour
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
Language
Authorization
Query
Click Try It! to start a request and see the response here!