Cup Stage Profile

Update Time: 2026-07-09 17:11

Introduction

• This API endpoint returns stage type information for basketball cups, such as qualifying rounds, group stages, and regular season.

• The recordId returned by this endpoint corresponds to the stageId field in the Schedule & Results endpoint, allowing you to match a specific match to its cup stage.

Related Plans

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

Request

  • Path: /sport/basketball/cupqualify
  • Method: GET
  • Calls: This interface is limited to 1,800 seconds/call;
  • Recommend Calls: 1 day/call

Response

ParameterValueDescription
recordId string Unique ID of this stage record. Corresponds to the stageId field in the Schedule & Results endpoint.
leagueId string Unique ID of the league or cup.
name stringName of the stage, e.g. Qualifying Round, Regular Season.
season stringSeason, e.g. 2025-2026 or 2026.
groupCount intNumber of groups this stage is divided into.

Returns 0 if not applicable, e.g. 7 means the schedule is divided into 7 groups.
roundCount intNumber of games played between the two sides in a series to determine the winner.

Returns 0 if not applicable, e.g. 7 means the series is decided over 7 games, as seen in Finals stages.
sortNumber intThe order of this stage among the different stages within the same cup.
currentGroup booleantrue: this is the current group stage
false: this is not the current group stage
group booleantrue: this stage is a group-based match format
false: this stage is not a group-based match format

Example Request

Example Response

    • This API endpoint returns stage type information for basketball cups, such as qualifying rounds, group stages, and regular season. \n\n • The recordId returned by this endpoint corresponds to the stageId field in the Schedule & Results endpoint, allowing you to match a specific match to its cup stage.
    Contact

    Contact