Data API · Fixtures

List fixtures for a season

GET/api/v1/datas/fixtures/{season_id}

Returns season metadata, teams and paginated fixtures. A fixture moves 1 to 8 to 9 as work progresses, and 9 does not go back: once a match is delivered, its events and score stay available. 10 is final - the match will never be delivered, matchStatusReason says why, and there is nothing to wait for. 11 means work is paused and may resume, so keep checking. 12 means the fixture is in our calendar but no detailed match data is available for it. It is not final: if data becomes available the fixture rejoins the normal sequence. matchStatus describes our analysis of a match, not its score: a fixture can carry a final score while matchStatus is 1 or 12, and hasFinalScore is the field that speaks for the score independently of this one. matchStatusUpdatedAt only moves when the value itself changes.

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
season_id	integer	Required	Season ID Minimum 1.

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.
case	string	Optional	JSON response key style. Default: camelCase. Allowed: camelCase, snake_case.

Response attributes

Attribute	Type	Description
season	object	Requested 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 season.
teams[].id	integer	Team ID.
teams[].name	string\|null	Team name.
teams[].logo	string\|null	Team logo URL.
teams[].shortName	string\|null	Team short name.
teams[].teamType	string\|null	Team type (for example Club or National).
teams[].teamStatus	string\|null	Team status.
teams[].teamColor	string\|null	Team color.
teams[].providerId	string\|integer\|null	Provider identifier.
teams[].fields	array	Home fields used by the team.
teams[].fields[].id	integer	Field ID.
teams[].fields[].title	string\|null	Field title.
teams[].fields[].shortTitle	string\|null	Field short title.
teams[].fields[].dimensionLength	number\|null	Field length.
teams[].fields[].dimensionWidth	number\|null	Field width.
fixtures	array	Fixtures for the requested page.
fixtures[].id	integer	Match ID.
fixtures[].date	string\|null	Match date (YYYY-MM-DD).
fixtures[].round	string\|integer\|null	Competition round.
fixtures[].kickoffTime	string\|null	Kickoff time.
fixtures[].homeSquadId	integer	Home squad ID.
fixtures[].awaySquadId	integer	Away squad ID.
fixtures[].homeTeamScore	integer\|null	Home-team score. Only published once the analysis has produced it; null while a match is still being worked on, so a fixture is never reported as a false 0-0.
fixtures[].awayTeamScore	integer\|null	Away-team score. Only published once the analysis has produced it; null while a match is still being worked on, so a fixture is never reported as a false 0-0.
fixtures[].seasonId	integer	Season ID.
fixtures[].fieldId	integer\|null	Field ID.
fixtures[].dimensionLength	number\|null	Field length.
fixtures[].dimensionWidth	number\|null	Field width.
fixtures[].status	string	Where the match stands in the calendar: Scheduled until kickoff, Ended once the kickoff time has passed, whatever our analysis has done. The same value on every endpoint that publishes it. Use matchStatus for the delivery state.
fixtures[].statusId	integer	Numeric form of status: 1 Scheduled, 7 Ended.
fixtures[].matchStatus	integer\|null	Delivery state: 1 not started, 8 in progress, 9 delivered, 10 rejected (final), 11 on hold (paused, may resume), 12 no detailed match data. Describes our analysis, not the score - see hasFinalScore.
fixtures[].matchStatusLabel	string\|null	Delivery state as a name: not_started, in_progress, delivered, rejected, on_hold, data_unavailable.
fixtures[].matchStatusUpdatedAt	string\|null	UTC timestamp of the last delivery-state change (ISO 8601).
fixtures[].hasFinalScore	boolean	Whether the published score is the final one.
fixtures[].providerId	string\|integer\|null	Provider identifier.
fixtures[].matchStatusReason	string\|null	Why the match will not be delivered or is paused. Populated on matchStatus 10 and 11 only.
fixtures[].homeTeamId	integer	Home team ID.
fixtures[].homeTeam	string\|null	Home team name.
fixtures[].awayTeamId	integer	Away team ID.
fixtures[].awayTeam	string\|null	Away team name.
fixtures[].matchName	string	Home and away team display name.
fixtures[].fieldTitle	string\|null	Field title.
fixtures[].seasonTitle	string\|null	Season title.
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.