⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates: Team profiles update in realtime as rosters or player profiles change

📘
Building Team Rosters
Learn how to use the Team Profile for current-season roster snapshots and team context in our Building Team Rosters integration scenario.

Data Points

League

Attribute	Parent Element	Type	Description
`alias`	`division`	String	Alias of a division ex. `C`
`id`	`division`	GUID	Unique ID of a division ex. `95e2d773-d899-4751-b61a-b9463e5aa874`
`name`	`division`	String	Name of a division ex. `Central`
`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`

Player

Attribute	Parent Element	Type	Description
`active`	`player`	Boolean	Indicates whether a player is on the active roster. When `active="true"`: - During the regular season, the player is on the 26-man active roster (28-man roster in September). - During the offseason and most of Spring Training, the active roster may expand to include up to 40 players.
`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
`dl60`	`player`	Boolean	Signifies a player is on the 60-day injured list
`expected_date`	`player`	Date	Date a player is expected to join a team. Note: This will only appear for players expected to join a Major League roster, but the official transaction has not been finalized. ex. `2023-05-25`
`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`
`height`	`player`	Integer	Height in inches
`high_school`	`player`	String	High school attended
`hof_year`	`player`	Integer	Year a player was inducted into the MLB Hall of Fame ex. `2024`
`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
`rookie_year`	`player`	Integer	Rookie year of a player ex. `2020`
`salary`	`player`	Integer	Current annual salary of a player ex. `15142857`
`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
`suffix`	`player`	String	Name suffix of a player ex. `Jr.`
`throw_hand`	`player`	String	Throwing hand of a player `L`, `R`, `B`
`weight`	`player`	Integer	Weight in lbs

Team

Attribute	Parent Element	Type	Description
`abbr`	`team`	String	Abbreviation of a team ex. `TB` (Tampa Bay)
`championship_seasons`	`team`	String	Years of championship (World Series) seasons ex. `1924, 1987, 1991`
`championships_won`	`team`	Integer	Number of championships (World Series) won
`conference_titles`	`team`	Integer	Number of conference titles
`division_titles`	`team`	Integer	Number of division titles
`fight_song`	`team`	String	Team fight song ex. `We're Gonna Win Twins`
`founded`	`team`	Integer	Year a team was founded
`general_manager`	`team`	String	Team general manager ex. `Thad Levine`
`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`
`mascot`	`team`	String	Team mascot ex. `T.C. Bear`
`minorleague_affiliate`	`team`	String	AAA minor league affiliate of a team ex. `St. Paul Saints`
`name`	`team`	String	Team name ex. `Rays`
`nicknames`	`team`	String	Team nicknames ex. `Twinkies, Nats, Grifs, Little Piranhas, Bomba Squad`
`owner`	`team`	String	Team owner ex. `Pohlad family`
`playoff_appearances`	`team`	Integer	Number of playoff appearances
`president`	`team`	String	Team president ex. `Joe Pohlad`
`retired_numbers`	`team`	String	Retired numbers (numbers which can no longer be worn) for a team ex. `3, 6, 7, 10, 14, 28, 29, 34, 36, 42`
`sponsor`	`team`	String	Team sponsor ex. `AmFam`
`first_name`	`staff_member`	String	First name of a staff member ex. `Rocco`
`full_name`	`staff_member`	String	Full name of a staff member ex. `Rocco Baldelli`
`id`	`staff_member`	GUID	Unique ID of a staff member ex. `5daf8c08-e8ef-46f2-9bff-ed34abff7f62`
`last_name`	`staff_member`	String	Last name of a staff member ex. `Baldelli`
`position`	`staff_member`	String	Position of a staff member ex. `Manager`, `Hitting Coach`, `Pitching Coach`
`hex_color`	`team_color`	String	Team color HEX value ex. `#e31e34`
`type`	`team_color`	String	Type of team color `primary`,`secondary`
`red`	`team_color` - `rgb-color`	Integer	Team RGB color code - Red ex. `227`
`green`	`team_color` - `rgb-color`	Integer	Team RGB color code - Green ex. `30`
`blue`	`team_color` - `rgb-color`	Integer	Team RGB color code - Blue ex. `52`

Injuries

Attribute	Parent Element	Type	Description
`id`	`injury`	GUID	Unique ID of an injury ex. `005ce145-9a3f-46f3-8884-3a84b6226941`
`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	Name of the injured body part ex. `Elbow` or `Pectoral`
`estimated_return_date`	`injury`	Date	Estimated return date for an injured player ex. `2027-02-01
`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`	`injury`	Date	Date of an injury update ex. `2022-09-16`

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

200200