iSports API – Sports API Documentation & Example Responses for Developers

Schedule & Results (Basic)

Update Time: 2026-05-28 10:59

Introduction

This API endpoint returns the basic information of the match. If you need more details, please refer to Schedule & Results. You can use it with the Match Modify Record endpoint.

Tips: You have access to all the football Common API endpoints with any valid paid football plans.

Related Plans

You can use this api by subscribing plans: Stats, Live Data, Odds, Odds Pro.

Request

Path: /sport/football/schedule/basic
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-05-01. Returns all matches on that date. Historical data is 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.
matchId	string	false	Fetch one or more specific matches by ID. Separate multiple IDs with commas. Maximum 100 IDs per request.

Response

Parameter		Value	Description
matchId		string
leagueId		string
leagueType		int	1: League 2: Cup
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
matchTime		int	Match kick-off time (Unix timestamp, GMT+0)
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)
explain		string	Match special remarks (English). e.g. Match ended 0-3; Torpedo-MAZ Minsk withdrew
extraExplain		object	Nested object containing extra-time and penalty shootout data. Returns 0 for all fields when not applicable.
	kickOff	int	Team that took kick-off 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	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 (used for knockout/two-legged ties) 0: None / not applicable 1: Home 2: Away
neutral		boolean	Neutral venue flag true: Neutral false: Home/away fixture

Example Request

Example Response

This API endpoint returns the basic information of the match. If you need more details, please refer to Schedule & Results. You can use it with the Match Modify Record endpoint.\n\n Tips: You have access to all the football Common API endpoints with any valid paid football plans.

Contact