---
updatedAt: 2025-12-10T20:58:17.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/snooker/llms.txt
---
# 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.
### Update Frequency
300s Time To Live / Cache
***
## Data Points
| 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. `playoffs`, `regular season`
See the **enum\_phase** entry in our [Snooker OpenAPI](https://api.sportradar.com/snooker/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
ex. `2024-06-24` |
| `type` | `stage` | String | Type of a season or stage
`cup`, `league` |
| `year` | `stage` | String | Year of a season or stage
ex. `23/24` or `2024` |
| Attribute | Parent Element | Type | Description |
| ------------ | ----------------------------- | ------- | ------------------------------------------------------------------------------------------------ |
| `id` | `stage` - `groups` - `group` | String | Unique ID for a stage or season's group
ex. `sr:cup:163447` (World Championship 2024) |
| `group_name` | `stage` - `groups` - `group` | String | Abbreviated name of a stage or season's group
ex. `A` |
| `order` | `stages` - `groups` - `group` | Integer | Order of the `cup_round` within the stage |
> 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
ex. `sr:cup_round:2096385` |
| `name` | `stages` - `groups` - `cup_rounds` - `cup_round` | String | Name of a stage or season's cup round
ex. `round_of_16`, `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
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:25050` |
| Attribute | Parent Element | Type | Description |
| ---------------------- | --------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `cup_rounds` - `sport_events` - `sport_event` | String | Unique ID of a match
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
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` |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "snooker",
"version": "2"
},
"servers": [
{
"url": "https://api.sportradar.com/snooker/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v2/{language_code}/seasons/{season_id}/stages_groups_cup_rounds.{format}": {
"get": {
"summary": "Season Links",
"description": "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.",
"operationId": "snooker-season-links",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`trial`, `production`",
"schema": {
"type": "string",
"enum": [
"trial",
"production"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`en` (English)
English is the only fully supported language for this API. Click [here](https://api-docs.sportradar.us/misc/Sportradar_API_Languages.xlsx) for valid language codes and a tabular list of available languages per competition.",
"schema": {
"type": "string",
"default": "en"
},
"required": true
},
{
"name": "season_id",
"in": "path",
"description": "Unique Id of a season, found in the [Seasons](https://developer.sportradar.com/snooker/reference/snooker-seasons) endpoint
**Note:** The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.
**Example:** `sr:season:121041`",
"schema": {
"type": "string",
"default": "sr:season:131471"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"generated_at\": \"2023-05-04T17:27:19.601Z\",\n \"stages\": [\n {\n \"end_date\": \"2023-05-04\",\n \"groups\": [\n {\n \"cup_rounds\": [\n {\n \"id\": \"string\",\n \"linked_cup_rounds\": [\n {\n \"id\": \"string\",\n \"name\": \"string\",\n \"order\": 0,\n \"state\": \"string\",\n \"type\": \"parent\",\n \"winner_id\": \"string\"\n }\n ],\n \"name\": \"string\",\n \"order\": 0,\n \"sport_events\": [\n {\n \"id\": \"string\",\n \"order\": 0,\n \"replaced_by\": \"string\",\n \"resume_time\": \"2023-05-04T17:27:19.601Z\",\n \"start_time\": \"2023-05-04T17:27:19.601Z\",\n \"start_time_confirmed\": true\n }\n ],\n \"state\": \"string\"\n }\n ],\n \"group_name\": \"string\",\n \"id\": \"string\",\n \"order\": 0\n }\n ],\n \"order\": 0,\n \"phase\": \"1st_part_of_season_1st_leg\",\n \"start_date\": \"2023-05-04\",\n \"type\": \"cup\",\n \"year\": \"string\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"generated_at": {
"type": "string",
"example": "2023-05-04T17:27:19.601Z"
},
"stages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"end_date": {
"type": "string",
"example": "2023-05-04"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cup_rounds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"linked_cup_rounds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"order": {
"type": "integer",
"example": 0,
"default": 0
},
"state": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "parent"
},
"winner_id": {
"type": "string",
"example": "string"
}
}
}
},
"name": {
"type": "string",
"example": "string"
},
"order": {
"type": "integer",
"example": 0,
"default": 0
},
"sport_events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"order": {
"type": "integer",
"example": 0,
"default": 0
},
"replaced_by": {
"type": "string",
"example": "string"
},
"resume_time": {
"type": "string",
"example": "2023-05-04T17:27:19.601Z"
},
"start_time": {
"type": "string",
"example": "2023-05-04T17:27:19.601Z"
},
"start_time_confirmed": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"state": {
"type": "string",
"example": "string"
}
}
}
},
"group_name": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"order": {
"type": "integer",
"example": 0,
"default": 0
}
}
}
},
"order": {
"type": "integer",
"example": 0,
"default": 0
},
"phase": {
"type": "string",
"example": "1st_part_of_season_1st_leg"
},
"start_date": {
"type": "string",
"example": "2023-05-04"
},
"type": {
"type": "string",
"example": "cup"
},
"year": {
"type": "string",
"example": "string"
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```