Event Tracking

❗️
This endpoint is only available with our MLB Statcast access.

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

Click here for a comprehensive list of metrics and their definitions.

Data Points

Player Tracking Metrics:

Open the Player Tracking Metric Definitions doc for detailed info on every metric we offer

Attribute	Parent Element	Type	Description
`description`	`metric`	String	Text description of a player tracking metric ex. `The speed of a batted ball immediately after bat-on-ball contact.`
`group`	`metric`	String	Group of a player tracking metric `Baserunning`, `Batting`, `Pitching`, `Fielders (IF)`, `Fielders (OF)`
`name`	`metric`	String	Name of a player tracking metric ex. `Exit Velocity`
`unit`	`metric`	String	Unit of measurement for a player tracking metric ex. `MPH`,`Degrees`,`Seconds`
`value`	`metric`	String	Numerical value of a player tracking metric ex. `0.6`(Seconds) or `37`(Degrees)

Game:

Attribute	Parent Element	Type	Description
`away_team`	`game`	GUID	Unique ID of the away team ex. `29dd9a87-5bcc-4774-80c3-7f50d985068b`
`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`
`reference`	`game`	String	Unique MLBAM ID of 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 player ID 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

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 player ID 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 player ID 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 player ID 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 (in miles per hour) 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 - 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 player ID 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 - 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 greatestAvailable with Statcast only
`spin_direction`	`breaks`	Decimal	Rate of spin on the ball (in RPMs) after it was released by pitcher. Available with Statcast only
`spin_rate`	`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
`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 axisAvailable 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`

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 - 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
`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 player ID 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 - 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`

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`
`preferred_name`	`player`	String	Preferred name of a player ex. `Mookie`

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/Eastern`
`zip`	`venue`	Integer	ZIP code of a venue ex. `90012`