seasons
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.
All WNBA seasons
https://api.natstat.com/v1/seasons/WNBA/?key=XXXX-XXXXXX&format=xml
Download sample
Parameters
Path
| Name | Required | Type | Description |
|---|---|---|---|
level |
required | string | The competition level to retrieve information for. A full glossary can be found in the Path Parameters section |
Query
| Name | Required | Type | Description |
|---|---|---|---|
key |
required | string | A valid API key in XXXX-XXXXXX format |
format |
optional | string | The preferred data format: xml, json or php (presented as a SimpleXML object). The default is json |
max |
optional | number | The number of results per page to return. The default value is 100, and the maximum allowed parameter value is 1000. This value is echoed back as Max_Results in the meta block |
page |
optional | number | The pagination page number. This value is echoed back as Page in the meta block. The meta block also contains the Total_Results of the query. If there are further results, a fully-formed Next_Page URI containing a pre-filled &page=X value will be returned |
id |
optional | number | A valid season ID code, which returns details for that season (A list of available seasons can be retrieved from this endpoint by not passing an ID code.) |
sublevel |
optional | number | A valid sublevel (leagues, conferences) ID code. A list of sublevels can be retrieved from the glossary endpoint |
Response
| Name | Required | Type | Description |
|---|---|---|---|
ID |
number | The unique identifier for the record | |
Name |
string | The full name of the season, i.e. 2008-09 or 2014 | |
CurrentSeason |
number | The current season for the league in YYYY format | |
FullStatsAvailable |
boolean | Whether statistics are available for the season, in Y/N format | |
PerfsAvailable |
boolean | Whether team and player performances are available, in Y/N format | |
PBPAvailable |
boolean | Whether play by play is available, in Y/N format |