Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Rankings

NBA Rankings Conference and division rank for each team, including playoff clinching status.

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

Update Frequency

TTL / Cache: 4 hours

Data Updates: Rankings update nightly, 60 minutes after all games end.

  • Teams are marked as clinched 5 minutes after a game is closed when clinching a playoff spot.
📘

Displaying Rankings

Learn how to use Rankings to display conference and division ranks, including playoff clinching status, in our Standings and Rankings integration scenario.


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
idseasonGUIDUnique season ID

ex. 583eca2f-fb46-11e1-82cb-f4ce4684ea4c
typeseasonStringType of the season

PRE (Preseason), REG (Regular Season), IST (In-Season Tournament), PIT (Play-In Tournament), PST (Postseason)
yearseasonIntegerYear of the season
Rankings
AttributeParent ElementTypeDescription
divisionteam - rankIntegerTeam rank number in a division
leagueteam - rankIntegerTeam rank number in a league
clinchedteam - rankStringPostseason clinch status. See our FAQ for more information.

division, conference, playoff_berth, division_playoff_berth, eliminated, play_in_berth, postseason_berth
Team
AttributeParent ElementTypeDescription
idteamGUIDUnique ID of a team

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

ex. Sacramento
nameteamStringTeam name

ex. Kings
referenceteamStringLeague reference ID of a team

ex. 1610612750
sr_idteamGUIDUnique Sportradar ID of a team

ex. sr:team:3415
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 2025

Year of a season in YYYY format

Note: Season year is always the year a season begins. For example, 2024 for the 2024-25 season.

string
enum
required
Defaults to REG

Type of season

PRE (Preseason), REG (Regular Season), IST (In-Season Tournament), PST (Postseason)

Allowed:
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