iSports API – Sports API Documentation & Example Responses for Developers

Schedule & Results

Update Time: 2026-07-09 10:43

Introduction

• This API endpoint returns schedule and result information for basketball matches from the past two months up to future fixtures, filtered by date or leagueId.

• One of the following parameters is required: date, leagueId, or matchId — these three cannot be used together in the same request. The season parameter can only be used in combination with leagueId, to retrieve matches for a specific season; if omitted, the current season is returned by default.

• You can use it with the Match Modify Record endpoint to keep locally stored match data in sync.

Related Plans

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

Request

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

Parameter	Value	Required	Description
date	string	false	Match date, format yyyy-MM-dd, e.g. 2026-07-01. Returns matches scheduled for the specified date (GMT+0 00:00–23:59).
leagueId	string	false	Filter by a specific league or cup ID. Returns schedule data for the current season of the specified league or cup.
season	string	false	Used together with leagueId to retrieve matches for a specific season, e.g. 25-26. Returns the current season by default.
matchId	string	false	Filter by a specific match ID.

Response

Parameter	Value	Description
matchId	string	Unique ID of the match.
leagueId	string	Unique ID of the league or cup.
leagueName	string	Short name of the league or cup, e.g. NBA.
quarterCount	int	2: match has 2 quarters 4: match has 4 quarters
matchTime	int	Match scheduled time (Unix timestamp, GMT+0).
status	int	0: Not started 1: First quarter 2: Second quarter 3: Third quarter 4: Fourth quarter 5: First OT 6: Second OT 7: Third OT 50: Half-time -1: Finished -2: TBD -3: Interrupted -4: Cancelled -5: Postponed
quarterRemainTime	string	Remaining time in the current quarter, e.g. 06:43.
homeId	string	Unique ID of the home team.
homeName	string	Name of the home team.
homeRank	int	League ranking of the home team. Returns 0 if not ranked.
awayId	string	Unique ID of the away team.
awayName	string	Name of the away team.
awayRank	int	League ranking of the away team. Returns 0 if not ranked.
homeScore	int	Total score of the home team.
awayScore	int	Total score of the away team.
homeFirstQuarterScore	int	Score of the home team in the 1st quarter.
awayFirstQuarterScore	int	Score of the away team in the 1st quarter.
homeSecondQuarterScore	int	Score of the home team in the 2nd quarter.
awaySecondQuarterScore	int	Score of the away team in the 2nd quarter.
homeThirdQuarterScore	int	Score of the home team in the 3rd quarter.
awayThirdQuarterScore	int	Score of the away team in the 3rd quarter.
homeFourthQuarterScore	int	Score of the home team in the 4th quarter.
awayFourthQuarterScore	int	Score of the away team in the 4th quarter.
overTimeCount	int	Number of overtime periods played.
homeFirstOverTimeScore	int	Score of the home team in the 1st overtime.
awayFirstOverTimeScore	int	Score of the away team in the 1st overtime.
homeSecondOverTimeScore	int	Score of the home team in the 2nd overtime.
awaySecondOverTimeScore	int	Score of the away team in the 2nd overtime.
homeThirdOverTimeScore	int	Score of the home team in the 3rd overtime.
awayThirdOverTimeScore	int	Score of the away team in the 3rd overtime.
leagueSeason	string	Season of the league, e.g. 25-26.
matchType	int	1: Regular season 2: Post season 3: Pre-season - 1: Unclassified
playoffsId	string	ID of the playoff round. Only present for playoff matches.
stageId	string	ID of the cup stage. Only present for cup matches.
hasStats	boolean	true: match stats data is available false: match stats data is not available
explain	string	The latest live-text event description for the match, e.g. [Spurs] [SAS] Team Timeout: Regular.
roundType	string	Round description. For cups, e.g. Groups. For league playoffs, e.g. Western 1 Round.
group	string	Group name of the cup, e.g. A.
neutral	boolean	true: match is played at a neutral venue false: match is not played at a neutral venue

Example Request

Example Response

• This API endpoint returns schedule and result information for basketball matches from the past two months up to future fixtures, filtered by date or leagueId. \n\n • One of the following parameters is required: date, leagueId, or matchId — these three cannot be used together in the same request. The season parameter can only be used in combination with leagueId, to retrieve matches for a specific season; if omitted, the current season is returned by default.\n\n • You can use it with the Match Modify Record endpoint to keep locally stored match data in sync.

Contact