iSports API – Sports API Documentation & Example Responses for Developers

Schedule & Results (Basic)

Update Time: 2026-07-09 09:22

Introduction

• This API endpoint returns basic schedule and result information for basketball matches. You can use it with the Match Modify Record endpoint to track any post-publication corrections to match data.

• 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.

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

Related Plans

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

Request

Path: /sport/basketball/schedule/basic
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.
leagueId	string	false	Filter by a specific league or cup ID.
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. Only matches from the current season are supported.

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	Number of quarters in the match. 2: 2-quarter format 4: 4-quarter format
matchTime	int	Scheduled match 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
homeId	string	Unique ID of the home team.
homeName	string	Name of the home team.
awayId	string	Unique ID of the away team.
awayName	string	Name of the away team.
homeScore	int	Final or current score of the home team.
awayScore	int	Final or current score of the away team.
explain	string	The latest live-text event description for the match, e.g. [Spurs] [SAS] Team Timeout: Regular.
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 basic schedule and result information for basketball matches. You can use it with the Match Modify Record endpoint to track any post-publication corrections to match data.\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 • Tips: You have access to all the basketball Common API endpoints with any valid paid basketball plans.

Contact