Data API · Fixtures

Get a match squad

GET/api/v1/datas/squad/{match_id}

Returns match information, lineups and formations for both 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
match_id	integer	Required	Match 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
match	object	Match metadata.
match.id	integer	Match ID.
match.homeSquadId	integer	Home squad ID.
match.awaySquadId	integer	Away squad ID.
match.homeTeamScore	integer\|null	Home-team score. Only published once the analysis has produced it; null while the match is still being worked on, so a fixture is never reported as a false 0-0.
match.awayTeamScore	integer\|null	Away-team score. Only published once the analysis has produced it; null while the match is still being worked on, so a fixture is never reported as a false 0-0.
match.status	string\|null	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.
match.statusId	integer	Numeric form of status: 1 Scheduled, 7 Ended.
match.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.
match.matchStatusReason	string\|null	Why the match will not be delivered or is paused. Populated on matchStatus 10 and 11 only.
match.matchStatusUpdatedAt	string\|null	UTC timestamp of the last delivery-state change (ISO 8601).
match.hasFinalScore	boolean	Whether the published score is the final one.
match.providerId	string\|null	Provider identifier.
match.competitionId	integer\|null	Competition ID.
homeSquad	object	Home squad metadata.
homeSquad.id	integer	Home squad ID.
homeSquad.teamId	integer	Home team ID.
homeSquad.isHome	boolean	Whether this is the home squad.
homeSquad.formation	string\|null	Team formation.
awaySquad	object	Away squad metadata.
awaySquad.id	integer	Away squad ID.
awaySquad.teamId	integer	Away team ID.
awaySquad.isHome	boolean	Whether this is the home squad.
awaySquad.formation	string\|null	Team formation.
homePlayers	array	Home-team players.
homePlayers[].id	integer	Player ID.
homePlayers[].name	string\|null	Player name.
homePlayers[].number	integer\|null	Squad number.
homePlayers[].starter	boolean	Whether the player started the match.
homePlayers[].matchPosition	string\|null	Match position.
homePlayers[].position1	string\|null	Primary position.
homePlayers[].providerId	string\|null	Provider identifier.
homePlayers[].nationalities	array	Player nationalities.
homePlayers[].nationalities[].id	integer	Nationality ID.
homePlayers[].nationalities[].name	string\|null	Nationality name.
homePlayers[].nationalities[].shortName	string\|null	Nationality short name.
homePlayers[].positions	array	Player positions.
homePlayers[].positions[].id	integer	Position ID.
homePlayers[].positions[].name	string\|null	Position name.
homePlayers[].positions[].shortName	string\|null	Position short name.
awayPlayers	array	Away-team players.
awayPlayers[].id	integer	Player ID.
awayPlayers[].name	string\|null	Player name.
awayPlayers[].number	integer\|null	Squad number.
awayPlayers[].starter	boolean	Whether the player started the match.
awayPlayers[].matchPosition	string\|null	Match position.
awayPlayers[].position1	string\|null	Primary position.
awayPlayers[].providerId	string\|null	Provider identifier.
awayPlayers[].nationalities	array	Player nationalities.
awayPlayers[].nationalities[].id	integer	Nationality ID.
awayPlayers[].nationalities[].name	string\|null	Nationality name.
awayPlayers[].nationalities[].shortName	string\|null	Nationality short name.
awayPlayers[].positions	array	Player positions.
awayPlayers[].positions[].id	integer	Position ID.
awayPlayers[].positions[].name	string\|null	Position name.
awayPlayers[].positions[].shortName	string\|null	Position short name.