⏱️
Update Frequency
TTL / Cache: 12 hours
Data Updates: Seasonal stats update on a 5-minute timer after a game moves to closed

Data Points

League

Attribute	Parent Element	Type	Description
`id`	`season`	GUID	Unique ID of a season ex. `f5aa580e-8103-4ff5-beb0-965dbe8a8cf1`
`type`	`season`	String	Type of season `PRE`(Spring Training), `REG`(Regular Season), `PST`(Postseason), `AST`(All-Star Game)
`year`	`season`	Integer	Year of a season

Player

Attribute	Parent Element	Type	Description
`bat_hand`	`player`	String	Handedness of a hitter `L`, `R`, `B`
`birthdate`	`player`	Date	Player date of birth ex. `1988-03-19`
`birthcity`	`player`	String	Player city of birth
`birthcountry`	`player`	String	Player country of birth
`birthstate`	`player`	String	Player state of birth
`college`	`player`	String	College attended
`pro_debut`	`player`	Date	Date of pro debut ex. `2008-05-25`
`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.`
`height`	`player`	Integer	Height in inches
`high_school`	`player`	String	High school attended
`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 player 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)
`reference`	`player`	Integer	Unique MLBAM ID of a player
`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
`throw_hand`	`player`	String	Throwing hand of a player `L`, `R`, `B`
`updated`	`player`	dateTime	Timestamp of a player update ex. `2022-09-25T20:10:00+00:00`
`weight`	`player`	Integer	Weight in lbs

Player Pitching Stats (Season)

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

Teams

Attribute	Parent Element	Type	Description
`abbr`	`season` - `team`	String	Abbreviation of a team ex. `TB` (Tampa Bay)
`id`	`season` - `team`	GUID	Unique ID of a team ex. `bdc11650-6f74-49c4-875e-778aeb7632d9`
`market`	`season` - `team`	String	Market name of a team ex. `Tampa Bay`
`name`	`season` - `team`	String	Team name ex. `Rays`

200200