iSports API – Sports API Documentation & Example Responses for Developers

Schedule & Results

Thời gian cập nhật: 2026-06-29 15:30

Introduction

• This API endpoint returns match schedule and result data for live animation. The response covers matches within the past 4 hours and the next 24 hours.

• Use it alongside the Configuration Instructions and Time line endpoints for full live animation integration.

Related Plans

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

Request

Path: /sport/football/liveanimation/schedule
Method: GET
Calls: This interface is limited to 60 seconds/call;
Recommend Calls: 5 minutes/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. English Premier League
leagueShortName		string	League or cup short name (English) e.g. ENG PR
leagueColor		string	League brand color (RGB hex) e.g. #800080
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	First or second half actual kick-off time (Unix timestamp, GMT+0). Returns 0 when not yet started
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. Empty string if not available
awayRank		string	Away team's current league standing. Empty string if not available
season		string	Season identifier e.g. 2026 or 2019-2020
round		string	Round number or cup stage. Empty string if not applicable
group		string	Group stage label e.g. A. Empty string if not applicable
location		string	Match venue name. Empty string if not available
weather		string	Weather condition at the venue e.g. Cloudy, Clear
temperature		string	Temperature at the venue e.g. 11°C or 14°C ~ 15°C
explain		string	Match special remarks (English). Empty string if none e.g. Match ended 0-3; Torpedo-MAZ Minsk withdrew
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 for this match true: Available false: Not available
neutral		boolean	Neutral venue flag true: Neutral venue false: Home/away fixture

Example Request

Example Response

• This API endpoint returns match schedule and result data for live animation. The response covers matches within the past 4 hours and the next 24 hours. \n\n • Use it alongside the Configuration Instructions and Time line endpoints for full live animation integration.

Liên hệ