get
https://api.sportradar.com/tennis//v3//seasons//stages_groups_cup_rounds.
Provides information about linked cup rounds for a given season.
Use this feed to compile full advancement brackets for relevant seasons/tournaments. Links between all matches and rounds are available when competitors (TBD vs. TBD) are not yet known.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL/Cache: 300s Time To Live / Cache
Data Updates (Tier 1):
- Draw added within 3 hrs of official release; fixtures checked continuously.
- Draw changes shown within 2 hrs; newly scheduled matches appear within 30 mins.
- Complexes set shortly before the draw.
Data Points
Stages
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
end_date | stage | Date | End date of a season or stage ex. 2024-07-14 |
order | stage | Integer | Order of a stage within a season |
phase | stage | String | Name of a season or stage ex. stage_1_playoff, qualificationSee the enum_phase entry in our Tennis OpenAPI spec for a complete list of valid phase enum values |
start_date | stage | Date | Start date of a season or stage ex. 2024-06-24 |
type | stage | String | Type of a season or stagecup, league |
year | stage | String | Year of a season or stage ex. 23/24 or 2024 |
Groups
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | stage - groups - group | String | Unique ID for a stage or season's group ex. sr:league:150657 (2024 Wimbledon, London, Great Britain) |
group_name | stage - groups - group | String | Abbreviated name of a stage or season's group |
order | stages - groups - group | Integer | Order of the cup_round within the stage |
Cup Rounds
Cup round info may reside within
cup_roundorlinked_cup_rounds. Linked cup round info signifiesparentorchildrounds associated with the parentcup_round.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | stages - groups - cup_rounds - cup_round | String | Unique ID for a stage or season's cup round ex. sr:cup_round:1586373 |
name | stages - groups - cup_rounds - cup_round | String | Name of a stage or season's cup round ex. quarterfinal or final |
order | stages - groups - cup_rounds - cup_round | Integer | Order number for a game in a stage or season's cup round |
state | stages - groups - cup_rounds - cup_round | String | State/status of a game in a stage or season's cup round ex. ended, decided, unstarted, cancelled, winner |
type | stages - groups - cup_rounds - cup_round | String | Type of a stage or season's cup round ex. parent or child |
winner_id | stages - groups - cup_rounds - cup_round | String | Unique ID for the winner of a stage or season's cup round ex. sr:competitor:34416 |
Sport Event
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | cup_rounds - sport_events - sport_event | String | Unique ID of a match ex. sr:sport_event:51847153 |
order | cup_rounds - sport_events - sport_event | Integer | Order of the sport_event within the cup_round |
replaced_by | cup_rounds - sport_events - sport_event | String | An alternative sport event ID if the match is postponed and played at a later date ex. sr:sport_event:51847153 |
resume_time | cup_rounds - sport_events - sport_event | Date | An updated timestamp if there is a delay at the start or interruption during a match ex. 2024-03-26T20:00:00+00:00 |
start_time | cup_rounds - sport_events - sport_event | Date | Start time of a match ex. 2024-03-26T20:00:00+00:00 |
start_time_confirmed | cup_rounds - sport_events - sport_event | Boolean | Signifies the start time of a match is confirmed when true |