A query to this endpoint without an id parameter will return a list of all the competition level's seasons and their id codes, including an overview of stat granularity availability. Passing an id parameter will return all metadata for the season as well as a list of sublevels and playoff results if available.
Please note that this endpoint can be used synonymously as seasons.
Controls the data format by which query results are returned. Acceptable values are xml, json or php. The default value is json. Example: https://api4.natst.at/xxxx-xxxxxx/seasons/nba/xml
season
optional
range
A valid season code (the year when a particular season completes) in YYYY format. A list of available values can be retrieved from the seasons endpoint. Example: https://api4.natst.at/xxxx-xxxxxx/seasons/nba/2025
Query
Name
Required
Type
Description
key
required
path
A valid API key in xxxx-xxxxxx format. This must be the first path parameter. Example: https://api4.natst.at/xxxx-xxxxxx/...
Path
Name
Required
Type
Description
endpoint
required
path
The API endpoint to query. This must be the second path parameter. Example: https://api4.natst.at/xxxx-xxxxxx/seasons/...
level
required
path
One of 30 NatStat data services to query. A full list can be found in the documentation. This must be the third path parameter. Example: https://api4.natst.at/xxxx-xxxxxx/seasons/nhl/...
