Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

League Hierarchy

NBA League Hierarchy League, conference, division, and team identification and association information.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 4 hours

Data Updates: Hierarchy updates will appear as they are updated in the database.


Data Points

League
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league

ex. NBA
idleagueGUIDUnique ID of a league

ex. 4353138d-4c22-4396-95d8-5f587d2df25c
nameleagueStringName of a league

ex. NBA
aliasconferenceStringAlias of a conference

ex. EASTERN
idconferenceGUIDUnique ID of a conference

ex. 3960cfac-7361-4b30-bc25-8d393de6f62f
nameconferenceStringName of a conference

ex. EASTERN CONFERENCE
aliasdivisionStringAlias of a division

ex. SOUTHEAST
iddivisionGUIDUnique ID of a division

ex. 54dc7348-c1d2-40d8-88b3-c4c0138e085d
namedivisionStringName of a division

ex. Southeast
Team
AttributeParent ElementTypeDescription
aliasteamStringAbbreviation of a team

ex. SAC (Sacramento)
championship_seasonsteamStringYears of championship seasons

ex. 1991, 1992, 1993, 1996, 1997, 1998
championships_wonteamIntegerNumber of championships won
conference_titlesteamIntegerNumber of conference titles
division_titlesteamIntegerNumber of division titles
gleague_affiliateteamStringA team's G League (NBA Development League) affiliate

ex. Iowa Wolves
foundedteamIntegerYear team was founded

ex. 1946
general_managerteamStringTeam general manager

ex. Monte McNair
idteamGUIDUnique ID of a team

ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketteamStringMarket name of a team

ex. Sacramento
mascotteamStringTeam mascot

ex. Slamson the Lion
nameteamStringTeam name

ex. Kings
nicknamesteamStringTeam nicknames

ex. Wolves, T-Wolves
ownerteamStringTeam owner

ex. Vivek Ranadivé
playoff_appearancesteamIntegerNumber of playoff appearances
presidentteamStringTeam president

ex. John Rinehart
retired_numbersteamStringTeam retired jersey numbers

ex. 1, 2, 4, 6, 11, 12, 14, 16, 21, 27, 44
referenceteamStringLeague reference ID of a team

ex. 201939
sponsorteamStringTeam sponsor

ex. Dialpad
hex_colorteam_colorStringTeam color HEX value

ex. #ffc62f
typeteam_colorStringType of team color

primary, secondary
redteam_color - rgb-colorIntegerTeam RGB color code - Red

ex. 255
greenteam_color - rgb-colorIntegerTeam RGB color code - Green

ex. 198
blueteam_color - rgb-colorIntegerTeam RGB color code - Blue

ex. 47
sr_idteamGUIDUnique Sportradar ID of a team

ex. sr:team:3415
Venue
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue

ex. 500 David J. Stern Walkway
capacityvenueIntegerCapacity of a venue

ex. 17608
cityvenueStringCity of a venue

ex. Sacramento
countryvenueStringCountry of a venue

ex. USA
idvenueGUIDUnique ID of a venue

ex. 2e687b9a-c7a7-487c-85b4-43479abc8458
latvenue - locationDecimalLatitude of a venue

ex. 29.684735
lngvenue - locationDecimalLongitude of a venue

ex. -95.410725
namevenueStringName of a venue

ex. Golden 1 Center
sr_idvenueGUIDUnique Sportradar ID of a venue

ex. sr:venue:6942
statevenueStringState or province of a venue

ex. CA
zipvenueStringZIP code of a venue

ex. 95814
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

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)

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json