iSports API – Sports API Documentation & Example Responses for Developers

League & Cup Profile (Basic)

Update Time: 2026-05-25 17:17

Introduction

This API endpoint returns the basic information of leagues and cups. If you need more details, please refer to League & Cup Profile. Click here to view 2000+ football leagues & cups.

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/league/basic
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 by a specific league or cup ID. If omitted, all leagues and cups are returned.

Response

Parameter	Value	Description
leagueId	string	Unique league or cup ID
name	string	Full name (English) e.g. Brazil Serie A
shortName	string	Short name (English) e.g. BRA D1
type	int	Competition type 1: League 2: Cup
subLeagueName	string	Currently active sub-league name e.g. Western Play-off

Example Request

Example Response

This API endpoint returns the basic information of leagues and cups. If you need more details, please refer to League & Cup Profile. Click here to view 2000+ football leagues & cups.\n\n Tips: You have access to all the football Common API endpoints with any valid paid football plans.

Contact