iSports API – Sports API Documentation & Example Responses for Developers

Cup Stage Profile

Update Time: 2026-06-29 15:26

Introduction

• This API endpoint returns the structural data for various competition stages of a cup, including qualifying rounds, group stages, and knockout phases.

• It provides configuration details such as group counts, qualification rules (lineup counts), and stage progression order for a specific season.

• Use it alongside the League & Cup Profile endpoint to manage and display complex multi-stage tournament brackets.

Related Plans

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

Request

Path: /sport/football/league/stage
Method: GET
Calls: This interface is limited to 1,800 seconds/call;
Recommend Calls: 1 day/call

Response

Parameter	Value	Description
leagueId	string
season	string	e.g. 2018
stageId	string
stageName	string	Stage name, e.g. Round 1, Group stage.
group	boolean	Group stage flag; true: stage is divided into groups false: knockout or single division
groupNum	string	Total number of groups in this stage
currStage	boolean	Current stage flag; true: stage is currently in progress false: finished or inactive
stageOrder	string	Display sequence of the stage within the cup
lineCount	string	Number of teams qualifying for the next stage from this stage; Empty string if not available.
hasTwoLegs	boolean	Two-legged match flag; true: consists of home and away legs false: single match.
groupLineupCount	int	Qualifying team count per group; formatted as Group,Count separated by semicolons (e.g., A,1;B,1). Takes precedence over lineCount if both exist.

Example Request

Example Response

• This API endpoint returns the structural data for various competition stages of a cup, including qualifying rounds, group stages, and knockout phases.\n\n • It provides configuration details such as group counts, qualification rules (lineup counts), and stage progression order for a specific season.\n\n • Use it alongside the League & Cup Profile endpoint to manage and display complex multi-stage tournament brackets.

Contact