---
updatedAt: 2026-08-01T04:35:34.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/baseball/llms.txt
---
# Team Depth Chart
**MLB Team Depth Chart** provides current depth chart for all positions on a given team.
### Update Frequency
**TTL / Cache:** 4 hours
**Data Updates**: Depth charts may update multiple times per week to remain current
> 📘 Building Team Rosters
>
> Learn how to use team depth chart data for position-ordered roster displays in our Building Team Rosters integration scenario.
***
## Data Points
| Attribute | Parent Element | Type | Description |
| ------------------ | -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `desc` | `position` | String | Text description of a position
ex. `Left Field` |
| `name` | `position` | String | Abbreviated description of a position
ex. `LF` |
| `depth` | `player` | Integer | Player's depth chart position (1 = starter) |
| `first_name` | `player` | String | First name of a player
ex. `Markus` |
| `full_name` | `player` | String | Full name of a player
ex. `Mookie Betts` |
| `suffix` | `player` | String | Name suffix of a player
ex. `Jr.` |
| `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 runner
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) |
| `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* |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ------ | ------------------------------------------------------------------------- |
| `abbr` | `team` | String | Abbreviation of a team
ex. `TB` (Tampa Bay) |
| `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` |
| `name` | `team` | String | Team name
ex. `Rays` |
# 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}/depth_chart.{format}": {
"get": {
"summary": "Team Depth Chart",
"description": "**MLB Team Depth Chart** provides current depth chart for all positions on a given team.",
"operationId": "mlb-team-depth-chart",
"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": "{\n \"team\": {\n \"name\": \"Dodgers\",\n \"market\": \"Los Angeles\",\n \"abbr\": \"LAD\",\n \"id\": \"ef64da7f-cfaf-4300-87b0-9313386b977c\",\n \"positions\": [\n {\n \"name\": \"RF\",\n \"desc\": \"Right Field\",\n \"players\": [\n {\n \"id\": \"084d2514-9ffb-414e-ae16-3bc690aaad51\",\n \"status\": \"A\",\n \"position\": \"OF\",\n \"primary_position\": \"RF\",\n \"first_name\": \"Markus\",\n \"last_name\": \"Betts\",\n \"preferred_name\": \"Mookie\",\n \"jersey_number\": \"50\",\n \"depth\": 1\n }\n ]\n }\n ]\n },\n \"_comment\": \"Generation started @ 2022-11-30 16:17:50 UTC ended @ 2022-11-30 16:17:50 UTC\"\n}\n"
}
},
"schema": {
"type": "object",
"properties": {
"team": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Dodgers"
},
"market": {
"type": "string",
"example": "Los Angeles"
},
"abbr": {
"type": "string",
"example": "LAD"
},
"id": {
"type": "string",
"example": "ef64da7f-cfaf-4300-87b0-9313386b977c"
},
"positions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "RF"
},
"desc": {
"type": "string",
"example": "Right Field"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "084d2514-9ffb-414e-ae16-3bc690aaad51"
},
"status": {
"type": "string",
"example": "A"
},
"position": {
"type": "string",
"example": "OF"
},
"primary_position": {
"type": "string",
"example": "RF"
},
"first_name": {
"type": "string",
"example": "Markus"
},
"last_name": {
"type": "string",
"example": "Betts"
},
"preferred_name": {
"type": "string",
"example": "Mookie"
},
"jersey_number": {
"type": "string",
"example": "50"
},
"depth": {
"type": "integer",
"example": 1,
"default": 0
}
}
}
}
}
}
}
}
},
"_comment": {
"type": "string",
"example": "Generation started @ 2022-11-30 16:17:50 UTC ended @ 2022-11-30 16:17:50 UTC"
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```