iSports API – Sports API Documentation & Example Responses for Developers

Lineups

Update Time: 2026-08-07 09:53

Introduction

• This API endpoint returns basketball match lineups and injury reports. By default, it returns the official confirmed starting lineup once it becomes available from the data source — availability depends on the data source and is not guaranteed for every match.

• To retrieve predicted lineups instead, set isPreview=true, which returns predicted lineups, bench players, and injury reports for matches in the last 24 hours and the next 48 hours.

• Supported League Coverage: Click Here

Related Plans

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

Request

Path: /sport/basketball/lineups
Method: GET
Calls: This interface is limited to 60 seconds/call;
Recommend Calls: 12 hours/call
Parameters:

Parameter	Value	Required	Description
matchId	string	false	Filter by a specific match ID. If omitted, returns lineups and injuries for all applicable matches.
isPreview	boolean	false	true: returns predicted lineups (last 24 hours and next 48 hours)

Response

Parameter		Value	Description
matchId		string	Unique ID of the match.
homeLineup		list	Starting lineup of the home team.
	playerId	string	Unique ID of the player.
	number	int	Jersey number.
	name	string	Player name.
	position	string	Player position.
homeBackup		list	Bench players of the home team. Same structure as homeLineup.
awayLineup		list	Starting lineup of the away team. Same structure as homeLineup.
awayBackup		list	Bench players of the away team. Same structure as homeLineup.
homeInjury		list	Injury report for the home team.
	playerId	string	Unique ID of the player.
	name	string	Player name.
	position	string	Player position.
	date	string	Date the injury was reported, format yyyy-MM-dd.
awayInjury		list	Injury report for the away team. Same structure as homeInjury.

Example Request

Example Response

• This API endpoint returns basketball match lineups and injury reports. By default, it returns the official confirmed starting lineup once it becomes available from the data source — availability depends on the data source and is not guaranteed for every match. \n\n • To retrieve predicted lineups instead, set isPreview=true, which returns predicted lineups, bench players, and injury reports for matches in the last 24 hours and the next 48 hours. \n\n • Supported League Coverage: Click Here

Contact