Data API · Competitions

Get competition by path ID

GET/api/v1/datas/competitions/{competition_id}

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.

Path parameters

Parameter	Type	Required	Description
competition_id	integer	Required	Competition ID Minimum 1.

Query parameters

Parameter	Type	Required	Description
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.
competition.providerId	string\|integer\|null	Provider identifier.
competition.gender	string	Derived competition gender.
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).
season.yearSeasonName	string\|null	Year-season label.
teams	array	Teams in the selected season.
teams[].teamId	integer	Team ID.
teams[].teamName	string\|null	Team name.