get https://api.sportradar.com/tabletennis//v2//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.
<Callout icon="⏱️" theme="default">
### Update Frequency
300s Time To Live / Cache
</Callout>
***
<br />
<html>
<head>
<style>
.smallfont a {
font-size: 95%
}
div.smallfont {
font-size: 82%;
}
</style>
</head>
<body>
## Data Points
<details>
<summary><b><u>Stages:</u></b></summary>
<div class="smallfont">
<Table>
<thead>
<tr>
<th>
Attribute
</th>
<th>
Parent Element
</th>
<th>
Type
</th>
<th>
Description
</th>
</tr>
</thead>
<tbody>
<tr>
<td>
`end_date`
</td>
<td>
`stage`
</td>
<td>
Date
</td>
<td>
End date of a season or stage<br>ex. `2024-07-14`
</td>
</tr>
<tr>
<td>
`order`
</td>
<td>
`stage`
</td>
<td>
Integer
</td>
<td>
Order of a stage within a season
</td>
</tr>
<tr>
<td>
`phase`
</td>
<td>
`stage`
</td>
<td>
String
</td>
<td>
Name of a season or stage<br>ex. `ms` (men singles), `md` (men doubles), `ws` (women singles), `wd` (women doubles), `xd` (mixed doubles)<br><br>See the <b>enum\_phase</b> entry in our [Table Tennis OpenAPI](https://api.sportradar.com/tabletennis/trial/v2/openapi/swagger/index.html) spec for a complete list of valid `phase` enum values
</td>
</tr>
<tr>
<td>
`start_date`
</td>
<td>
`stage`
</td>
<td>
Date
</td>
<td>
Start date of a season or stage<br>ex. `2024-06-24`
</td>
</tr>
<tr>
<td>
`type`
</td>
<td>
`stage`
</td>
<td>
String
</td>
<td>
Type of a season or stage<br>`cup`, `league`
</td>
</tr>
<tr>
<td>
`year`
</td>
<td>
`stage`
</td>
<td>
String
</td>
<td>
Year of a season or stage<br>ex. `23/24` or `2024`
</td>
</tr>
</tbody>
</Table>
</div>
</details>
<details>
<summary><b><u>Groups:</u></b></summary>
<div class="smallfont">
| Attribute | Parent Element | Type | Description |
| ------------ | ----------------------------- | ------- | -------------------------------------------------------------------------------------------------------- |
| `id` | `stage` - `groups` - `group` | String | Unique ID for a stage or season's group<br>ex. `sr:cup:168495` (Olympic Tournament 2024, Knockout stage) |
| `group_name` | `stage` - `groups` - `group` | String | Abbreviated name of a stage or season's group<br>ex. `A` |
| `order` | `stages` - `groups` - `group` | Integer | Order of the `cup_round` within the stage |
</div>
</details>
<details>
<summary><b><u>Cup Rounds:</u></b></summary>
<div class="smallfont">
> Cup round info may reside within `cup_round` or `linked_cup_rounds`. Linked cup round info signifies `parent` or `child` rounds associated with the parent `cup_round`.
<Table>
<thead>
<tr>
<th>
Attribute
</th>
<th>
Parent Element
</th>
<th>
Type
</th>
<th>
Description
</th>
</tr>
</thead>
<tbody>
<tr>
<td>
`id`
</td>
<td>
`stages` - `groups` - `cup_rounds` - `cup_round`
</td>
<td>
String
</td>
<td>
Unique ID for a stage or season's cup round<br>ex. `sr:cup_round:2177591`
</td>
</tr>
<tr>
<td>
`name`
</td>
<td>
`stages` - `groups` - `cup_rounds` - `cup_round`
</td>
<td>
String
</td>
<td>
Name of a stage or season's cup round<br>ex. `round_of_64`, `quarterfinal`, `final`
</td>
</tr>
<tr>
<td>
`order`
</td>
<td>
`stages` - `groups` - `cup_rounds` - `cup_round`
</td>
<td>
Integer
</td>
<td>
Order number for a game in a stage or season's cup round
</td>
</tr>
<tr>
<td>
`state`
</td>
<td>
`stages` - `groups` - `cup_rounds` - `cup_round`
</td>
<td>
String
</td>
<td>
State/status of a game in a stage or season's cup round<br>ex. `ended`, `decided`, `unstarted`, `cancelled`, `winner`<br><br>See our [FAQ](https://developer.sportradar.com/table-tennis/reference/faq#what-are-the-possible-values-for-cup_round--state-in-the-season-links-endpoint) for a complete list of `state` values and their definitions
</td>
</tr>
<tr>
<td>
`type`
</td>
<td>
`stages` - `groups` - `cup_rounds` - `cup_round`
</td>
<td>
String
</td>
<td>
Type of a stage or season's cup round<br>ex. `parent` or `child`
</td>
</tr>
<tr>
<td>
`winner_id`
</td>
<td>
`stages` - `groups` - `cup_rounds` - `cup_round`
</td>
<td>
String
</td>
<td>
Unique ID for the winner of a stage or season's cup round<br>ex. `sr:competitor:276375`
</td>
</tr>
</tbody>
</Table>
</div>
</details>
<details>
<summary><b><u>Sport Event:</u></b></summary>
<div class="smallfont">
| Attribute | Parent Element | Type | Description |
| ---------------------- | --------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
| `id` | `cup_rounds` - `sport_events` - `sport_event` | String | Unique ID of a match<br>ex. `sr:sport_event:50453019` |
| `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<br>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<br>ex. `2024-03-26T20:00:00+00:00` |
| `start_time` | `cup_rounds` - `sport_events` - `sport_event` | Date | Start time of a match<br>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` |
</div>
</details>
</body>
</html>