Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

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

League:
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
Player:

Attribute

Parent Element

Type

Description

active

player

Boolean

Signifies a player is on the active roster

bat_hand

player

String

Handedness of a hitter

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), 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

weight

player

Integer

Weight in lbs

Team:
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
primary,secondary
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
Injuries:
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
Venue:
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
Language
Credentials
Header
Click Try It! to start a request and see the response here!