get
https://api.sportradar.com/mlb//v8//teams//full_roster.
MLB Team Full Roster returns all players associated with a given team, including approximately 100 minor league players who are not on the 40-man roster. This endpoint does not include every player in the team’s minor league system.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache: 4 hours
Data Updates: Team profiles update in realtime as rosters or player profiles change
Building Team RostersLearn how to use the Team Full Roster for broad player discovery across an organization in our Building Team Rosters integration scenario.
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 | Indicates whether a player is on the active roster. When active="true":- During the regular season, the player is on the 26-man active roster (28-man roster in September). - During the offseason and most of Spring Training, the active roster may expand to include up to 40 players. When active="false", the player is part of the organization (typically in the minor leagues) but is not on the active roster. |
bat_hand | player | String | Handedness of a hitterL, R, B |
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 |
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 |
roster_status | player | String | Indicates a player is on the 40-man roster when roster_status="active" |
status | player | String | Status of a playerA (Activated), BRV (Bereavement Leave), D7 (7-Day Injured List), D10 (10-Day Injured List), D15 (15-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 of a playerL, R, B |
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 |
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 |