Play-by-Play

⏱️
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)
`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`	`away`-`inning`	Integer	Number of errors for the away team in an inning
`hits`	`away`	Integer	Number of hits for the away 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`
`market`	`away`	String	Market name of the away team ex. `Colorado`
`name`	`away`	String	Team name of the away team ex. `Rockies`
`runs`	`away`	Integer	Number of runs for the away team in the game
`runs`	`away`-`inning`	Integer	Number of runs for the away team in an inning
`abbr`	`home`	String	Abbreviation of the home team ex. `CLE` (Cleveland)
`errors`	`home`	Integer	Number of errors for the home team
`errors`	`home`-`inning`	Integer	Number of errors for the home team in an inning
`hits`	`home`	Integer	Number of hits for the home team
`hits`	`home`-`inning`	Integer	Number of hits for the home team in an inning
`id`	`home`	GUID	Unique ID of the home team ex. `29dd9a87-5bcc-4774-80c3-7f50d985068b`
`market`	`home`	String	Market name of the home team ex. `Cleveland`
`name`	`home`	String	Team name of the home team ex. `Guardians`
`runs`	`home`	Integer	Number of runs for the home team in the game
`runs`	`home`-`inning`	Integer	Number of runs for the home team in an inning

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 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`
`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 game `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`

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

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 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](https://developer.sportradar.com/baseball/reference/mlb-faq#what-are-the-valid-lineup-positions-and-their-definitions) for fielding position numbers and definitions

Available with Statcast only | | `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
ex. `ground_ball`, `fly_ball`, `line_drive`,'popup' | | `hit_location` | `pitch` | Integer | Number code of hit ball location (1-35). Please see our [FAQ](https://developer.sportradar.com/baseball/reference/mlb-faq#you-are-tracking-hit-location-do-you-have-a-diagram-showing-the-field-and-its-corresponding-zones) 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

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 - 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 ofthe 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](https://developer.sportradar.com/baseball/reference/mlb-faq#what-are-the-valid-values-for-mlb_pitch_data--code-and-what-are-their-descriptions) 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 inches from ground to bottom of batter strike zone | | `strike_zone_top` | `mlb_pitch_data` | Decimal | Distance in inches from ground to top of batter strike zone |

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

⏱️Update Frequency

Data Points

⏱️
Update Frequency