⏱️
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

Data Points

Boxscore

Attribute	Parent Element	Type	Description
`abbr`	`away`	String	Abbreviation of the away team ex. `MIN` (Minnesota)
`abbr`	`home`	String	Abbreviation of the home team ex. `CIN` (Cincinnati)
`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`
`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`

Game

Attribute	Parent Element	Type	Description
`away_team`	`game`	GUID	Unique ID of the away team ex. `29dd9a87-5bcc-4774-80c3-7f50d985068b`
`coverage`	`game`	String	Coverage level of a game `full`, `boxscore`
`double_header`	`game`	Boolean	Signifies whether a game is part of a double header
`day_night`	`game`	String	Signifies a day or night game `D`, `N`
`entry_mode`	`game`	String	Signifies the type of data entry `STOMP`, `LDE`
`gameday_type`	`game`	String	Coverage 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_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`
`is_game_pool`	`game`	Boolean	Signifies 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_bracket`	`game`	Boolean	Signifies a World Baseball Classic game (WBC) is part of the elimination bracket when `true`. See our FAQ for further details on the WBC.
`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`
`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), `WBC` (World Baseball Classic)
`season_year`	`game`	Integer	Year of the season a game belongs within
`tbd`	`game`	Boolean	Signifies the game start time is to be determined. Placeholder start time is `08:00:00+00:00`
`split_squad`	`game`	Boolean	Signifies a Spring Training split squad game
`status`	`game`	String	The 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`

Broadcast

Attribute	Parent Element	Type	Description
`channel`	`broadcasts` - `broadcast`	String	Name of a game's broadcast channel ex. `213`
`locale`	`broadcasts` - `broadcast`	String	Signifies the locale of a broadcast ex. `Home`, `Away`, `National`
`network`	`broadcasts` - `broadcast`	String	Name of a game's broadcast network ex. `MLB Network`, `NBCS-BA`, `ESPN`
`type`	`broadcasts` - `broadcast`	String	Type of broadcast ex. `TV`, `Internet`

Mound Visits & Reviews

Attribute	Parent Element	Type	Description
`remaining`	`mound_visits` - `home`	Integer	Number of mound visits remaining for the home team
`used`	`mound_visits` - `home`	Integer	Number of used mound visits for the home team
`remaining`	`mound_visits` - `away`	Integer	Number of mound visits remaining for the away team
`used`	`mound_visits` - `away`	Integer	Number of used mound visits for the away team
`remaining`	`reviews` - `home`	Integer	Number of remaining reviews for the home team
`used`	`reviews` - `home`	Integer	Number of used reviews for the home team
`remaining`	`reviews` - `away`	Integer	Number of remaining reviews for the away team
`used`	`reviews` - `away`	Integer	Number of used reviews for the away team

Player

Attribute	Parent Element	Type	Description
`first_name`	`player`	String	First name of a player ex. `Markus`
`full_name`	`player`	String	Full name of a player ex. `Mookie Betts`
`suffix`	`player`	String	Name suffix of a player ex. `Jr.`
`id`	`player`	GUID	Unique ID of a player ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`jersey_number`	`player`	Integer	Number of a player's jersey
`last_name`	`player`	String	Last name of a runner ex. `Betts`
`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 a player ex. `Mookie`
`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), `D15` (15-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

Player Pitching Stats (Game)

Attribute	Parent Element	Type	Description
`d`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `onbase`	Integer	Number of doubles allowed
`foul`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `outcome`	Integer	Number of foul balls
`h`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `onbase`	Integer	Number of hits allowed
`hr`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `onbase`	Integer	Number of homeruns allowed
`flyball`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `in-play`	Integer	Number of fly balls allowed
`groundball`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `in-play`	Integer	Number of ground balls allowed
`linedrive`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `in-play`	Integer	Number of line drives allowed
`popups`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `in-play`	Integer	Number of popups allowed
`s`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `onbase`	Integer	Number of singles allowed
`klook`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `outs`	Integer	Number of strikeouts looking
`kswing`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `outs`	Integer	Number of strikeouts swinging
`klook`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `outcome`	Integer	Number of strikes looking
`kswing`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `outcome`	Integer	Number of strikes swinging
`btotal`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `outcome`	Integer	Total number of balls thrown
`ktotal`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `outs`	Integer	Total number of strikeouts
`ktotal`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `outcome`	Integer	Total number of strikes thrown
`t`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `onbase`	Integer	Number of triples allowed
`swing_rate`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `swings`	Decimal	Swing rate percentage ex. `60.5`
`strike_pct`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `swings`	Decimal	Strike percentage ex. `24.4`
`total`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `swings`	Integer	Number of swings induced
`whiff_rate`	`player` - `statistics` - `pitch_metrics` - `overall` / `pitch_types` - `swings`	Decimal	Swing and miss percentage ex. `40.4`
`avg_speed`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `pitch_type`	Decimal	Average speed of a type of pitch
`avg_speed`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `overall`	Decimal	Average speed of all pitches
`count`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `pitch_type`	Integer	Number of pitches thrown for a type of pitch
`count`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `overall`	Integer	Number of pitches thrown
`gbfb`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `pitch_type`	Decimal	Opponents ground ball/fly ball ratio for a type of pitch ex. `2.5`
`gbfb`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `overall`	Decimal	Opponents ground ball/fly ball ratio ex. `2.5`
`max_speed`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `pitch_type`	Decimal	Maximum speed of a type of pitch ex. `98.5`
`max_speed`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `overall`	Decimal	Maximum speed of pitches thrown ex. `92.5`
`min_speed`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `pitch_type`	Decimal	Minimum speed of a type of pitch ex. `82.9`
`min_speed`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `overall`	Decimal	Minimum speed of pitches thrown ex. `76.9`
`type`	`player` - `statistics` - `pitch_metrics` - `pitch_types` - `pitch_type`	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`

Series

Attribute	Parent Element	Type	Description
`ps_game`	`game`	Integer	Game number in a series
`ps_round`	`game`	String	Name of a series ex. `ALDS`

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`

200200