Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Seasons

NBA Seasons Provides a list of all available seasons, including preseasons and postseasons.

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

Update Frequency

TTL / Cache: 4 hours

Data Updates: New seasons appear as they are added to the database.

  • Season statuses update during the day of a status change.

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
start_dateseasonDateStart date of a season

ex. 2022-10-18
end_dateseasonDateEnd date of a season

ex. 2023-04-09
idseasonGUIDUnique season ID

ex. 5027b6ac-731c-4622-8d69-d863ae7c626b
statusseasonStringStatus of a season

ex. inprogress, scheduled, closed
codeseasonStringType of the season

PRE (Preseason), REG (Regular Season), IST (In-Season Tournament), PIT (Play-In Tournament), PST (Postseason)
nameseason - typeStringName of a season type

ex. Regular season, Pre-season, Post-season, Play-in Tournament
yearseasonIntegerYear of a season
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