---
updatedAt: 2026-08-01T04:35:41.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/baseball/llms.txt
---
# 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:** 4 hours
**Data Updates**: Team profiles update in realtime as rosters or player profiles change
> 📘 Building Team Rosters
>
> Learn how to use the Team Profile for current-season roster snapshots and team context in our Building Team Rosters integration scenario.
***
## Data Points
| 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` |
| 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. |
| `bat_hand` | `player` | String | Handedness of a hitter
`L`, `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 |
| `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` | String | 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), `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 player
`L`, `R`, `B` |
| `weight` | `player` | Integer | Weight in lbs |
| 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 color
`primary`,`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` |
| 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` |
| `estimated_return_date` | `injury` | Date | Estimated return date for an injured player
ex. `2027-02-01 |
| `status` | `injury` | String | Status of an injured player
`Unknown`(Unknown), `D7`(7 Day Injured List), `D10`(10 Day Injured List), `D15`(15 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` |
| 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` |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "mlb",
"version": "8"
},
"servers": [
{
"url": "https://api.sportradar.com/mlb/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v8/{language_code}/teams/{team_id}/profile.{format}": {
"get": {
"summary": "Team Profile",
"description": "**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.",
"operationId": "mlb-team-profile",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`production` (Production), `trial` (Trial),
`tracking` (Statcast Production), `trial-tracking` (Statcast Trial)",
"schema": {
"type": "string",
"enum": [
"production",
"trial",
"tracking",
"trial-tracking"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`en` (English)",
"schema": {
"type": "string",
"enum": [
"en"
],
"default": "en"
},
"required": true
},
{
"name": "team_id",
"in": "path",
"description": "Unique Id of a team, found in the [Teams](https://developer.sportradar.com/baseball/reference/mlb-teams) endpoint
**Example:** `25507be1-6a68-4267-bd82-e097d94b359b`
**Note:** This endpoint is designed for team_ids which exist in the current [League Hierarchy](https://developer.sportradar.com/baseball/reference/mlb-league-hierarchy) endpoint",
"schema": {
"type": "string",
"default": "25507be1-6a68-4267-bd82-e097d94b359b"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"JSON": {
"value": {
"name": "Twins",
"market": "Minnesota",
"abbr": "MIN",
"id": "aa34e0ed-f342-4ec6-b774-c79b47b60e2d",
"founded": 1901,
"owner": "Pohlad family",
"general_manager": "Thad Levine",
"president": "Joe Pohlad",
"mascot": "T.C. Bear",
"nicknames": "Twinkies, Nats, Grifs, Little Piranhas, Bomba Squad",
"fight_song": "We're Gonna Win Twins",
"championships_won": 3,
"championship_seasons": "1924, 1987, 1991",
"conference_titles": 6,
"division_titles": 13,
"retired_numbers": "3, 6, 7, 10, 14, 28, 29, 34, 36, 42",
"playoff_appearances": 18,
"minorleague_affiliate": "St. Paul Saints",
"team_colors": [
{
"type": "primary",
"hex_color": "#e31e34",
"rgb_color": {
"red": 227,
"green": 30,
"blue": 52
}
},
{
"type": "secondary",
"hex_color": "#091f40",
"rgb_color": {
"red": 9,
"green": 31,
"blue": 64
}
}
],
"venue": {
"name": "Target Field",
"market": "Minnesota",
"capacity": 38544,
"surface": "grass",
"address": "1 Twins Way",
"city": "Minneapolis",
"state": "MN",
"zip": "55403",
"country": "USA",
"id": "302f8dcd-eed6-4b83-8609-81548d51e955",
"field_orientation": "E",
"stadium_type": "outdoor",
"time_zone": "US/Central",
"location": {
"lat": "44.981829",
"lng": "-93.277891"
}
},
"league": {
"alias": "AL",
"name": "American League",
"id": "2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85"
},
"division": {
"alias": "C",
"name": "Central",
"id": "255fadc6-367e-4238-8ece-d0cddabf7d72"
},
"staff": [
{
"full_name": "Rocco Baldelli",
"first_name": "Rocco",
"last_name": "Baldelli",
"position": "Manager",
"id": "5daf8c08-e8ef-46f2-9bff-ed34abff7f62"
},
{
"full_name": "David Popkins",
"first_name": "David",
"last_name": "Popkins",
"position": "Hitting Coach",
"id": "adf119f7-8422-42e1-9ec6-787d42ebdf1f"
},
{
"full_name": "Pete Maki",
"first_name": "Pete",
"last_name": "Maki",
"position": "Pitching Coach",
"id": "fd925590-3cf5-4e71-8713-e68449310349"
}
],
"players": [
{
"id": "51c5b523-77b9-4e09-83be-8de6204235e5",
"status": "A",
"position": "C",
"primary_position": "C",
"first_name": "Jair",
"last_name": "Camargo",
"preferred_name": "Jair",
"jersey_number": "85",
"full_name": "Jair Camargo",
"height": "70",
"hof_year": 2020,
"weight": "230",
"throw_hand": "R",
"bat_hand": "R",
"birthdate": "1999-07-01",
"birthcountry": "COL",
"birthcity": "Barranquilla",
"salary": 15142857,
"rookie_year": 2016,
"updated": "2024-02-22T00:50:19+00:00",
"reference": "665856",
"active": true
},
{
"id": "2d8de314-4980-4f1a-97b5-279261ceb111",
"status": "D60",
"position": "P",
"primary_position": "SP",
"first_name": "Pablo",
"last_name": "López",
"preferred_name": "Pablo",
"jersey_number": "49",
"full_name": "Pablo López",
"height": "76",
"weight": "225",
"throw_hand": "R",
"bat_hand": "L",
"birthdate": "1996-03-07",
"birthcountry": "VEN",
"birthcity": "Cabimas",
"pro_debut": "2018-06-30",
"updated": "2026-02-26T20:04:33+00:00",
"salary": 21750000,
"rookie_year": 2018,
"reference": "641154",
"active": false,
"dl60": true,
"injuries": [
{
"id": "6e19e627-bfa5-4bd1-afd3-2765906566fe",
"comment": "The Minnesota Twins placed RHP Pablo Lopez on the 60-day injured list following his successful UCL repair surgery with an internal brace.",
"desc": "Elbow",
"status": "D60",
"start_date": "2026-02-20",
"update_date": "2026-02-26",
"estimated_return_date": "2027-04-01"
}
]
},
{
"id": "f3e012c5-daa2-406c-a9c4-2c8bfa16ff96",
"status": "A",
"position": "P",
"primary_position": "SP",
"first_name": "Simeon",
"last_name": "Woods Richardson",
"preferred_name": "Simeon",
"jersey_number": "78",
"full_name": "Simeon Woods Richardson",
"height": "75",
"weight": "210",
"throw_hand": "R",
"bat_hand": "R",
"high_school": "Kempner (TX)",
"birthdate": "2000-09-27",
"birthstate": "TX",
"birthcountry": "USA",
"birthcity": "Sugar Land",
"pro_debut": "2022-10-02",
"updated": "2023-11-03T15:28:33+00:00",
"reference": "680573",
"active": true
}
],
"_comment": "Generation started @ 2024-03-08 20:28:22 UTC ended @ 2024-03-08 20:28:22 UTC"
}
}
},
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Twins"
},
"market": {
"type": "string",
"example": "Minnesota"
},
"abbr": {
"type": "string",
"example": "MIN"
},
"id": {
"type": "string",
"example": "aa34e0ed-f342-4ec6-b774-c79b47b60e2d"
},
"founded": {
"type": "integer",
"example": 1901,
"default": 0
},
"owner": {
"type": "string",
"example": "Pohlad family"
},
"general_manager": {
"type": "string",
"example": "Thad Levine"
},
"president": {
"type": "string",
"example": "Joe Pohlad"
},
"mascot": {
"type": "string",
"example": "T.C. Bear"
},
"nicknames": {
"type": "string",
"example": "Twinkies, Nats, Grifs, Little Piranhas, Bomba Squad"
},
"fight_song": {
"type": "string",
"example": "We're Gonna Win Twins"
},
"championships_won": {
"type": "integer",
"example": 3,
"default": 0
},
"championship_seasons": {
"type": "string",
"example": "1924, 1987, 1991"
},
"conference_titles": {
"type": "integer",
"example": 6,
"default": 0
},
"division_titles": {
"type": "integer",
"example": 13,
"default": 0
},
"retired_numbers": {
"type": "string",
"example": "3, 6, 7, 10, 14, 28, 29, 34, 36, 42"
},
"playoff_appearances": {
"type": "integer",
"example": 18,
"default": 0
},
"minorleague_affiliate": {
"type": "string",
"example": "St. Paul Saints"
},
"team_colors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"example": "primary"
},
"hex_color": {
"type": "string",
"example": "#e31e34"
},
"rgb_color": {
"type": "object",
"properties": {
"red": {
"type": "integer",
"example": 227,
"default": 0
},
"green": {
"type": "integer",
"example": 30,
"default": 0
},
"blue": {
"type": "integer",
"example": 52,
"default": 0
}
}
}
}
}
},
"venue": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Target Field"
},
"market": {
"type": "string",
"example": "Minnesota"
},
"capacity": {
"type": "integer",
"example": 38544,
"default": 0
},
"surface": {
"type": "string",
"example": "grass"
},
"address": {
"type": "string",
"example": "1 Twins Way"
},
"city": {
"type": "string",
"example": "Minneapolis"
},
"state": {
"type": "string",
"example": "MN"
},
"zip": {
"type": "string",
"example": "55403"
},
"country": {
"type": "string",
"example": "USA"
},
"id": {
"type": "string",
"example": "302f8dcd-eed6-4b83-8609-81548d51e955"
},
"field_orientation": {
"type": "string",
"example": "E"
},
"stadium_type": {
"type": "string",
"example": "outdoor"
},
"time_zone": {
"type": "string",
"example": "US/Central"
},
"location": {
"type": "object",
"properties": {
"lat": {
"type": "string",
"example": "44.981829"
},
"lng": {
"type": "string",
"example": "-93.277891"
}
}
}
}
},
"league": {
"type": "object",
"properties": {
"alias": {
"type": "string",
"example": "AL"
},
"name": {
"type": "string",
"example": "American League"
},
"id": {
"type": "string",
"example": "2ea6efe7-2e21-4f29-80a2-0a24ad1f5f85"
}
}
},
"division": {
"type": "object",
"properties": {
"alias": {
"type": "string",
"example": "C"
},
"name": {
"type": "string",
"example": "Central"
},
"id": {
"type": "string",
"example": "255fadc6-367e-4238-8ece-d0cddabf7d72"
}
}
},
"staff": {
"type": "array",
"items": {
"type": "object",
"properties": {
"full_name": {
"type": "string",
"example": "Rocco Baldelli"
},
"first_name": {
"type": "string",
"example": "Rocco"
},
"last_name": {
"type": "string",
"example": "Baldelli"
},
"position": {
"type": "string",
"example": "Manager"
},
"id": {
"type": "string",
"example": "5daf8c08-e8ef-46f2-9bff-ed34abff7f62"
}
}
}
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "51c5b523-77b9-4e09-83be-8de6204235e5"
},
"status": {
"type": "string",
"example": "A"
},
"position": {
"type": "string",
"example": "C"
},
"primary_position": {
"type": "string",
"example": "C"
},
"first_name": {
"type": "string",
"example": "Jair"
},
"last_name": {
"type": "string",
"example": "Camargo"
},
"preferred_name": {
"type": "string",
"example": "Jair"
},
"jersey_number": {
"type": "string",
"example": "85"
},
"full_name": {
"type": "string",
"example": "Jair Camargo"
},
"height": {
"type": "string",
"example": "70"
},
"hof_year": {
"type": "integer",
"example": 2020,
"default": 0
},
"weight": {
"type": "string",
"example": "230"
},
"throw_hand": {
"type": "string",
"example": "R"
},
"bat_hand": {
"type": "string",
"example": "R"
},
"birthdate": {
"type": "string",
"example": "1999-07-01"
},
"birthcountry": {
"type": "string",
"example": "COL"
},
"birthcity": {
"type": "string",
"example": "Barranquilla"
},
"salary": {
"type": "integer",
"example": 15142857,
"default": 0
},
"rookie_year": {
"type": "integer",
"example": 2016,
"default": 0
},
"updated": {
"type": "string",
"example": "2024-02-22T00:50:19+00:00"
},
"reference": {
"type": "string",
"example": "665856"
},
"active": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"_comment": {
"type": "string",
"example": "Generation started @ 2024-03-08 20:28:22 UTC ended @ 2024-03-08 20:28:22 UTC"
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```