---
updatedAt: 2025-11-18T16:12:28.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/basketball/v7/llms.txt
---
# League Hierarchy
**NBA League Hierarchy** League, conference, division, and team identification and association 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}/league/hierarchy.{format}": {
"get": {
"summary": "League Hierarchy",
"description": "**NBA League Hierarchy** League, conference, division, and team identification and association information.",
"operationId": "nba-league-hierarchy",
"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": "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 \"league\": {\n \"id\": \"4353138d-4c22-4396-95d8-5f587d2df25c\",\n \"name\": \"NBA\",\n \"alias\": \"NBA\"\n },\n \"conferences\": [\n {\n \"id\": \"7fe7e212-de01-4f8f-a31d-b9f0a95731e3\",\n \"name\": \"WESTERN CONFERENCE\",\n \"alias\": \"WESTERN\",\n \"divisions\": [\n {\n \"id\": \"f074cb3e-90cf-42e1-8067-cdbcd99ec230\",\n \"name\": \"Pacific\",\n \"alias\": \"PACIFIC\",\n \"teams\": [\n {\n \"id\": \"583ec825-fb46-11e1-82cb-f4ce4684ea4c\",\n \"name\": \"Warriors\",\n \"market\": \"Golden State\",\n \"alias\": \"GSW\",\n \"sr_id\": \"sr:team:3428\",\n \"reference\": \"1610612744\",\n \"venue\": {\n \"id\": \"938016dc-9e1d-4abc-88f5-3a7d772332e6\",\n \"name\": \"Chase Center\",\n \"capacity\": 18064,\n \"address\": \"1 Warriors Way\",\n \"city\": \"San Francisco\",\n \"state\": \"CA\",\n \"zip\": \"94158\",\n \"country\": \"USA\",\n \"sr_id\": \"sr:venue:44446\"\n }\n },\n {\n \"id\": \"583ecae2-fb46-11e1-82cb-f4ce4684ea4c\",\n \"name\": \"Lakers\",\n \"market\": \"Los Angeles\",\n \"alias\": \"LAL\",\n \"sr_id\": \"sr:team:3427\",\n \"reference\": \"1610612747\",\n \"venue\": {\n \"id\": \"792ec100-691e-5e16-8ef8-79b2b6ee38ba\",\n \"name\": \"Crypto.com Arena\",\n \"capacity\": 18997,\n \"address\": \"1111 S. Figueroa Street\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90015\",\n \"country\": \"USA\",\n \"sr_id\": \"sr:venue:6008\"\n }\n },\n {\n \"id\": \"583ecdfb-fb46-11e1-82cb-f4ce4684ea4c\",\n \"name\": \"Clippers\",\n \"market\": \"LA\",\n \"alias\": \"LAC\",\n \"sr_id\": \"sr:team:3425\",\n \"reference\": \"1610612746\",\n \"venue\": {\n \"id\": \"792ec100-691e-5e16-8ef8-79b2b6ee38ba\",\n \"name\": \"Crypto.com Arena\",\n \"capacity\": 18997,\n \"address\": \"1111 S. Figueroa Street\",\n \"city\": \"Los Angeles\",\n \"state\": \"CA\",\n \"zip\": \"90015\",\n \"country\": \"USA\",\n \"sr_id\": \"sr:venue:6008\"\n }\n },\n {\n \"id\": \"583ecfa8-fb46-11e1-82cb-f4ce4684ea4c\",\n \"name\": \"Suns\",\n \"market\": \"Phoenix\",\n \"alias\": \"PHX\",\n \"sr_id\": \"sr:team:3416\",\n \"reference\": \"1610612756\",\n \"venue\": {\n \"id\": \"1d2e59b2-2479-5f84-a6a7-e82f65dd8442\",\n \"name\": \"Footprint Center\",\n \"capacity\": 18422,\n \"address\": \"201 E. Jefferson Street\",\n \"city\": \"Phoenix\",\n \"state\": \"AZ\",\n \"zip\": \"85004\",\n \"country\": \"USA\",\n \"sr_id\": \"sr:venue:6938\"\n }\n },\n {\n \"id\": \"583ed0ac-fb46-11e1-82cb-f4ce4684ea4c\",\n \"name\": \"Kings\",\n \"market\": \"Sacramento\",\n \"alias\": \"SAC\",\n \"sr_id\": \"sr:team:3413\",\n \"reference\": \"1610612758\",\n \"venue\": {\n \"id\": \"2e687b9a-c7a7-487c-85b4-43479abc8458\",\n \"name\": \"Golden 1 Center\",\n \"capacity\": 17608,\n \"address\": \"500 David J. Stern Walkway\",\n \"city\": \"Sacramento\",\n \"state\": \"CA\",\n \"zip\": \"95814\",\n \"country\": \"USA\",\n \"sr_id\": \"sr:venue:6942\"\n }\n }\n ]\n }\n ]\n }\n ]\n}\n"
}
},
"schema": {
"type": "object",
"properties": {
"league": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "4353138d-4c22-4396-95d8-5f587d2df25c"
},
"name": {
"type": "string",
"example": "NBA"
},
"alias": {
"type": "string",
"example": "NBA"
}
}
},
"conferences": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "7fe7e212-de01-4f8f-a31d-b9f0a95731e3"
},
"name": {
"type": "string",
"example": "WESTERN CONFERENCE"
},
"alias": {
"type": "string",
"example": "WESTERN"
},
"divisions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "f074cb3e-90cf-42e1-8067-cdbcd99ec230"
},
"name": {
"type": "string",
"example": "Pacific"
},
"alias": {
"type": "string",
"example": "PACIFIC"
},
"teams": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "583ec825-fb46-11e1-82cb-f4ce4684ea4c"
},
"name": {
"type": "string",
"example": "Warriors"
},
"market": {
"type": "string",
"example": "Golden State"
},
"alias": {
"type": "string",
"example": "GSW"
},
"sr_id": {
"type": "string",
"example": "sr:team:3428"
},
"reference": {
"type": "string",
"example": "1610612744"
},
"venue": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "938016dc-9e1d-4abc-88f5-3a7d772332e6"
},
"name": {
"type": "string",
"example": "Chase Center"
},
"capacity": {
"type": "integer",
"example": 18064,
"default": 0
},
"address": {
"type": "string",
"example": "1 Warriors Way"
},
"city": {
"type": "string",
"example": "San Francisco"
},
"state": {
"type": "string",
"example": "CA"
},
"zip": {
"type": "string",
"example": "94158"
},
"country": {
"type": "string",
"example": "USA"
},
"sr_id": {
"type": "string",
"example": "sr:venue:44446"
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```