iSports API – Sports API Documentation & Example Responses for Developers

League & Cup Profile

Update Time: 2026-06-04 14:30

Introduction

• This API endpoint returns profile data for leagues and cups, including name, logo, current season, and competition structure. By default, returns all available leagues and cups.

• Use the leagueId parameter to retrieve a specific competition, or day to fetch recently modified records.

Related Plans

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

Request

Path: /sport/football/league
Method: GET
Calls: This interface is limited to 1800 second/call;
Recommend Calls: 1 day/call
Parameters:

Parameter	Value	Required	Description
leagueId	string	false	Filter results to a specific league or cup by ID. If omitted, returns all.
cmd	string，rule	false	cmd=rule; Pass rule to retrieve the competition format description. Omitted if no data is available.
day	int	false	Returns leagues and cups modified within the specified number of days (e.g., day=50).

Response

Parameter	Value	Description
leagueId	string	Unique league or cup ID
type	int	1: League 2: Cup
color	string	Theme color as an RGB hex code (e.g., #00CCCC)
logo	string	League logo image URL. Hosted for reference only — do not hotlink directly; download and serve locally.
name	string	Full competition name (e.g., Argentine Division 1)
shortName	string	Abbreviated competition name (e.g., ARG D1)
subLeagueName	string	Active sub-competition or stage name (e.g., Final, Western Play-off). Empty string if not applicable.
totalRound	int	Total number of rounds in the season. 0 if not applicable (e.g., cup competitions)
currentRound	int	Current round in progress. 0 if season has not started or not applicable
currentSeason	string	Current season identifier (e.g., 2026, 2025-2026)
countryId	string	Unique ID of the country or region
country	string	Country or region name (e.g., Argentina)
countryLogo	string	Country flag image URL. Hosted for reference only — do not hotlink directly; download and serve locally.
areaId	int	0:International 1:Europe 2: America 3: Asia 4: Oceania 5: Africa

Example Request

Example Response

• This API endpoint returns profile data for leagues and cups, including name, logo, current season, and competition structure. By default, returns all available leagues and cups.\n\n • Use the leagueId parameter to retrieve a specific competition, or day to fetch recently modified records.

Contact