get https://api.sportradar.com/mlb//v8//teams//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:
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 | 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 playerC (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 playerC (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 total salary of a player ex. 15142857 |
status | player | String | Status of a playerA (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:
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 colorprimary ,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 |
status | injury | String | Status of an injured playerUnknown (Unknown), D7 (7 Day Injured List), D10 (10 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 |