Data API · Competitions

Get competition by query parameter

GET/api/v1/datas/competition

Returns one competition, its selected season and related teams.

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
competition_id	integer	Required	Competition ID Minimum 1.
format	string	Required	Response format. Allowed: json, csv, xml.
case	string	Optional	JSON response key style. Default: camelCase. Allowed: camelCase, snake_case.

Response attributes

Attribute	Type	Description
seasonIds	integer[]	IDs of all accessible seasons in the competition.
seasonIds[]	integer	Season ID.
competition	object	Competition metadata.
competition.id	integer	Competition ID.
competition.name	string\|null	Competition name.
competition.shortName	string\|null	Competition short name.
competition.competitionFormatId	integer\|null	Competition format ID.
competition.competitionFormatName	string\|null	Competition format name.
competition.countryId	integer\|null	Country ID.
competition.countryName	string\|null	Country name.
competition.logo	string\|null	Competition logo URL.
season	object	Selected season metadata.
season.id	integer	Season ID.
season.competitionId	integer\|null	Competition ID.
season.yearSeasonId	integer\|null	Year-season ID.
season.title	string\|null	Season title.
season.shortTitle	string\|null	Season short title.
season.dateStart	string\|null	Season start date (YYYY-MM-DD).
season.dateEnd	string\|null	Season end date (YYYY-MM-DD).
teams	array	Teams in the selected season.
teams[].teamId	integer	Team ID.
teams[].teamName	string\|null	Team name.