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:

Attribute

Parent Element

Type

Description

attendance

game

Integer

Attendance of a game

abbr

away

String

Abbreviation of the away team
ex. MIN (Minnesota)

abbr

home

String

Abbreviation of the home team
ex. CIN (Cincinnati)

date

daily-boxscore

Date

Date of the daily boxscore
ex. 2022-07-05

duration

game

String

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

errors

away

Integer

Number of errors for the away team

errors

home

Integer

Number of errors for the home team

errors

away - scoring - inning

String

Number of errors while the away team was batting in an inning

Value will be X when an inning is unplayed

errors

home - scoring - inning

String

Number of errors while the home team was batting in an inning

Value will be X when an inning is unplayed

hits

away

Integer

Number of hits for the away team

hits

home

Integer

Number of hits for the home team

hits

away - scoring - inning

String

Number of hits for the away team in an inning

Value will be X when an inning is unplayed

hits

home - scoring - inning

String

Number of hits for the home team in an inning

Value will be X when an inning is unplayed

id

away

GUID

Unique ID of the away team
ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b

id

home

GUID

Unique ID of the home team
ex. 481dfe7e-5dab-46ab-a49f-9dcc2b6e2cfd

loss

away

Integer

Number of losses for the away team

loss

home

Integer

Number of losses for the home team

market

away

String

Market name of the away team
ex. Colorado

market

home

String

Market name of the home team
ex. Minnesota

name

away

String

Team name of the away team
ex. Rockies

name

home

String

Team name of the home team
ex. Twins

runs

away

Integer

Number of runs for the away team in the game

runs

home

Integer

Number of runs for the home team in the game

runs

away - scoring - inning

String

Number of runs for the away team in an inning

Value will be X when an inning is unplayed

runs

home - scoring - inning

String

Number of runs for the home team in an inning

Value will be X when an inning is unplayed

win

away

Integer

Number of wins for the away team

win

home

Integer

Number of wins for the home team

current_inning_half

outcome

String

The current inning half as top or bottom
T , B

current_inning

outcome

Integer

The current inning number

inning_half

final

String

Indicates the final inning half as top or bottom
T , B

inning

final

Integer

Indicates 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:

Attribute

Parent Element

Type

Description

first_name

outcome - pitcher

String

First name of the current pitcher
ex. Clayton

full_name

outcome - pitcher

String

Full name of the current pitcher
ex. Clayton Kershaw

suffix

outcome - pitcher

String

Name suffix of the current pitcher
ex. Jr.

id

outcome - pitcher

GUID

Unique player ID of the current pitcher
ex. ea1a2111-44cc-4996-babb-9439465e6760

jersey_number

outcome - pitcher

Integer

Number of the current pitcher's jersey

last_name

outcome - pitcher

String

Last name of the current pitcher
ex. Kershaw

pitch_speed

outcome - pitcher

String

Speed of a pitch in MPH
ex. 92.0

pitch_type

outcome - pitcher

String

Code 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_zone

outcome - pitcher

Integer

Number corresponding to the pitch strike zone (1-13)
See our FAQ for more detail and a graphic representation

preferred_name

outcome - pitcher

String

Preferred name of the current pitcher
ex. Clayton

era

away - current_pitcher

String

ERA of the current away team pitcher
ex. 5.952

Note: -- indicates an infinite ERA

first_name

away - current_pitcher

String

First name of the current away team pitcher
ex. Bryse

full_name

away - current_pitcher

String

Full name of the current away team pitcher
ex. Bryse Wilson

suffix

away - current_pitcher

String

Name suffix of the current away team pitcher
ex. Jr.

id

away - current_pitcher

GUID

Unique ID of the current away team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02

jersey_number

away - current_pitcher

Integer

Number of the current away team pitcher's jersey

last_name

away - current_pitcher

String

Last name of the current away team pitcher
ex. Wilson

loss

away - current_pitcher

Integer

Number of losses for the current away team pitcher

preferred_name

away - current_pitcher

String

Preferred name of the current away team pitcher
ex. Bryce

win

away - current_pitcher

Integer

Number of wins for the current away team pitcher

era

home - current_pitcher

String

ERA of the current home team pitcher
ex. 5.952

Note: -- indicates an infinite ERA

first_name

home - current_pitcher

String

First name of the current home team pitcher
ex. Bryse

full_name

home - current_pitcher

String

Full name of the current home team pitcher
ex. Bryse Wilson

suffix

home - current_pitcher

String

Name suffix of the current home team pitcher
ex. Jr.

id

home - current_pitcher

GUID

Unique ID of the current home team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02

jersey_number

home - current_pitcher

Integer

Number of the current home team pitcher's jersey

last_name

home - current_pitcher

String

Last name of the current home team pitcher
ex. Wilson

loss

home - current_pitcher

Integer

Number of losses for the current home team pitcher

preferred_name

home - current_pitcher

String

Preferred name of the current home team pitcher
ex. Bryce

win

home - current_pitcher

Integer

Number of wins for the current home team pitcher

Probable Pitcher:

Attribute

Parent Element

Type

Description

era

away - probable_pitcher

String

ERA of the probable away team pitcher
ex. 5.952

Note: -- indicates an infinite ERA

first_name

away - probable_pitcher

String

First name of the probable away team pitcher
ex. Bryse

full_name

away - probable_pitcher

String

Full name of the probable away team pitcher
ex. Bryse Wilson

suffix

away - probable_pitcher

String

Name suffix of the probable away team pitcher
ex. Jr.

id

away - probable_pitcher

GUID

Unique ID of the probable away team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02

jersey_number

away - probable_pitcher

Integer

Number of the probable away team pitcher's jersey

last_name

away - probable_pitcher

String

Last name of the probable away team pitcher
ex. Wilson

loss

away - probable_pitcher

Integer

Number of losses for the probable away team pitcher

preferred_name

away - probable_pitcher

String

Preferred name of the probable away team pitcher
ex. Bryce

win

away - probable_pitcher

Integer

Number of wins for the probable away team pitcher

era

home - probable_pitcher

String

ERA of the probable home team pitcher
ex. 5.952

Note: -- indicates an infinite ERA

first_name

home - probable_pitcher

String

First name of the probable home team pitcher
ex. Luis

full_name

home - probable_pitcher

String

Full name of the probable home team pitcher
ex. Luis Cessa

suffix

home - probable_pitcher

String

Name suffix of the probable home team pitcher
ex. Jr.

id

home - probable_pitcher

GUID

Unique ID of the probable home team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02

jersey_number

home - probable_pitcher

Integer

Number of the probable home team pitcher's jersey

last_name

home - probable_pitcher

String

Last name of the probable home team pitcher
ex. Cessa

loss

home - probable_pitcher

Integer

Number of losses for the probable home team pitcher

preferred_name

home - probable_pitcher

String

Preferred name of the probable home team pitcher
ex. Luis

win

home - probable_pitcher

Integer

Number of wins for the probable home team pitcher

Starting Pitcher:

Attribute

Parent Element

Type

Description

era

away - starting_pitcher

String

ERA of the starting away team pitcher
ex. 5.952

Note: -- indicates an infinite ERA

first_name

away - starting_pitcher

String

First name of the starting away team pitcher
ex. Bryse

full_name

away - starting_pitcher

String

Full name of the starting away team pitcher
ex. Bryse Wilson

suffix

away - starting_pitcher

String

Name suffix of the starting away team pitcher
ex. Jr.

id

away - starting_pitcher

GUID

Unique ID of the starting away team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02

jersey_number

away - starting_pitcher

Integer

Number of the starting away team pitcher's jersey

last_name

away - starting_pitcher

String

Last name of the starting away team pitcher
ex. Wilson

loss

away - starting_pitcher

Integer

Number of losses for the starting away team pitcher

preferred_name

away - starting_pitcher

String

Preferred name of the starting away team pitcher
ex. Bryce

win

away - starting_pitcher

Integer

Number of wins for the starting away team pitcher

era

home - starting_pitcher

String

ERA of the starting home team pitcher
ex. 5.952

Note: -- indicates an infinite ERA

first_name

home - starting_pitcher

String

First name of the starting home team pitcher
ex. Bryse

full_name

home - starting_pitcher

String

Full name of the starting home team pitcher
ex. Bryse Wilson

suffix

home - starting_pitcher

String

Name suffix of the starting home team pitcher
ex. Jr.

id

home - starting_pitcher

GUID

Unique ID of the starting home team pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02

jersey_number

home - starting_pitcher

Integer

Number of the starting home team pitcher's jersey

last_name

home - starting_pitcher

String

Last name of the starting home team pitcher
ex. Wilson

loss

home - starting_pitcher

Integer

Number of losses for the starting home team pitcher

preferred_name

home - starting_pitcher

String

Preferred name of the starting home team pitcher
ex. Bryce

win

home - starting_pitcher

Integer

Number of wins for the starting home team pitcher

Pitcher Outcomes:

Pitcher outcomes are available after the conclusion of a game under the pitching element. Outcomes are available for pitchers recording a win, loss, hold, save, or blow_save.

Attribute

Parent Element

Type

Description

first_name

player

String

First name of the pitcher
ex. Bryse

full_name

player

String

First name of the pitcher
ex. Bryse Wilson

suffix

player

String

Name suffix of the pitcher
ex. Jr.

id

player

GUID

Unique ID of the pitcher
ex. afebcbd0-fe00-4d21-99c5-6cee7e5eea02

jersey_number

player

Integer

Number of the pitcher's jersey

last_name

player

String

Last name of the pitcher
ex. Wilson

position

player

String

Position of a player
C (Catcher), IF (Infield), OF (Outfield), P (Pitcher), DH (Designated Hitter)

preferred_name

player

String

Preferred name of the pitcher
ex. Bryce

primary_position

player

String

Primary position of a player
C (Catcher), 1B (First Base), 2B (Second Base), 3B (Third Base), SS (Shortstop), LF (Left Field), CF (Centerfield), P (Pitcher), RF (Right Field), RP (Relief Pitcher), SP (Starting Pitcher), DH (Designated Hitter)

status

player

String

Status 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_save

player

Integer

Current 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

hold

player

Integer

Current number of seasonal holds for a pitcher. Player will appear within the hold element if he recorded a hold in this game

loss

player

Integer

Current number of seasonal losses for a pitcher. Player will appear within the loss element if he recorded a loss in this game

save

player

Integer

Current number of seasonal saves for a pitcher. Player will appear within the save element if he recorded a save in this game

win

player

Integer

Current 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
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
Broadcast:
AttributeParent ElementTypeDescription
channelbroadcasts - broadcastStringName of a game's broadcast channel
ex. 213
localebroadcasts - broadcastStringSignifies the locale of a broadcast
ex. Home, Away, National
networkbroadcasts - broadcastStringName of a game's broadcast network
ex. MLB Network, NBCS-BA, ESPN
typebroadcasts - broadcastStringType of broadcast
ex. TV, Internet
Weather:

Attribute

Parent Element

Type

Description

cloud_cover

current_conditions

Integer

Current cloud cover of a game in percentage

condition

current_conditions

String

Current weather condition for a game
ex. Partly cloudy, Clear, Light Rain, Mist

Click here for more info on weather condition values

dew_point_f

current_conditions

Integer

Current dew point number of a game

humidity

current_conditions

Integer

Current humidity number of a game

obs_time

current_conditions

dateTime

Timestamp of the current weather observation
ex. 2020-02-24T20:24:34.000Z

current_temperature_f

current_conditions

Integer

Current temperature of a game in Fahrenheit

direction

wind

String

Direction of wind in a game

speed_mph

wind

Integer

Wind speed in the game in miles per hour

cloud_cover

forecasted

Integer

Forecasted cloud cover of a game in percentage

condition

forecasted

String

Forecasted weather condition for a game
ex. Partly cloudy, Clear, Light Rain, Mist

Click here for more info on weather condition values

dew_point_f

forecasted

Integer

Forecasted dew point number of a game

humidity

forecasted

Integer

Forecasted humidity number of a game

obs_time

forecasted

dateTime

Timestamp of the forecasted weather observation
ex. 2020-02-24T20:24:34.000Z

current_temperature_f

forecasted

Integer

Forecasted temperature of a game in Fahrenheit

direction

wind

String

Forecasted direction of wind in a game

speed_mph

wind

Integer

Forecasted 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
Credentials
Header
Click Try It! to start a request and see the response here!