iSports API – Sports API Documentation & Example Responses for Developers

Livescores for Today

Update Time: 2026-05-28 15:32

Introduction

• This API endpoint returns livescores for all football matches on the current day (GMT+0 00:00–23:59).

• Use it alongside the Livescores Changes endpoint to receive incremental updates and avoid repeated full pulls.

Related Plans

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

Request

Path: /sport/football/livescores
Method: GET
Calls: This interface is limited to 10 second/call;
Recommend Calls: 1 minute/call

Response

Parameter		Value	Description
matchId		string
leagueType		int	1: League 2: Cup
leagueId		string
leagueName		string	League or cup full name (English) e.g. Copa Libertadores
leagueShortName		string	League or cup short name (English) e.g. CON CLA
leagueColor		string	League brand color (RGB hex) e.g. #8EAD12
subLeagueId		string	Sub-league ID. Empty string if not applicable
subLeagueName		string	Currently active sub-league name. Empty string if not applicable e.g. Western Play-off
matchTime		int	Match kick-off time (Unix timestamp, GMT+0)
halfStartTime		int	Actual kick-off time of the first or second half (Unix timestamp, GMT+0) state=1: Returns first half kick-off time state=3: Returns second half kick-off time All other states return 0 To calculate minutes elapsed: current time − halfStartTime (for second half, add 45 minutes to the result)
status		int	0: Not started 1: First half 2: Half-time break 3: Second half 4: Extra time 5: Penalty -1: Finished -10: Cancelled -11: TBD -12: Terminated -13: Interrupted -14: Postponed
homeId		string	Home team ID
homeName		string	Home team name (English)
awayId		string	Away team ID
awayName		string	Away team name (English)
homeScore		int	Home team full-time goals (default 0)
awayScore		int	Away team full-time goals (default 0)
homeHalfScore		int	Home team first-half goals (default 0)
awayHalfScore		int	Away team first-half goals (default 0)
homeRed		int	Home team red cards (default 0)
awayRed		int	Away team red cards (default 0)
homeYellow		int	Home team yellow cards (default 0)
awayYellow		int	Away team yellow cards (default 0)
homeCorner		int	Home team corners (default 0)
awayCorner		int	Away team corners (default 0)
homeRank		string	Home team's current league standing e.g. BRA D1-1
awayRank		string	Away team's current league standing e.g. COL D1A-2
season		string	Season identifier e.g. 2026 or 2019-2020
stageId		string	Cup stage ID; references the Cup Stage Profile endpoint. Only returned for cup matches; empty for league matches
round		string	Round number or stage name e.g. Group stage, 10
group		string	Group label e.g. F. Empty string if not applicable
location		string	Match venue name e.g. Allianz Parque. Empty string if not available
weather		string	Weather condition at the venue e.g. Cloudy, Clear
temperature		string	Temperature at the venue e.g. 17℃～18℃
explain		string	Match special remarks (English). Empty string if none
extraExplain		object	Nested object containing extra-time and penalty shootout data. All fields return 0 when not applicable
	kickOff	int	Team that took kick-off 0: Not started 1: Home 2: Away
	minute	int	Minutes played in regular time
	homeScore	int	Home team regular time score
	awayScore	int	Away team regular time score
	extraTimeStatus	int	Extra time status 0: No extra time 1: Extra time ended (regular match; includes regular time score) 2: Extra time ended (special match e.g. beach/indoor football; excludes regular time score) 3: Match currently in extra time
	extraHomeScore	int	Home team extra-time score
	extraAwayScore	int	Away team extra-time score
	penHomeScore	int	Home team penalty shootout score
	penAwayScore	int	Away team penalty shootout score
	twoRoundsHomeScore	int	Home team two-legged aggregate score
	twoRoundsAwayScore	int	Away team two-legged aggregate score
	winner	int	Match winner (knockout/two-legged ties) 0: None / not applicable 1: Home 2: Away
hasLineup		boolean	Indicates whether lineup data is available true: Available false: Not available
neutral		boolean	Neutral venue flag true: Neutral venue false: Home/away fixture
injuryTime		int	Cumulative injury time (minutes). Calculate first-half injury time as injuryTime - 45 when over 45; second-half injury time as injuryTime - 90 when over 90. Returns 0 when not in injury time
var		string	VAR review event description. Empty string if none
updateTime		int	Timestamp of the last data update (Unix timestamp, GMT+0)

Example Request

Example Response

• This API endpoint returns livescores for all football matches on the current day (GMT+0 00:00–23:59). \n\n • Use it alongside the Livescores Changes endpoint to receive incremental updates and avoid repeated full pulls.

Contact