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 FrequencyTTL / 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 annual 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 |