Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Links

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>
Language
Credentials
Header
Click Try It! to start a request and see the response here!