⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates: Injuries update based on the game day and injury reporting workflows

📘
Building Team Rosters
Learn how to enrich roster and depth chart views with injury and availability data in our Building Team Rosters integration scenario.

Data Points

Injuries

Attribute	Parent Element	Type	Description
`comment`	`injury`	String	Text description of an injury ex. `The Minnesota Twins placed RHP Chris Archer on the 15-day injured list.`
`desc`	`injury`	String	Text description of an injury ex. `The Tampa Bay Rays placed RHP Ryan Thompson on the 60-day injured list.`
`estimated_return_date`	`injury`	Date	Estimated return date for an injured player ex. `2027-02-01
`id`	`injury`	GUID	Unique ID of an injury ex. `005ce145-9a3f-46f3-8884-3a84b6226941`
`status`	`injury`	String	Status of an injured player `Unknown`(Unknown), `D7`(7 Day Injured List), `D10`(10 Day Injured List), `D15`(15 Day Injured List), `D60`(60 Day Injured List), `Day-to-Day`(Day-to-Day)
`start_date`	`injury`	Date	Date an injury transaction goes into effect ex. `2022-08-27`
`update_date`	`transaction`	Date	Date of an injury update ex. `2022-09-16`

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