iSports API – Sports API Documentation & Example Responses for Developers

Lineups

Update Time: 2026-06-29 15:31

Introduction

• This API endpoint returns starting lineups and substitute lists for football matches.

• By default, returns lineups for matches within the past 24 hours to the present. Use the isPreview parameter to access predicted or official lineups for upcoming matches.

• If a match has no formation data, all player position values return 0. Substitute players also return position 0 regardless of formation.

Related Plans

You can use this api by subscribing plans: Live Data.

Request

Path: /sport/football/lineups
Method: GET
Calls: This interface is limited to 60 seconds/call;
Recommend Calls: 90 seconds/call
Parameters:

Parameter	Value	Required	Description
matchId	string	false	Filter by match ID. Returns lineup for the specified match, or null if no lineup data is available
isPreview	string,Fixed value: true	false	Optional. When set to true, returns the latest available lineup — either Predicted or Official. Without matchId: Returns lineups for matches within the past 24 hours and the next 12 hours. With matchId: Returns lineup for a specific match within a ±3-day window. Auto-update: Returns a Predicted lineup initially, then automatically switches to the Official lineup once released (typically 60 minutes before kick-off).

Response

Parameter		Value	Description
matchId		string
homeFormation		string	Home team formation e.g. 433, 4231
awayFormation		string	Away team formation e.g. 4231, 352
homeLineup		list	List of home team starting players (11 players)
	playerId	string
	name	string	Player name (English) e.g. Filip Jorgensen
	number	int	Player jersey number
	position	int	Player's positional row in the formation, based on number of formation columns. Returns 0 for all players when no formation data is available, and for all substitute players. 3-column formation: 0: Goalkeeper 1: Defender 2: Midfielder 3: Forward. 4-column formation: 0: Goalkeeper 1: Defender 2: Defensive midfielder 3: Offensive midfielder 4: Forward. 5-column formation: 0: Goalkeeper 1: Defender 2: Defensive midfielder 3: Midfielder 4: Offensive midfielder 5: Forward
	isCaptain	int	Captain flag true: This player is the captain false: Not the captain
awayLineup		list	List of away team starting players. Same structure as homeLineup
homeBackup		list	List of home team substitute players. Same structure as homeLineup. All substitute players return position = 0
awayBackup		list	List of away team substitute players. Same structure as homeLineup. All substitute players return position = 0

Example Request

Example Response

• This API endpoint returns starting lineups and substitute lists for football matches.\n\n • By default, returns lineups for matches within the past 24 hours to the present. Use the isPreview parameter to access predicted or official lineups for upcoming matches.\n\n • If a match has no formation data, all player position values return 0. Substitute players also return position 0 regardless of formation.

Contact