get https://api.sportradar.com/mlb//v7//games//boxscore.
MLB Game Boxscore provides inning-by-inning scoring breakdown, hits and errors by team, win/loss results, as well as details on run-scoring events for a given game.
Update Frequency
TTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Data Updates: Realtime
Data Points
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) |
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 - inning | Integer | Number of errors for the away team in an inning |
hits | away | Integer | Number of hits for the away team |
hits | home | Integer | Number of hits for the home team |
hits | away - inning | Integer | Number of hits for the away team in an inning |
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 - inning | Integer | Number of runs for the away team in an inning |
runs | home - inning | Integer | Number of runs for the home team in an inning |
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 bottomT,B |
current_inning | outcome | Integer | The current inning number |
type | outcome | String | The outcome of the last eventpitch, steal, lineup, half_start, half_over, event_start, event_over |
inning_half | final | String | Indicates the final inning half as top or bottomT,B |
inning | final | Integer | Indicates the final inning number |
Count:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
balls | outcome - count | Integer | Number of balls for the current at bat |
inning_half | outcome - count | String | Indicates top or bottom inning halfT,B |
half_over | outcome - count | Boolean | Indicates an inning half has ended |
inning | outcome - count | Integer | Number of the current inning |
outs | outcome - count | Integer | Number of outs |
strikes | outcome - count | Integer | Number of strikes for the current at bat |
Current Baserunners:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
description | - | String | Text description of a runner outcome ex. Will Smith to third. or Freddie Freeman scores. |
ending_base | outcome - runner | Integer | Runner's base at the end of a play |
first_name | outcome - runner | String | First name of the current runner ex. Markus |
full_name | outcome - runner | String | Full name of the current runner ex. Mookie Betts |
suffix | outcome - runner | String | Name suffix of the current runner ex. Jr. |
id | outcome - runner | GUID | Unique player ID of the current runner ex. ea1a2111-44cc-4996-babb-9439465e6760 |
jersey_number | outcome - runner | Integer | Number of the current runner's jersey |
last_name | outcome - runner | String | Last name of the current runner ex. Betts |
out | outcome - runner | Boolean | Signifies the runner was out on a play |
outcome_id | outcome - runner | String | ID of a runner outcome on a play. Check our FAQ for a list of valid outcomes and their definitions |
preferred_name | outcome - runner | String | Preferred name of the current runner ex. Mookie |
starting_base | outcome - runner | Integer | Runner's base at the start of a play |
Current Hitter:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
ab_over | outcome - hitter | Boolean | Indicates an at bat is over |
first_name | outcome - hitter | String | First name of the current hitter ex. Markus |
full_name | outcome - hitter | String | Full name of the current hitter ex. Mookie Betts |
suffix | outcome - hitter | String | Name suffix of the current hitter ex. Jr. |
id | outcome - hitter | GUID | Unique player ID of the current hitter ex. ea1a2111-44cc-4996-babb-9439465e6760 |
jersey_number | outcome - hitter | Integer | Number of the current hitter's jersey |
last_name | outcome - hitter | String | Last name of the current hitter ex. Betts |
out | outcome - hitter | Boolean | Signifies the hitter was out on a play |
outcome_id | outcome - hitter | String | ID of a hitter outcome on a play. Check our FAQ for a list of valid outcomes and their definitions |
preferred_name | outcome - hitter | String | Preferred 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 pitchFA(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 |
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 |
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 |
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 |
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 |
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 |
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:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
first_name | player | String | First name of the pitcher ex. Bryse |
full_name | player | String | Full 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 playerC(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 playerC(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) |
status | player | String | Status of a playerA(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),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:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
errors | scoring - inning | String | Number of errors in an inning for the home or away team |
hits | scoring - inning | String | Number of hits in an inning for the home or away team |
number | scoring - inning | Integer | Number of an inning |
sequence | scoring - inning | Integer | Sequential number of an inning |
runs | scoring - inning | String | Number of runs in an inning for the home or away team |
Runs Scored:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
type | runs - run | Integer | Type of action preceding a run scoring play ex. pitch |
hitter_id | runs - run | GUID | Unique player ID of a hitter for a run scoring play ex. ea1a2111-44cc-4996-babb-9439465e6760 |
hitter_outcome | runs - run | String | ID of a hit outcome on a play. Check our FAQ for a list of valid outcomes and their definitions |
inning | runs - run | Integer | Number of inning with a scoring play |
inning_half | runs - run | Integer | Number of inning half with a scoring play |
pitcher_id | runs - run | GUID | Unique player ID of a pitcher for a run scoring play ex. ea1a2111-44cc-4996-babb-9439465e6760 |
first_name | runs - run - runner | String | First name of the scoring runner ex. Markus |
full_name | runs - run - runner | String | Full name of the scoring runner ex. Mookie Betts |
suffix | runs - run - runner | String | Name suffix of the scoring runner ex. Jr. |
jersey_number | runs - run - runner | Integer | Number of the scoring runner's jersey |
last_name | runs - run - runner | String | Last name of the scoring runner ex. Betts |
preferred_name | runs - run - runner | String | Preferred name of the scoring runner ex. Mookie |
id | runs - run | GUID | Unique ID of a run scoring play ex. f75b7565-b2ca-4bb3-985b-f4637fed2e0b |
id | runs - run - runner | GUID | Unique ID of a runner for a run scoring play ex. f75b7565-b2ca-4bb3-985b-f4637fed2e0b |
starting_base | runs - run - runner | Integer | Runner's base at the start of a run scoring play |
Game:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
away_team | game | GUID | Unique ID of the away team ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b |
cable | broadcast | String | Name of the game's broadcast cable station |
internet | broadcast | String | Name of the game's internet stream |
network | broadcast | String | Name of the game's broadcast network ex. MLB Network |
radio | broadcast | String | Name of the game's broadcast radio station |
satellite | broadcast | String | Name of the game's broadcast satellite station |
coverage | game | String | Coverage level of a gamefull,boxscore |
double_header | game | Boolean | Signifies whether a game is part of a double header |
day_night | game | String | Signifies a day or night gameD,N |
entry_mode | game | String | Signifies the type of data entrySTOMP,LDE |
home_team | game | GUID | Unique ID of the home team ex. ef64da7f-cfaf-4300-87b0-9313386b977c |
id | game | GUID | Unique ID of the game ex. 1b554f5e-d8b7-4268-95da-2f4191015c84 |
game_number | game | Integer | Number of the game |
parent_id | game | GUID | Standard 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) |
reference | game | String | Unique MLBAM ID of a game |
scheduled | game | dateTime | Scheduled date and time of a game ex. 2022-09-25T20:10:00+00:00 |
tbd | game | Boolean | Signifies the game start time is to be determined. Placeholder start time is 08:00:00+00:00 |
season_id | game | GUID | Unique ID of the season a game belongs within ex. 6a5c278f-ebce-41f9-b1ba-2160b6af04ce |
season_type | game | String | Code type of the season a game belongs within ex. REG (Regular), PRE (Preseason), PST (Postseason), AST (All-Star) |
season_year | game | Integer | Year of the season a game belongs within |
split_squad | game | Boolean | Signifies a Spring Training split squad game |
status | game | String | The status of a gamescheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance |
away | game - time_zones | String | Time zone of the away team ex. US/Pacific |
home | game - time_zones | String | Time zone of the home team ex. US/Eastern |
venue | game - time_zones | String | Time zone of the venue ex. US/Eastern |
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 of a game |
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 the game |
speed_mph | wind | Integer | Wind speed in the game in miles per hour |
cloud_cover | forecasted | Integer | Forcasted cloud cover of a game in percentage |
condition | forecasted | String | Forecasted weather condition of a game |
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 the game |
speed_mph | wind | Integer | Forecasted wind speed in a game in miles per hour |
Venue:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
address | venue | String | Address of a venue ex. 1000 Vin Scully Avenue |
capacity | venue | String | Capacity of a venue ex. 56000 |
city | venue | String | City of a venue ex. Los Angeles |
country | venue | String | Country of a venue ex. USA |
field_orientation | venue | String | Field orientation of a venue ex. NE |
id | venue | GUID | Unique ID of a venue ex. 66a19c3d-24fe-477d-bee7-c6ef1b98352f |
lat | location | Decimal | Latitude of a venue ex. 34.0745409 |
lng | location | Decimal | Longitude of a venue ex. -118.2408881 |
market | venue | String | Market of a venue ex. Los Angeles |
name | venue | String | Name of a venue ex. Dodger Stadium |
stadium_type | venue | String | Type of a venue ex. outdoor |
state | venue | String | State of a venue ex. CA |
surface | venue | String | Surface type of a venue ex. grass |
time_zone | venue | String | Time zone of a venue ex. US/Central |
zip | venue | Integer | ZIP code of a venue ex. 90012 |