---
updatedAt: 2025-11-18T15:53:13.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/basketball/v7/llms.txt
---
# Team Depth Chart
**NBA Team Depth Chart** provides a positional depth chart for a given team, including player position information.
### Update Frequency
300s Time To Live / Cache
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "nba",
"version": "7"
},
"servers": [
{
"url": "https://api.sportradar.com/nba/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v7/{language_code}/teams/{team_id}/depth_chart.{format}": {
"get": {
"summary": "Team Depth Chart",
"description": "**NBA Team Depth Chart** provides a positional depth chart for a given team, including player position information.",
"operationId": "nba-team-depth-chart",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key",
"schema": {
"type": "string",
"enum": [
"trial",
"production"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`br` (Brazilian Portuguese), `de` (German), `el` (Greek), `en` (English), `es` (Spanish), `fr` (French), `id` (Indonesian), `it` (Italian), `ja` (Japanese), `ko` (Korean), `ru` (Russian), `tl` (Tagalog), `tr` (Turkish), `zh` (simplified Chinese)",
"schema": {
"type": "string",
"enum": [
"br",
"de",
"el",
"en",
"es",
"fr",
"id",
"it",
"ja",
"ko",
"ru",
"tl",
"tr",
"zh"
],
"default": "en"
},
"required": true
},
{
"name": "team_id",
"in": "path",
"description": "ID of a given team
This endpoint is designed for team_ids that exist in the current League Hierarchy endpoint.",
"schema": {
"type": "string",
"default": "583eca2f-fb46-11e1-82cb-f4ce4684ea4c"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"id\": \"583eca2f-fb46-11e1-82cb-f4ce4684ea4c\",\n \"name\": \"Timberwolves\",\n \"market\": \"Minnesota\",\n \"alias\": \"MIN\",\n \"founded\": 1989,\n \"sr_id\": \"sr:team:3426\",\n \"reference\": \"1610612750\",\n \"venue\": {\n \"id\": \"7aed802e-3562-5b73-af1b-3859529f9b95\",\n \"name\": \"Target Center\",\n \"capacity\": 19356,\n \"address\": \"600 First Avenue North\",\n \"city\": \"Minneapolis\",\n \"state\": \"MN\",\n \"zip\": \"55403\",\n \"country\": \"USA\",\n \"sr_id\": \"sr:venue:6930\"\n },\n \"league\": {\n \"id\": \"4353138d-4c22-4396-95d8-5f587d2df25c\",\n \"name\": \"NBA\",\n \"alias\": \"NBA\"\n },\n \"conference\": {\n \"id\": \"7fe7e212-de01-4f8f-a31d-b9f0a95731e3\",\n \"name\": \"WESTERN CONFERENCE\",\n \"alias\": \"WESTERN\"\n },\n \"division\": {\n \"id\": \"12bf14ba-eb16-4c6f-8275-e801b6947c1e\",\n \"name\": \"Northwest\",\n \"alias\": \"NORTHWEST\"\n },\n \"coaches\": [\n {\n \"id\": \"fc135b85-7a10-4df9-b32b-6e23b0ca04a2\",\n \"full_name\": \"Chris Finch\",\n \"first_name\": \"Chris\",\n \"last_name\": \"Finch\",\n \"position\": \"Head Coach\",\n \"experience\": \"5\",\n \"reference\": \"202896\"\n }\n ],\n \"positions\": {\n \"SG\": {\n \"id\": \"0b314789-ce5c-4b4b-af0d-c7152001e5b7\",\n \"name\": \"SG\",\n \"desc\": \"Shooting Guard\",\n \"players\": [\n {\n \"id\": \"d0c7135a-1aea-40cb-ba20-df656de71749\",\n \"full_name\": \"Anthony Edwards\",\n \"primary_position\": \"SG\",\n \"position\": \"G\",\n \"jersey_number\": \"5\",\n \"reference\": \"1630162\",\n \"depth\": 1,\n \"sr_id\": \"sr:player:1876136\"\n }\n ]\n },\n \"PG\": {\n \"id\": \"c631de0f-3422-4c9e-9aa6-88c742038416\",\n \"name\": \"PG\",\n \"desc\": \"Point Guard\",\n \"players\": [\n {\n \"id\": \"460b7264-b98f-483e-b841-59a18c2e4d67\",\n \"full_name\": \"Mike Conley\",\n \"primary_position\": \"PG\",\n \"position\": \"G\",\n \"jersey_number\": \"10\",\n \"reference\": \"201144\",\n \"depth\": 1,\n \"sr_id\": \"sr:player:608194\"\n }\n ]\n },\n \"C\": {\n \"id\": \"1e4023e1-cd67-4a43-bb51-e731b7d4dc2b\",\n \"name\": \"C\",\n \"desc\": \"Center\",\n \"players\": [\n {\n \"id\": \"37fbc3a5-0d10-4e22-803b-baa2ea0cdb12\",\n \"full_name\": \"Rudy Gobert\",\n \"primary_position\": \"C\",\n \"position\": \"C\",\n \"jersey_number\": \"27\",\n \"reference\": \"203497\",\n \"depth\": 1,\n \"sr_id\": \"sr:player:607808\"\n }\n ]\n },\n \"PF\": {\n \"id\": \"70c1dd00-e304-4932-8d8b-09500dfafc01\",\n \"name\": \"PF\",\n \"desc\": \"Power Forward\",\n \"players\": [\n {\n \"id\": \"ab532a66-9314-4d57-ade7-bb54a70c65ad\",\n \"full_name\": \"Karl-Anthony Towns\",\n \"primary_position\": \"C\",\n \"position\": \"C-F\",\n \"jersey_number\": \"32\",\n \"reference\": \"1626157\",\n \"depth\": 1,\n \"sr_id\": \"sr:player:852120\"\n },\n {\n \"id\": \"823b2161-0c34-494c-9d7c-b438152f4f4d\",\n \"full_name\": \"Naz Reid\",\n \"primary_position\": \"C\",\n \"position\": \"C\",\n \"jersey_number\": \"11\",\n \"reference\": \"1629675\",\n \"depth\": 2,\n \"sr_id\": \"sr:player:1796560\"\n }\n ]\n },\n \"SF\": {\n \"id\": \"7b9bacc9-e15b-449c-83e8-ddf9e25b8f66\",\n \"name\": \"SF\",\n \"desc\": \"Small Forward\",\n \"players\": [\n {\n \"id\": \"aa5536d2-4d75-43fb-8df3-47fbf99d3b7c\",\n \"full_name\": \"Jaden McDaniels\",\n \"primary_position\": \"PF\",\n \"position\": \"F\",\n \"jersey_number\": \"3\",\n \"reference\": \"1630183\",\n \"depth\": 1,\n \"sr_id\": \"sr:player:1837406\"\n },\n {\n \"id\": \"5b297372-b2af-445e-a4bc-777982dbc1e3\",\n \"full_name\": \"Joe Ingles\",\n \"primary_position\": \"SF\",\n \"position\": \"F-G\",\n \"jersey_number\": \"7\",\n \"reference\": \"204060\",\n \"depth\": 2,\n \"sr_id\": \"sr:player:611966\"\n }\n ]\n }\n }\n}"
}
},
"schema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "583eca2f-fb46-11e1-82cb-f4ce4684ea4c"
},
"name": {
"type": "string",
"example": "Timberwolves"
},
"market": {
"type": "string",
"example": "Minnesota"
},
"alias": {
"type": "string",
"example": "MIN"
},
"founded": {
"type": "integer",
"example": 1989,
"default": 0
},
"sr_id": {
"type": "string",
"example": "sr:team:3426"
},
"reference": {
"type": "string",
"example": "1610612750"
},
"venue": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "7aed802e-3562-5b73-af1b-3859529f9b95"
},
"name": {
"type": "string",
"example": "Target Center"
},
"capacity": {
"type": "integer",
"example": 19356,
"default": 0
},
"address": {
"type": "string",
"example": "600 First Avenue North"
},
"city": {
"type": "string",
"example": "Minneapolis"
},
"state": {
"type": "string",
"example": "MN"
},
"zip": {
"type": "string",
"example": "55403"
},
"country": {
"type": "string",
"example": "USA"
},
"sr_id": {
"type": "string",
"example": "sr:venue:6930"
}
}
},
"league": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "4353138d-4c22-4396-95d8-5f587d2df25c"
},
"name": {
"type": "string",
"example": "NBA"
},
"alias": {
"type": "string",
"example": "NBA"
}
}
},
"conference": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "7fe7e212-de01-4f8f-a31d-b9f0a95731e3"
},
"name": {
"type": "string",
"example": "WESTERN CONFERENCE"
},
"alias": {
"type": "string",
"example": "WESTERN"
}
}
},
"division": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12bf14ba-eb16-4c6f-8275-e801b6947c1e"
},
"name": {
"type": "string",
"example": "Northwest"
},
"alias": {
"type": "string",
"example": "NORTHWEST"
}
}
},
"coaches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "fc135b85-7a10-4df9-b32b-6e23b0ca04a2"
},
"full_name": {
"type": "string",
"example": "Chris Finch"
},
"first_name": {
"type": "string",
"example": "Chris"
},
"last_name": {
"type": "string",
"example": "Finch"
},
"position": {
"type": "string",
"example": "Head Coach"
},
"experience": {
"type": "string",
"example": "5"
},
"reference": {
"type": "string",
"example": "202896"
}
}
}
},
"positions": {
"type": "object",
"properties": {
"SG": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "0b314789-ce5c-4b4b-af0d-c7152001e5b7"
},
"name": {
"type": "string",
"example": "SG"
},
"desc": {
"type": "string",
"example": "Shooting Guard"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "d0c7135a-1aea-40cb-ba20-df656de71749"
},
"full_name": {
"type": "string",
"example": "Anthony Edwards"
},
"primary_position": {
"type": "string",
"example": "SG"
},
"position": {
"type": "string",
"example": "G"
},
"jersey_number": {
"type": "string",
"example": "5"
},
"reference": {
"type": "string",
"example": "1630162"
},
"depth": {
"type": "integer",
"example": 1,
"default": 0
},
"sr_id": {
"type": "string",
"example": "sr:player:1876136"
}
}
}
}
}
},
"PG": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "c631de0f-3422-4c9e-9aa6-88c742038416"
},
"name": {
"type": "string",
"example": "PG"
},
"desc": {
"type": "string",
"example": "Point Guard"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "460b7264-b98f-483e-b841-59a18c2e4d67"
},
"full_name": {
"type": "string",
"example": "Mike Conley"
},
"primary_position": {
"type": "string",
"example": "PG"
},
"position": {
"type": "string",
"example": "G"
},
"jersey_number": {
"type": "string",
"example": "10"
},
"reference": {
"type": "string",
"example": "201144"
},
"depth": {
"type": "integer",
"example": 1,
"default": 0
},
"sr_id": {
"type": "string",
"example": "sr:player:608194"
}
}
}
}
}
},
"C": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "1e4023e1-cd67-4a43-bb51-e731b7d4dc2b"
},
"name": {
"type": "string",
"example": "C"
},
"desc": {
"type": "string",
"example": "Center"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "37fbc3a5-0d10-4e22-803b-baa2ea0cdb12"
},
"full_name": {
"type": "string",
"example": "Rudy Gobert"
},
"primary_position": {
"type": "string",
"example": "C"
},
"position": {
"type": "string",
"example": "C"
},
"jersey_number": {
"type": "string",
"example": "27"
},
"reference": {
"type": "string",
"example": "203497"
},
"depth": {
"type": "integer",
"example": 1,
"default": 0
},
"sr_id": {
"type": "string",
"example": "sr:player:607808"
}
}
}
}
}
},
"PF": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "70c1dd00-e304-4932-8d8b-09500dfafc01"
},
"name": {
"type": "string",
"example": "PF"
},
"desc": {
"type": "string",
"example": "Power Forward"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "ab532a66-9314-4d57-ade7-bb54a70c65ad"
},
"full_name": {
"type": "string",
"example": "Karl-Anthony Towns"
},
"primary_position": {
"type": "string",
"example": "C"
},
"position": {
"type": "string",
"example": "C-F"
},
"jersey_number": {
"type": "string",
"example": "32"
},
"reference": {
"type": "string",
"example": "1626157"
},
"depth": {
"type": "integer",
"example": 1,
"default": 0
},
"sr_id": {
"type": "string",
"example": "sr:player:852120"
}
}
}
}
}
},
"SF": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "7b9bacc9-e15b-449c-83e8-ddf9e25b8f66"
},
"name": {
"type": "string",
"example": "SF"
},
"desc": {
"type": "string",
"example": "Small Forward"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "aa5536d2-4d75-43fb-8df3-47fbf99d3b7c"
},
"full_name": {
"type": "string",
"example": "Jaden McDaniels"
},
"primary_position": {
"type": "string",
"example": "PF"
},
"position": {
"type": "string",
"example": "F"
},
"jersey_number": {
"type": "string",
"example": "3"
},
"reference": {
"type": "string",
"example": "1630183"
},
"depth": {
"type": "integer",
"example": 1,
"default": 0
},
"sr_id": {
"type": "string",
"example": "sr:player:1837406"
}
}
}
}
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```