Data API · Competitions

List competitions

GET/api/v1/datas/competitions

Returns competitions 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

Parameter	Type	Required	Description
format	string	Required	Response format. Allowed: json, csv, xml.
page	integer	Optional	Page number. Default: 1. Minimum 1.
perPage	integer	Optional	Items per page. Default: 20. Minimum 1; maximum 100.

Response attributes

Attribute	Type	Description
items	array	Competition records.
items[].id	integer	Competition ID.
items[].name	string\|null	Competition name.
items[].shortName	string\|null	Competition short name.
items[].dateStart	string\|null	Competition start date.
items[].dateEnd	string\|null	Competition end date.
items[].competitionFormatId	integer\|null	Competition format ID.
items[].countryId	integer\|null	Country ID.
items[].countryName	string\|null	Country name.
items[].logo	string\|null	Competition logo URL.
items[].providerId	string\|integer\|null	Provider identifier.
items[].seasons	array	Competition seasons.
items[].seasons[].id	integer	Season ID.
items[].seasons[].title	string\|null	Season title.
items[].seasons[].shortTitle	string\|null	Season short title.
items[].seasons[].dateStart	string\|null	Season start date.
items[].seasons[].dateEnd	string\|null	Season end date.
items[].seasons[].yearSeasonId	integer\|null	Year-season ID.
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.