League & Cup Profile
Update Time: 2026-07-09 16:48
Introduction
This API endpoint returns complete profile information for basketball leagues and cups, including league rules, ranking format, and season details. Click here to view all leagues & cups.
Related Plans
You can use this api by subscribing plans: Live Data.
Request
- Path: /sport/basketball/league
- Method: GET
- Calls: This interface is limited to 1,800 seconds/call;
- Recommend Calls: 1 day/call
- Parameters:
| Parameter | Value | Required | Description |
|---|---|---|---|
| leagueId | string | false | Returns profile information for the specified leagueId. If omitted, returns profile information for all leagues and cups. |
Response
| Parameter | Value | Description |
|---|---|---|
| leagueId | string | Unique ID of the league or cup. |
| color | string | RGB color code associated with the league, e.g. #9933FF. |
| leagueName | string | Full name of the league or cup, e.g. National Basketball Association. |
| leagueShortName | string | Short name of the league or cup, e.g. NBA. |
| leagueType | string | Number of quarters played in this league's matches. 2: 2-quarter format 4: 4-quarter format |
| currentMatchSeason | string | Current season, e.g. 25-26. |
| countryId | string | Unique ID of the country or region the league belongs to. |
| country | string | Country or region name, e.g. USA. Returns "International" for multi-national competitions. |
| leagueKind | string | 1: league 2: cup |
| logo | string | League logo URL. The image is hosted for reference only — please save it locally rather than calling this URL directly in production. |
| partTime | string | Duration of each quarter, format mm:ss, e.g. 12:00. |
| rule | string | Full text description of the league's rules, including format, scheduling, ranking, tie-breaker, and playoff details where applicable. This field may contain a large block of text with line breaks (\r\ n) — please handle formatting accordingly when rendering. |
Example Request

English
Tiếng Việt
ภาษาไทย 