Developers · API Reference
API v1

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_api

Reference 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

ParameterTypeRequiredDescription
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

AttributeTypeDescription
itemsarrayYear-season records.
items[].idintegerYear-season ID.
items[].iIdinteger|nullLegacy year-season identifier.
items[].yearsstring|nullYear-season label.
metaobjectPagination metadata.
meta.currentPageintegerCurrent page number.
meta.perPageintegerRequested page size.
meta.totalintegerTotal number of matching records.
meta.lastPageintegerLast available page number.
meta.frominteger|nullPosition of the first item on this page.
meta.tointeger|nullPosition of the last item on this page.
linksobjectPagination URLs.
links.firststringURL of the first page.
links.laststringURL of the last page.
links.previousstring|nullURL of the previous page, when available.
links.nextstring|nullURL of the next page, when available.