⏱️
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
`attendance`	`game`	Integer	Attendance of a game
`abbr`	`away`	String	Abbreviation of the away team ex. `MIN` (Minnesota)
`duration`	`game`	String	Duration of a game in hours and minutes ex. `3:18`
`delay_duration`	`game`	String	Duration of a game delay in hours and minutes ex. `0:18`
`errors`	`scoring` - `away`	Integer	Number of errors for the away team
`errors`	`inning` - `scoring` - `away`	String	Number of errors while the away team was batting in an inning Value will be `X` when an inning is unplayed
`hits`	`scoring` - `away`	Integer	Number of hits for the away team
`hits`	`inning` - `scoring` - `away`	String	Number of hits for the away team in an inning Value will be `X` when an inning is unplayed
`id`	`scoring` - `away`	GUID	Unique ID of the away team ex. `29dd9a87-5bcc-4774-80c3-7f50d985068b`
`market`	`scoring` - `away`	String	Market name of the away team ex. `Colorado`
`name`	`scoring` - `away`	String	Team name of the away team ex. `Rockies`
`runs`	`scoring` - `away`	Integer	Number of runs for the away team in the game
`runs`	`inning` - `scoring` - `away`	String	Number of runs for the away team in an inning Value will be `X` when an inning is unplayed
`abbr`	`scoring` - `home`	String	Abbreviation of the home team ex. `CLE` (Cleveland)
`errors`	`scoring` - `home`	Integer	Number of errors for the home team
`errors`	`inning` - `scoring` - `home`	String	Number of errors while the home team was batting in an inning Value will be `X` when an inning is unplayed
`hits`	`scoring` - `home`	Integer	Number of hits for the home team
`hits`	`inning` - `scoring` - `home`	String	Number of hits for the home team in an inning Value will be `X` when an inning is unplayed
`id`	`scoring` - `home`	GUID	Unique ID of the home team ex. `29dd9a87-5bcc-4774-80c3-7f50d985068b`
`market`	`scoring` - `home`	String	Market name of the home team ex. `Cleveland`
`name`	`scoring` - `home`	String	Team name of the home team ex. `Guardians`
`runs`	`scoring` - `home`	Integer	Number of runs for the home team in the game
`runs`	`inning` - `scoring` - `home`	String	Number of runs for the home team in an inning Value will be `X` when an inning is unplayed
`loss`	`away`	Integer	Number of away team losses year-to-date. Team win-loss data updates after a game moves to `complete` status.
`loss`	`home`	Integer	Number of home team losses year-to-date. Team win-loss data updates after a game moves to `complete` status.
`win`	`away`	Integer	Number of away team wins year-to-date. Team win-loss data updates after a game moves to `complete` status.
`win`	`home`	Integer	Number of home team wins year-to-date. Team win-loss data updates after a game moves to `complete` status.

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`
`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), `WBC` (World Baseball Classic)
`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 game. See our FAQ for all statuses and their definitions. `scheduled`, `inprogress`, `complete`, `closed`, `wdelay`, `fdelay`, `odelay`, `canceled`, `unnecessary`, `if-necessary`, `postponed`, `suspended`, `maintenance`
`id`	`event`	GUID	Unique ID of a deleted event ex. `5e3a0b5d-72fa-40e5-8f9d-a10e6a46a831`
`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`

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

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 the 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 the game
`speed_mph`	`wind`	Integer	Forecasted wind speed in a game in miles per hour

Lineup

Attribute	Parent Element	Type	Description
`order`	`lineup`	Integer	Batting order number in the lineup for a player (0-9). `0` is used for the pitcher
`description`	`lineup`	String	Text description of a lineup change ex. `Albert Pujols pinch-hitting for Corey Dickerson.`
`position`	`lineup`	Integer	Position number for a player (1-10). `10` is used for the designated hitter
`id`	`lineup`	GUID	Unique ID of a lineup entry ex. `616d0907-26f1-4adf-875f-c0928d6d1b22`
`first_name`	`lineup`	String	First name of a player ex. `Markus`
`full_name`	`lineup`	String	Full name of a player ex. `Mookie Betts`
`suffix`	`lineup`	String	Name suffix of a player ex. `Jr.`
`player_id`	`lineup`	GUID	Unique ID of a player ex. `084d2514-9ffb-414e-ae16-3bc690aaad51`
`jersey_number`	`lineup`	Integer	Number of a player's jersey
`last_name`	`lineup`	String	Last name of a player ex. `Betts`
`preferred_name`	`lineup`	String	Preferred name of a player ex. `Mookie`
`team_id`	`lineup`	GUID	Unique ID of a player's team ex. `ef64da7f-cfaf-4300-87b0-9313386b977c`

Play-By-Play - At Bat

Attribute	Parent Element	Type	Description
`first_name`	`hitter`	String	First name of a hitter ex. `Markus`
`full_name`	`hitter`	String	Full name of a hitter ex. `Mookie Betts`
`suffix`	`hitter`	String	Name suffix of a hitter ex. `Jr.`
`hitter_hand`	`at_bat`	String	Handedness of a hitter
`hitter_id`	`at_bat`	GUID	Unique ID of a hitter ex. `084d2514-9ffb-414e-ae16-3bc690aaad51`
`jersey_number`	`hitter`	Integer	Number of a hitter's jersey
`last_name`	`hitter`	String	Last name of a hitter ex. `Betts`
`preferred_name`	`hitter`	String	Preferred name of a player ex. `Mookie`
`id`	`at_bat`	GUID	Unique ID of an at bat entry ex. `c1e69331-8909-4f1c-b132-5b33079355b4`
`first_name`	`pitcher`	String	First name of a pitcher ex. `Adam`
`full_name`	`pitcher`	String	Full name of a pitcher ex. `Adam Wainwright`
`suffix`	`pitcher`	String	Name suffix of a pitcher ex. `Jr.`
`pitcher_hand`	`at_bat`	String	Handedness of a pitcher
`pitcher_id`	`at_bat`	GUID	Unique ID of a pitcher ex. `084d2514-9ffb-414e-ae16-3bc690aaad51`
`jersey_number`	`pitcher`	Integer	Number of a pitcher's jersey
`last_name`	`pitcher`	String	Last name of a pitcher ex. `Wainwright`
`preferred_name`	`pitcher`	String	Preferred name of a pitcher ex. `Adam`
`description`	-	String	Text description of a play ex. `Will Smith singles to center field. Freddie Freeman to third.`
`sequence_number`	`at_bat`	Integer	Sequence number of an event within a game

Play-By-Play - Base Runner

Attribute	Parent Element	Type	Description
`ending_base`	`runner`	Integer	Runner's base at the end of a play
`first_name`	`runner`	String	First name of a runner ex. `Markus`
`full_name`	`runner`	String	Full name of a runner ex. `Mookie Betts`
`suffix`	`runner`	String	Name suffix of a runner ex. `Jr.`
`jersey_number`	`runner`	Integer	Number of a runner's jersey
`last_name`	`runner`	String	Last name of a runner ex. `Betts`
`out`	`runner`	Boolean	Signifies the runner was out on a play
`outcome_id`	`runner`	String	ID of a runner outcome on a play. Check our FAQ for a list of valid outcomes and their definitions
`description`	-	String	Text description of a runner outcome ex. `Will Smith to third.` or `Freddie Freeman scores.`
`id`	`runner`	GUID	Unique ID of a player of a runner ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`preferred_name`	`runner`	String	Preferred name of a runner ex. `Mookie`
`starting_base`	`runner`	Integer	Runner's base at the start of a play
`created_at`	`runner_placed`	dateTime	Timestamp of a runner placed at 2nd base to start an inning ex. `2022-09-25T20:10:00+00:00`
`id`	`runner_placed`	GUID	Unique ID of a runner placed at 2nd base to start an inning
`official`	`runner_placed`	Boolean	Signifies whether the API is ingesting data directly from the league at the time of the event. For `true`, `entry_mode`=`Ingest`. For `false`, `entry_mode`=`LDE`.
`sequence_number`	`runner_placed`	Integer	Sequential number of a runner placed event in a game
`status`	`runner_placed`	String	Status of a runner placed event. Can be utilized to determine if a play is or was under review `official`, `overturned`, `under review`, `upheld`
`updated_at`	`runner_placed`	dateTime	Timestamp of a runner placed event update ex. `2022-09-25T20:25:14+00:00`

Play-By-Play - Hitter

Attribute	Parent Element	Type	Description
`first_name`	`hitter`	String	First name of a hitter ex. `Markus`
`full_name`	`hitter`	String	Full name of a hitter ex. `Mookie Betts`
`suffix`	`hitter`	String	Name suffix of a hitter ex. `Jr.`
`hitter_hand`	`pitcher`	String	Handedness of a hitter
`id`	`hitter`	GUID	Unique ID of a player of a hitter ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`jersey_number`	`hitter`	Integer	Number of a hitter's jersey
`last_name`	`hitter`	String	Last name of a hitter ex. `Betts`
`preferred_name`	`hitter`	String	Preferred name of a hitter ex. `Mookie`

Play-By-Play - Count

Attribute	Parent Element	Type	Description
`balls`	`count`	Integer	Number of balls in an at bat
`outs`	`count`	Integer	Number of outs in an at bat
`pitch_count`	`count`	Integer	Number of pitches in an at bat
`strikes`	`count`	Integer	Number of strikes in an at bat

Play-By-Play - Errors

Attribute	Parent Element	Type	Description
`first_name`	`error`	String	First name of a player committing an error ex. `Gavin`
`full_name`	`error`	String	Full name of a player committing an error ex. `Gavin Lux`
`suffix`	`error`	String	Name suffix of a player committing an error ex. `Jr.`
`id`	`error`	GUID	Unique ID of a player of a player committing an error ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`jersey_number`	`error`	Integer	Jersey number a player committing an error
`last_name`	`error`	String	Last name of a player committing an error ex. `Lux`
`preferred_name`	`error`	String	Preferred name of a player committing an error ex. `Gavin`
`type`	`error`	String	Type of fielding error `fielding`, `throwing`, `interference`

Play-By-Play - Fielding

Attribute	Parent Element	Type	Description
`first_name`	`assist`	String	First name of a player recording an assist ex. `Gavin`
`full_name`	`assist`	String	Full name of a player recording an assist ex. `Gavin Lux`
`suffix`	`assist`	String	Name suffix of a player recording an assist ex. `Jr.`
`id`	`assist`	GUID	Unique ID of a player of a player recording an assist ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`jersey_number`	`assist`	Integer	Jersey number a player recording an assist
`last_name`	`assist`	String	Last name of a player recording an assist ex. `Lux`
`preferred_name`	`assist`	String	Preferred name of a player recording an assist ex. `Gavin`
`sequence`	`assist`	Integer	Sequential number of an assist
`first_name`	`putout`	String	First name of a player recording a putout ex. `Byron`
`full_name`	`putout`	String	Full name of a player recording a putout ex. `Byron Buxton`
`suffix`	`putout`	String	Name suffix of a player recording a putout ex. `Jr.`
`id`	`putout`	GUID	Unique ID of a player of a player recording a putout ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`jersey_number`	`putout`	Integer	Jersey number a player recording a putout
`last_name`	`putout`	String	Last name of a player recording a putout ex. `Buxton`
`preferred_name`	`putout`	String	Preferred name of a player recording a putout ex. `Gavin`
`sequence`	`putout`	Integer	Sequential number of a putout

Play-By-Play - Hit Data

Please note that attributes within mlb_hit_data may not be present for every event

Attribute	Parent Element	Type	Description
`coord_x`	`coordinates`	Decimal	X coordinate marked by operator of where the ball was fielded
`coord_y`	`coordinates`	Decimal	Y coordinate marked by operator of where the ball was fielded
`hardness`	`mlb_hit_data`	String	Amount of hard contact on a hit `soft`, `medium`, `hard`
`launch_angle`	`mlb_hit_data`	Decimal	Vertical angle relative to the horizon at which a hit was launched Available with Statcast only
`launch_speed`	`mlb_hit_data`	Decimal	Measured speed of a hit ball Available with Statcast only
`location`	`mlb_hit_data`	Integer	Positional number (1-9) of the player nearest to a hit ball location. Please see our FAQ for fielding position numbers and definitions Available with Statcast only Note: `78` and `89` are valid integers for left-center home runs (78) and right-center home runs (89)
`total_distance`	`mlb_hit_data`	Integer	Total distance a hit ball traveled (in feet) Available with Statcast only
`trajectory`	`mlb_hit_data`	String	Trajectory of a batted ball into the field of play `bunt_grounder`, `bunt_line_drive`, `bunt_popup`, `fly_ball`, `ground_ball`, `line_drive`, `popup`
`hit_location`	`pitch`	Integer	Number code of hit ball location (1-35). Please see our FAQ for a diagram of our field and its corresponding hit location zones
`hit_type`	`pitch`	String	Type of hit `GB`(Ground ball), `FB`(Fly ball), `LD`(Line drive), `PU`(Popup)

Play-By-Play - Inning

Attribute	Parent Element	Type	Description
`type`	`inning_half`	String	Indicates top or bottom inning half `T`, `B`
`number`	`inning`	Integer	Number of an inning
`sequence`	`inning`	Integer	Sequential number of an inning

Play-By-Play - Pitch

Attribute	Parent Element	Type	Description
`id`	`pitch`	GUID	Unique ID of a pitch ex. `37d94861-7ce4-4547-802c-f97f93e434b4`
`pitch_x`	`pitcher`	Integer	Number as a percentage distance from the center of the strike zone, in positive or negative values from approximately -300% to positive 300% ex. `70`
`pitch_y`	`pitcher`	Integer	Number as a percentage distance from the center of the strike zone, in positive or negative values from approximately -200% to positive 200% ex. `-95`
`created_at`	`pitch`	dateTime	Timestamp of a thrown pitch ex. `2022-09-25T20:10:00+00:00`
`pitch_count`	`pitcher`	Integer	Number of pitches for a pitcher in a game
`official`	`pitch`	Boolean	Signifies whether the API is ingesting data directly from the league at the time of the event. For `true`, `entry_mode`=`Ingest`. For `false`, `entry_mode`=`LDE`.
`outcome_id`	`pitch`	String	ID of a pitch outcome on a play. Check our FAQ for a list of valid outcomes and their definitions
`reference`	`pitch`	String	Unique MLBAM ID of a pitch Available with Statcast only
`sequence_number`	`pitch`	Integer	Sequential number of a pitch in a game
`pitch_speed`	`pitcher`	String	Speed of a pitch in MPH ex. `92.0`
`pitch_type`	`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`	`pitcher`	Integer	Number corresponding to the pitch strike zone (1-13) See our FAQ for more detail and a graphic representation
`status`	`pitch`	String	Status of a pitch. Can be utilized to determine if a play is or was under review `official`, `overturned`, `under review`, `upheld`
`updated_at`	`pitch`	dateTime	Timestamp of a pitch update ex. `2022-09-25T20:25:14+00:00`
`end_time`	`wall_clock`	dateTime	Timestamp of an event end time ex. `2022-09-25T23:00:45+00:00`
`start_time`	`wall_clock`	dateTime	Timestamp of an event start time ex. `2022-09-25T23:00:45+00:00`

Play-By-Play - Pitcher

Attribute	Parent Element	Type	Description
`first_name`	`pitcher`	String	First name of a pitcher ex. `Clayton`
`full_name`	`pitcher`	String	Full name of a pitcher ex. `Clayton Kershaw`
`suffix`	`pitcher`	String	Name suffix of a pitcher ex. `Jr.`
`pitcher_hand`	`pitcher`	String	Handedness of a pitcher
`id`	`pitcher`	GUID	Unique ID of a player of a pitcher ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`jersey_number`	`pitcher`	Integer	Number of a pitcher's jersey
`last_name`	`pitcher`	String	Last name of a pitcher ex. `Kershaw`
`preferred_name`	`pitcher`	String	Preferred name of a pitcher ex. `Clayton`

Play-By-Play - Play Flags

Attribute	Parent Element	Type	Description
`is_ab_over`	`flags`	Boolean	Indicates an at bat has ended on a pitch
`is_bunt`	`flags`	Boolean	Indicates a bunt play
`is_double_play`	`flags`	Boolean	Indicates a double play
`is_passed_ball`	`flags`	Boolean	Indicates a passed ball
`is_hit`	`flags`	Boolean	Indicates a hit
`is_triple_play`	`flags`	Boolean	Indicates a triple play
`is_wild_pitch`	`flags`	Boolean	Indicates a wild pitch
`ci`	`at_bat` - `pitch` - `pitching`	Integer	Signifies an at bat ended with a batter reaching on catcher interference when `ci="1"`
`ci`	`at_bat` - `pitch` - `hitting`	Integer	Signifies an at bat ended with a batter reaching on catcher interference when `ci="1"`
`rov`	`at_bat` - `pitch` - `pitching`	Integer	Signifies an at bat ended with a batter reaching on a violation when `rov="1"`
`rov`	`at_bat` - `pitch` - `hitting`	Integer	Signifies an at bat ended with a batter reaching on a violation when `rov="1"`

Play-By-Play - Score

Attribute	Parent Element	Type	Description
`away_team_runs`	`at_bat` - `score`	Integer	Away team runs for an at bat
`home_team_runs`	`at_bat` - `score`	Integer	Home team runs for an at bat
`away_team_runs`	`pitch` / `steal` / `ejection` - `score`	Integer	Away team runs for an event
`home_team_runs`	`pitch` / `steal` / `ejection` - `score`	Integer	Home team runs for an event

Play-By-Play - Steal

Attribute	Parent Element	Type	Description
`created_at`	`steal`	dateTime	Timestamp of a steal attempt ex. `2022-09-25T20:10:00+00:00`
`id`	`steal`	GUID	Unique ID of a steal attempt ex. `bebe4b5d-970a-40f4-bfa5-05a9a38eac4a`
`official`	`steal`	Boolean	Signifies whether the API is ingesting data directly from the league at the time of the event. For `true`, `entry_mode`=`Ingest`. For `false`, `entry_mode`=`LDE`.
`sequence_number`	`steal`	Integer	Sequence number of an event within a game
`status`	`steal`	String	Status of a pitch/play. Can be utilized to determine if a play is or was under review `official`, `overturned`, `under review`, `upheld`
`updated_at`	`steal`	dateTime	Timestamp of a steal attempt update ex. `2022-09-25T20:25:14+00:00`

Play-By-Play - Ejection

In JSON payload, ejections appear under "events"."type": "ejection"

Attribute	Parent Element	Type	Description
`created_at`	`ejection`	dateTime	Timestamp of an ejection event ex. `2026-03-25T21:14:13+00:00`
`id`	`ejection`	GUID	Unique ID of an ejection event ex. `c6cd3f3b-a049-496f-95ef-1ca244039387`
`official`	`ejection`	Boolean	Signifies whether the API is ingesting data directly from the league at the time of the event. For `true`, `entry_mode`=`Ingest`. For `false`, `entry_mode`=`LDE`.
`sequence_number`	`ejection`	Integer	Sequential number of an ejection event in a game
`status`	`ejection`	String	Status of an ejection event ex. `official`
`updated_at`	`ejection`	dateTime	Timestamp of an ejection event update ex. `2026-03-25T21:15:28+00:00`
`description`	`ejection` - `ejection`	String	Text description of an ejection ex. `Aaron Boone is ejected from the game.`
`first_name`	`ejection` - `ejection`	String	First name of an ejected player or coach ex. `Aaron`
`last_name`	`ejection` - `ejection`	String	Last name of an ejected player or coach ex. `Boone`
`full_name`	`ejection` - `ejection`	String	Full name of an ejected player or coach ex. `Aaron Boone`

Play-By-Play - Warming Up

Attribute	Parent Element	Type	Description
`first_name`	`warming_up`	String	First name of a pitcher warming up in the bullpen ex. `Brusdar`
`full_name`	`warming_up`	String	Full name of a pitcher warming up in the bullpen ex. `Brusdar Graterol`
`suffix`	`warming_up`	String	Name suffix of a pitcher warming up in the bullpen ex. `Jr.`
`id`	`warming_up`	GUID	Unique ID of a warming up event ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`player_id`	`warming_up`	GUID	Unique ID of a player of a pitcher warming up in the bullpen ex. `43862b88-c119-4625-b138-f3c5ea1b8b06`
`jersey_number`	`warming_up`	Integer	Number of a pitcher's jersey
`last_name`	`warming_up`	String	Last name of a pitcher warming up in the bullpen ex. `Graterol`
`preferred_name`	`warming_up`	String	Preferred name of a pitcher warming up in the bullpen ex. `Brusdar`
`team_id`	`warming_up`	GUID	Unique team ID of a pitcher warming up in the bullpen ex. `75729d34-bca7-4a0f-b3df-6f26c6ad3719`

Play-By-Play - Pitch Data

Please note that attributes within mlb_pitch_data may not be present for every event

Attribute	Parent Element	Type	Description
`break_angle`	`breaks`	Decimal	Degrees clockwise (batter’s view) that the plane of the pitch deviates from the vertical Available with Statcast only
`break_length`	`breaks`	Decimal	Max distance (in inches) that the pitch separates from the straight line between pitch start and pitch end Available with Statcast only
`break_y`	`breaks`	Decimal	Distance (in feet) from home plate where the break is greatest Available with Statcast only
`spin_direction`	`breaks`	Decimal	The axis of rotation for the ball at release given as an angle that reflects how the spin will influence the ball trajectory. Pure back-spin is 180 degrees, pure side-spin that puts the ball to the 1b side is 90 degrees, pure-side spin that pulls the ball to the 3b side is 270 degrees, and pure top-spin is 0 or 360 degrees Available with Statcast only
`spin_rate`	`breaks`	Decimal	Rate of spin on the ball (in RPMs) after it was released by pitcher. Available with Statcast only
`code`	`mlb_pitch_data`	String	Two-letter code for a type of pitch. `FA`, `FF`, `FT`, `FC`, `SI`, `FS`, `FO`, `CH`, `SC`, `SL`, `CU`, `CS`, `KC`, `SU`, `FL`, `GY`, `KN`, `EP`, `IN`, `PO`, `AB`, `AS`, `NP`, `UN` _See FAQ for pitch code descriptions
`a_x`	`coordinates`	Decimal	Ball acceleration on the x axis Available with Statcast only
`a_y`	`coordinates`	Decimal	Ball acceleration on the y axis Available with Statcast only
`a_z`	`coordinates`	Decimal	Ball acceleration on the z axis Available with Statcast only
`p_x`	`coordinates`	Decimal	Horizontal position in feet of the ball as it crosses the front axis of home plate Available with Statcast only
`p_z`	`coordinates`	Decimal	Vertical position in feet above home plate of the ball as it crosses the front axis of home plate Available with Statcast only
`pfx_x`	`coordinates`	Decimal	Horizontal movement of the ball in inches Available with Statcast only
`pfx_z`	`coordinates`	Decimal	Vertical movement of the ball in inches Available with Statcast only
`v_x0`	`coordinates`	Decimal	Velocity of the ball from the x axis Available with Statcast only
`v_y0`	`coordinates`	Decimal	Velocity of the ball from the y axis; this is negative because 0,0,0 is behind the batter and the ball travels from pitcher mound towards 0,0,0 Available with Statcast only
`v_z0`	`coordinates`	Decimal	Velocity of the ball from the z axis Available with Statcast only
`x`	`coordinates`	Decimal	X coordinate where a pitch crossed the front of home plate
`x0`	`coordinates`	Decimal	Coordinate location of the ball at the point it was released from the pitchers hand on the x axis (time = 0) Available with Statcast only
`y`	`coordinates`	Decimal	Y coordinate where a pitch crossed the front of home plate
`y0`	`coordinates`	Decimal	Coordinate location of the ball at the point it was released from the pitchers hand on the y axis (time = 0) Available with Statcast only
`z0`	`coordinates`	Decimal	Coordinate location of the ball at the point it was released from the pitchers hand on the z axis (time = 0) Available with Statcast only
`description`	`mlb_pitch_data`	String	Text description of a pitch ex. `Curveball`
`end_speed`	`mlb_pitch_data`	Decimal	Speed in MPH of the ball as it crosses the front edge of home plate (0,0 in the x axis) Available with Statcast only
`extension`	`mlb_pitch_data`	Decimal	Measure of the true release point from pitching rubber - distance in feet closer to home plate than the 60.5 ft from pitching rubber to home Available with Statcast only
`plate_time`	`mlb_pitch_data`	Decimal	Time from pitchers release until the ball is projected to reach the back tip of home plate or struck by the bat Available with Statcast only
`start_speed`	`mlb_pitch_data`	Decimal	Speed in MPH of the ball at 50 feet in front of homeplate
`strike_zone_bottom`	`mlb_pitch_data`	Decimal	Distance in feet from ground to bottom of batter strike zone ex. `1.7`
`strike_zone_top`	`mlb_pitch_data`	Decimal	Distance in feet from ground to top of batter strike zone ex. `3.56`

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