iSports API – Sports API Documentation & Example Responses for Developers

Schedule & Results

Update Time: 2026-05-28 16:43

Introduction

• This API endpoint returns match schedule and result data filtered by date, league, or specific match ID.

• At least one of the parameters date, leagueId, or matchId is required. These three parameters cannot be used together at the same time.

• Use it alongside the Match Modify Record endpoint to detect and sync kick-off time changes.

Related Plans

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

Request

Path: /sport/football/schedule
Method: GET
Calls: This interface is limited to 60 second/call;
Recommend Calls: 12 hour/call
Parameters: The request path needs at least one parameter (date, leagueId, and matchId ) to retrieve correct response. These three parameters can not be used at the same time.

Parameter	Value	Required	Description
date	string	false	Match date in yyyy-MM-dd format (GMT+0), e.g. 2026-06-01. Returns all matches on that date. Historical data limited to the past month
leagueId	string	false	Filter matches by league or cup ID. Returns the current season by default
season	string	false	Filter by season; must be used with leagueId. e.g. 2025-2026. Defaults to current season if omitted
subLeagueId	string	false	Filter by sub-league; must be used with leagueId
stageId	string	false	Filter by cup stage; must be used with leagueId
matchId	string	false	Fetch one or more matches by ID. Separate multiple IDs with commas. Maximum 100 IDs per request

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. #FF3333
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. 1
awayRank		string	Away team's current league standing e.g. 9
season		string	Season identifier e.g. 2025-2026 or 2026
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. 1, Group stage
group		string	Group label e.g. F. Empty string if not applicable
location		string	Match venue name e.g. Anfield. 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 match schedule and result data filtered by date, league, or specific match ID.\n\n • At least one of the parameters date, leagueId, or matchId is required. These three parameters cannot be used together at the same time.\n\n • Use it alongside the Match Modify Record endpoint to detect and sync kick-off time changes.

Contact