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 |
---|---|---|---|
|
| Boolean | Signifies a player is on the active roster |
|
| String | Handedness of a hitter |
|
| Date | Player date of birth |
|
| String | Player city of birth |
|
| String | Player country of birth |
|
| String | Player state of birth |
|
| String | College attended |
|
| Boolean | Signifies a player is on the 60-day injured list |
|
| Date | Date a player is expected to join a team. |
|
| Date | Date of pro debut |
|
| String | First name of a player |
|
| String | Full name of a player |
|
| Integer | Height in inches |
|
| String | High school attended |
|
| Integer | Year a player was inducted into the MLB Hall of Fame |
|
| GUID | Unique ID of a player |
|
| Integer | Number of a player's jersey |
|
| String | Last name of a player |
|
| String | Position of a player |
|
| String | Preferred name of a player |
|
| String | Primary position of a player |
|
| Integer | Unique MLBAM ID of a player |
|
| Integer | Rookie year of a player |
|
| Integer | Current annual salary of a player |
|
| String | Status of a player |
|
| String | Name suffix of a player |
|
| String | Throwing hand |
|
| 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 |