Data API · Reference
List year seasons
GET/api/v1/datas/year-season
Returns year-season records available to the authenticated account.
Bearer authentication required · service: data_apiReference only — this page never sends API requests or exposes token controls.
Response formats
When format is listed below, use json for the response documented here, or csv and xml for downloads. JSON uses camelCase by default; set case=snake_case when supported for legacy key names. Nested response fields use dot notation; [] denotes an array item and {key} a dynamic object key.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | Required | Response format. Allowed: json, csv, xml. |
| lang | string | Optional | Language code. Default: en. Maximum 10 characters. |
| page | integer | Optional | Page number. Default: 1. Minimum 1. |
| perPage | integer | Optional | Items per page. Default: 20. Minimum 1; maximum 100. |
| case | string | Optional | JSON response key style. Default: camelCase. Allowed: camelCase, snake_case. |
Response attributes
| Attribute | Type | Description |
|---|---|---|
| items | array | Year-season records. |
| items[].id | integer | Year-season ID. |
| items[].iId | integer|null | Legacy year-season identifier. |
| items[].years | string|null | Year-season label. |
| meta | object | Pagination metadata. |
| meta.currentPage | integer | Current page number. |
| meta.perPage | integer | Requested page size. |
| meta.total | integer | Total number of matching records. |
| meta.lastPage | integer | Last available page number. |
| meta.from | integer|null | Position of the first item on this page. |
| meta.to | integer|null | Position of the last item on this page. |
| links | object | Pagination URLs. |
| links.first | string | URL of the first page. |
| links.last | string | URL of the last page. |
| links.previous | string|null | URL of the previous page, when available. |
| links.next | string|null | URL of the next page, when available. |