⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates: League leaders update around 5 minutes after a game moves to closed

📘
Retrieving Game, Season, and Split Statistics
Learn how to build traditional season leaderboards using the League Leaders feed in our Retrieving Game, Season, and Split Statistics integration scenario.

Data Points

League

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `MLB`
`id`	`league`	GUID	Unique ID of a league ex. `2fa448bc-fc17-4d3d-be03-e60e080fdc26`
`name`	`league`	String	Name of a league ex. `Major League Baseball`
`alias`	`league`	String	Alias of a league ex. `NL`
`id`	`league`	GUID	Unique ID of a league ex. `fbe91704-36df-4e7c-864a-06d236425999`
`name`	`league`	String	Name of a league ex. `National League`
`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

Leaders - Baserunning (Player)

Attribute	Parent Element	Type	Description
`sb`	`player`	Integer	Number of stolen bases

Leaders - Hitting (Player)

Attribute	Parent Element	Type	Description
`avg`	`player`	Decimal	Batting average ex. `.333`
`doubles`	`player`	Integer	Number of doubles
`h`	`player`	Integer	Number of hits
`hr`	`player`	Integer	Number of home runs
`rbi`	`player`	Integer	Number of RBI (Runs Batted In)
`runs`	`player`	Integer	Number of runs scored
`triples`	`player`	Integer	Number of triples

Leaders - Pitching (Player)

Attribute	Parent Element	Type	Description
`games_completed`	`player`	Integer	Number of complete games pitched
`era`	`player`	Decimal	ERA (Earned Run Average) ex. `1.80`
`games_lost`	`player`	Integer	Number of games lost
`games_saved`	`player`	Integer	Number of games saved
`strikeouts`	`player`	Integer	Number of strikeouts
`whip`	`player`	Decimal	WHIP (Walks + Hits Per Inning Pitched) ex. `0.89`
`games_won`	`player`	Integer	Number of games won

Leaders - Baserunning (Team)

Attribute	Parent Element	Type	Description
`sb`	`team`	Integer	Number of stolen bases

Leaders - Hitting (Team)

Attribute	Parent Element	Type	Description
`avg`	`team`	Decimal	Batting average ex. `.333`
`doubles`	`team`	Integer	Number of doubles
`h`	`team`	Integer	Number of hits
`hr`	`team`	Integer	Number of home runs
`rbi`	`team`	Integer	Number of RBI (Runs Batted In)
`runs`	`team`	Integer	Number of runs scored
`triples`	`team`	Integer	Number of triples

Leaders - Pitching (Team)

Attribute	Parent Element	Type	Description
`games_completed`	`team`	Integer	Number of complete games pitched
`era`	`team`	Decimal	ERA (Earned Run Average) ex. `1.80`
`games_lost`	`team`	Integer	Number of games lost
`games_saved`	`team`	Integer	Number of games saved
`strikeouts`	`team`	Integer	Number of strikeouts
`whip`	`team`	Decimal	WHIP (Walks + Hits Per Inning Pitched) ex. `0.89`
`games_won`	`team`	Integer	Number of games won

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)
`rank`	`player`	Integer	Player rank for a statistic
`status`	`player`	String	Status of a player `A` (Activated), `BRV` (Bereavement Leave), `D7` (7 Day Injured List), `D10` (10 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

Teams

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

200200