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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

300s Time To Live / Cache


Data Points

<Accordion title="Stages" icon="fa-light fa-bullseye-arrow">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `end_date` | `stage` | Date | End date of a season or stage<br><br>ex. `2024-07-14` |
| `order` | `stage` | Integer | Order of a stage within a season |
| `phase` | `stage` | String | Name of a season or stage<br><br>ex. `playoffs`, `regular season`, `stage_1`<br><br>See the **enum_phase** entry in our [Darts OpenAPI](https://api.sportradar.com/darts/trial/v2/openapi/swagger/index.html) spec for a complete list of valid `phase` enum values |
| `start_date` | `stage` | Date | Start date of a season or stage<br><br>ex. `2024-06-24` |
| `type` | `stage` | String | Type of a season or stage<br><br>`cup`, `league` |
| `year` | `stage` | String | Year of a season or stage<br><br>ex. `23/24` or `2024` |

</Accordion>

<Accordion title="Groups" icon="fa-light fa-bullseye-arrow">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `stage` - `groups` - `group` | String | Unique ID for a stage or season's group<br /><br />ex. `sr:cup:161589` (PDC European Tour - Belgian Darts Open 2024) |
| `group_name` | `stage` - `groups` - `group` | String | Abbreviated name of a stage or season's group<br /><br />ex. `A` |
| `order` | `stages` - `groups` - `group` | Integer | Order of the `cup_round` within the stage |

</Accordion>

<Accordion title="Cup Rounds" icon="fa-light fa-bullseye-arrow">

> 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`.

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `stages` - `groups` - `cup_rounds` - `cup_round` | String | Unique ID for a stage or season's cup round<br /><br />ex. `sr:cup_round:2043883` |
| `name` | `stages` - `groups` - `cup_rounds` - `cup_round` | String | Name of a stage or season's cup round<br /><br />ex. `round_1`, `quarterfinal`, `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<br /><br />ex. `ended`, `decided`, `unstarted`, `cancelled`, `winner` |
| `type` | `stages` - `groups` - `cup_rounds` - `cup_round` | String | Type of a stage or season's cup round<br /><br />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<br /><br />ex. `sr:competitor:2043999` |

</Accordion>

<Accordion title="Sport Event" icon="fa-light fa-bullseye-arrow">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `cup_rounds` - `sport_events` - `sport_event` | String | Unique ID of a match<br /><br />ex. `sr:sport_event:48416725` |
| `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 /><br />ex. `sr:sport_event:48416725` |
| `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 /><br />ex. `2024-03-26T20:00:00+00:00` |
| `start_time` | `cup_rounds` - `sport_events` - `sport_event` | Date | Start time of a match<br /><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` |

</Accordion>

Path Params
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json