Coverage MatrixDocumentationRelease LogLog In

Team Profile

MLB Team Profile provides top-level team information including all players currently on the 25-man roster, 40-man roster, or expected to join the team.


Update Frequency

TTL / Cache: 2 seconds

Data Updates: As Necessary

Data Points

AttributeParent ElementTypeDescription
aliasdivisionStringAlias of a division
ex. C
iddivisionGUIDUnique ID of a division
ex. 95e2d773-d899-4751-b61a-b9463e5aa874
namedivisionStringName of a division
ex. Central
aliasleagueStringAlias of a league
ex. NL
idleagueGUIDUnique ID of a league
ex. fbe91704-36df-4e7c-864a-06d236425999
nameleagueStringName of a league
ex. National League
AttributeParent ElementTypeDescription
activeplayerBooleanSignifies a player is on the active roster
bat_handplayerStringHandedness of a hitter
birthdateplayerDatePlayer date of birth
ex. 1988-03-19
birthcityplayerStringPlayer city of birth
birthcountryplayerStringPlayer country of birth
birthstateplayerStringPlayer state of birth
collegeplayerStringCollege attended
dl60playerBooleanSignifies a player is on the 60-day injured list
expected_dateplayerDateDate 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_debutplayerDateDate of pro debut
ex. 2008-05-25
first_nameplayerStringFirst name of a player
ex. Markus
full_nameplayerStringFull name of a player
ex. Mookie Betts
heightplayerIntegerHeight in inches
high_schoolplayerStringHigh school attended
idplayerGUIDUnique ID of a player
ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a player
ex. Betts
positionplayerStringPosition of a player
C(Catcher), IF(Infield), OF(Outfield), P(Pitcher), DH(Designated Hitter)
preferred_nameplayerStringPreferred name of a player
ex. Mookie
primary_positionplayerStringPrimary position of a player
C(Catcher), IF(Infield), 1B(First Base), 2B(Second Base), 3B(Third Base), SS(Shortstop), OF(Outfield), LF(Left Field), CF(Centerfield), P(Pitcher), RF(Right Field), RP(Relief Pitcher), SP(Starting Pitcher), DH(Designated Hitter)
referenceplayerIntegerUnique MLBAM ID of a player
statusplayerStringStatus 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
suffixplayerStringName suffix of a player
ex. Jr.
throw_handplayerStringThrowing hand
weightplayerIntegerWeight in lbs
AttributeParent ElementTypeDescription
abbrteamStringAbbreviation of a team
ex. TB (Tampa Bay)
championship_seasonsteamStringYears of championship (World Series) seasons
ex. 1924, 1987, 1991
championships_wonteamIntegerNumber of championships (World Series) won
conference_titlesteamIntegerNumber of conference titles
division_titlesteamIntegerNumber of division titles
fight_songteamStringTeam fight song
ex. We're Gonna Win Twins
foundedteamIntegerYear a team was founded
general_managerteamStringTeam general manager
ex. Thad Levine
idteamGUIDUnique ID of a team
ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketteamStringMarket name of a team
ex. Tampa Bay
mascotteamStringTeam mascot
ex. T.C. Bear
minorleague_affiliateteamStringAAA minor league affiliate of a team
ex. St. Paul Saints
nameteamStringTeam name
ex. Rays
nicknamesteamStringTeam nicknames
ex. Twinkies, Nats, Grifs, Little Piranhas, Bomba Squad
ownerteamStringTeam owner
ex. Pohlad family
playoff_appearancesteamIntegerNumber of playoff appearances
presidentteamStringTeam president
ex. Joe Pohlad
retired_numbersteamStringRetired numbers (numbers which can no longer be worn) for a team
ex. 3, 6, 7, 10, 14, 28, 29, 34, 36, 42
sponsorteamStringTeam sponsor
ex. AmFam
first_namestaff_memberStringFirst name of a staff member
ex. Rocco
full_namestaff_memberStringFull name of a staff member
ex. Rocco Baldelli
idstaff_memberGUIDUnique ID of a staff member
ex. 5daf8c08-e8ef-46f2-9bff-ed34abff7f62
last_namestaff_memberStringLast name of a staff member
ex. Baldelli
positionstaff_memberStringPosition of a staff member
ex. Manager, Hitting Coach, Pitching Coach
hex_colorteam_colorStringTeam color HEX value
ex. #e31e34
typeteam_colorStringType of team color
redteam_color - rgb-colorIntegerTeam RGB color code - Red
ex. 227
greenteam_color - rgb-colorIntegerTeam RGB color code - Green
ex. 30
blueteam_color - rgb-colorIntegerTeam RGB color code - Blue
ex. 52
AttributeParent ElementTypeDescription
idinjuryGUIDUnique ID of an injury
ex. 005ce145-9a3f-46f3-8884-3a84b6226941
commentinjuryStringText description of an injury
ex. The Minnesota Twins placed RHP Chris Archer on the 15-day injured list.
descinjuryStringName of the injured body part
ex. Elbow or Pectoral
statusinjuryStringStatus of an injured player
Unknown(Unknown), D7(7 Day Injured List), D10(10 Day Injured List), D60(60 Day Injured List), Day-to-Day(Day-to-Day)
start_dateinjuryDateDate an injury transaction goes into effect
ex. 2022-08-27
update_dateinjuryDateDate of an injury update
ex. 2022-09-16
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
ex. 1000 Vin Scully Avenue
capacityvenueStringCapacity of a venue
ex. 56000
cityvenueStringCity of a venue
ex. Los Angeles
countryvenueStringCountry of a venue
ex. USA
field_orientationvenueStringField orientation of a venue
ex. NE
idvenueGUIDUnique ID of a venue
ex. 66a19c3d-24fe-477d-bee7-c6ef1b98352f
latlocationDecimalLatitude of a venue
ex. 34.0745409
lnglocationDecimalLongitude of a venue
ex. -118.2408881
marketvenueStringMarket of a venue
ex. Los Angeles
namevenueStringName of a venue
ex. Dodger Stadium
stadium_typevenueStringType of a venue
ex. outdoor
statevenueStringState of a venue
ex. CA
surfacevenueStringSurface type of a venue
ex. grass
time_zonevenueStringTime zone of a venue
ex. US/Central
zipvenueIntegerZIP code of a venue
ex. 90012
Click Try It! to start a request and see the response here!