⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates: Depth charts may update multiple times per week to remain current

📘
Building Team Rosters
Learn how to retrieve depth chart positions for every MLB team in a single response in our Building Team Rosters 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`

Player

Attribute	Parent Element	Type	Description
`desc`	`position`	String	Text description of a position ex. `Left Field`
`name`	`position`	String	Abbreviated description of a position ex. `LF`
`depth`	`player`	Integer	Player's depth chart position (1 = starter)
`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)
`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

Teams

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

200200