---
updatedAt: 2025-09-23T18:25:33.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/table-tennis/llms.txt
---
# Season Info
Provides detailed information for a given season, including participating competitors and league structure.
### Update Frequency
300s Time To Live / Cache
***
## Data Points
| Attribute | Parent Element | Type | Description |
| -------------- | --------------------- | ------ | ------------------------------------------------------------------------------- |
| `country_code` | `season` - `category` | String | Country code for a season category |
| `id` | `season` - `category` | String | Unique category ID for a season
ex. `sr:category:88` (International) |
| `name` | `season` - `category` | String | Name for a season category
ex. `ATP` |
| `id` | `season` - `sport` | String | Unique sport ID for a season
ex. `sr:sport:20` |
| `name` | `season` - `sport` | String | Name for a season's sport
ex. `Table Tennis` |
| Attribute | Parent Element | Type | Description |
| ----------- | ------------------------ | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `gender` | `season` - `competition` | String | Gender for a competition
ex. `men`, `women`, `mixed` |
| `id` | `season` - `competition` | String | Unique ID for a competition
ex. `sr:competition:564` (Olympic Tournament) |
| `name` | `season` - `competition` | String | Name of a competition
ex. `Olympic Tournament`, `Australian Open (WTP), Women Doubles` |
| `parent_id` | `season` - `competition` | String | Unique parent ID for a competition.
ex. `sr:competition:2334` is used to group all Australian Open competitions. |
| `type` | `season` - `competition` | String | Type of a competition
ex. `singles`, `doubles`, `mixed_doubles` |
| Attribute | Parent Element | Type | Description |
| ------------ | ---------------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
| `id` | `stage` - `groups` - `group` | String | Unique ID for a stage or season's group
ex. `sr:cup:173473` (ETTU European Championships 2024, XD) |
| `max_rounds` | `stage` - `groups` - `group` | Integer | Maximum number of rounds for a stage or season |
| `name` | `stage` - `groups` - `group` | String | Name of a stage or season's group
ex. `Group A` or `Olympic Tournament 2024, Preliminary Rounds` |
| `group_name` | `stage` - `groups` - `group` | String | Abbreviated name of a stage or season's group
ex. `A` |
| Attribute | Parent Element | Type | Description |
| ---------------------------- | ----------------- | ------- | ---------------------------------------------------------------------------- |
| `competition_status` | `season` - `info` | String | Status of a competition
*Data point not currently in use* |
| `venue_reduced_capacity` | `season` - `info` | Boolean | Signifies venues within this competition have a reduced capacity when `true` |
| `venue_reduced_capacity_max` | `season` - `info` | Integer | Maximum capacity for a venue |
| Attribute | Parent Element | Type | Description |
| ---------------- | -------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `competition_id` | `season` | String | Unique ID for the competition a season belongs to
ex. `sr:competition:564` (Olympic Tournament) |
| `disabled` | `season` | Boolean | Signifies a season has been disabled when `true` |
| `end_date` | `season` | Date | End date of a season
ex. `2025-07-13` |
| `id` | `season` | String | Unique ID for a season
ex. `sr:season:105599` (Olympic Games 2024) |
| `name` | `season` | String | Name of a season
ex. `Olympic Games 2024` |
| `start_date` | `season` | Date | Start date of a season
ex. `2025-06-23` |
| `year` | `season` | String | Year of a season
ex. `24/25` or `2025` |
| 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. `ms` (men singles), `md` (men doubles), `ws` (women singles), `wd` (women doubles), `xd` (mixed doubles)
See the enum\_phase 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 |
| `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` |
> Competitors can be a player or a doubles team
| Attribute | Parent Element | Type | Description |
| --------------- | ---------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------- |
| `abbreviation` | `competitors` - `competitor` | String | Abbreviation for a competitor name (singles or doubles)
ex. `SUN` (Sun, Yingsha), `G/P` (Gardos R / Polcanova S) |
| `country` | `competitors` - `competitor` | String | Country of a competitor
ex. `China` |
| `country_code` | `competitors` - `competitor` | String | Country code of a competitor
ex. `CHN` |
| `date_of_birth` | `competitor` - `competitor` | Date | Date of birth of a competitor
ex. `1996-02-28` |
| `gender` | `competitors` - `competitor` | String | Gender for a competitor
`male`, `female` |
| `id` | `competitors` - `competitor` | String | Unique ID for a competitor
ex. `sr:competitor:344054` |
| `name` | `competitors` - `competitor` | String | Name for a competitor (singles or doubles)
ex. `Sun, Yingsha`, `Gardos R / Polcanova S` |
| `qualifier` | `competitors` - `competitor` | String | Designation of a competitor for a match
`home`, `away` |
| `virtual` | `competitors` - `competitor` | Boolean | Signifies a competitor is virtual when `true`. Used for placeholder players/teams in TBD vs TBD matchups. |
> Competitors will appear under a `players` node when part of a doubles competition.
| Attribute | Parent Element | Type | Description |
| --------------- | ----------------------------------- | ------ | -------------------------------------------------------------------- |
| `abbreviation` | `competitor` - `players` - `player` | String | Abbreviation for a player name
ex. `GAR` (Gardos, Robert) |
| `country` | `competitor` - `players` - `player` | String | Country of a competitor
ex. `China` |
| `country_code` | `competitor` - `players` - `player` | String | Country code of a competitor
ex. `CHN` |
| `date_of_birth` | `competitor` - `players` - `player` | Date | Date of birth of a player
ex. `1994-07-05` |
| `id` | `competitor` - `players` - `player` | String | Unique ID for a competitor
ex. `sr:competitor:25084` |
| `name` | `competitor` - `players` - `player` | String | Name for a competitor
ex. `Gardos, Robert` |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "table-tennis",
"version": "2"
},
"servers": [
{
"url": "https://api.sportradar.com/tabletennis/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v2/{language_code}/seasons/{season_id}/info.{format}": {
"get": {
"summary": "Season Info",
"description": "Provides detailed information for a given season, including participating competitors and league structure.",
"operationId": "season-info",
"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/table-tennis/reference/seasons) endpoint
**Note:** The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.
**Example:** `sr:season:124097`",
"schema": {
"type": "string",
"default": "sr:season:124097"
},
"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-04T19:28:15.212Z\",\n \"season\": {\n \"category\": {\n \"country_code\": \"string\",\n \"id\": \"string\",\n \"name\": \"string\"\n },\n \"competition\": {\n \"gender\": \"string\",\n \"id\": \"string\",\n \"name\": \"string\",\n \"parent_id\": \"string\",\n \"type\": \"string\"\n },\n \"competition_id\": \"string\",\n \"disabled\": true,\n \"end_date\": \"2023-05-04\",\n \"id\": \"string\",\n \"info\": {\n \"competition_status\": \"delayed\",\n \"venue_reduced_capacity\": true,\n \"venue_reduced_capacity_max\": 0\n },\n \"name\": \"string\",\n \"sport\": {\n \"id\": \"string\",\n \"name\": \"string\"\n },\n \"start_date\": \"2023-05-04\",\n \"year\": \"string\"\n },\n \"stages\": [\n {\n \"end_date\": \"2023-05-04\",\n \"groups\": [\n {\n \"competitors\": [\n {\n \"abbreviation\": \"string\",\n \"age_group\": \"U23\",\n \"country\": \"string\",\n \"country_code\": \"string\",\n \"date_of_birth\": \"string\",\n \"gender\": \"female\",\n \"id\": \"string\",\n \"name\": \"string\",\n \"players\": [\n {\n \"abbreviation\": \"string\",\n \"country\": \"string\",\n \"country_code\": \"string\",\n \"date_of_birth\": \"2023-05-04\",\n \"gender\": \"female\",\n \"height\": 0,\n \"id\": \"string\",\n \"jersey_number\": 0,\n \"name\": \"string\",\n \"nationality\": \"string\",\n \"nickname\": \"string\",\n \"type\": \"d\",\n \"weight\": 0\n }\n ],\n \"qualifier\": \"home\",\n \"virtual\": true\n }\n ],\n \"group_name\": \"string\",\n \"id\": \"string\",\n \"max_rounds\": 0,\n \"name\": \"string\",\n \"parent_group_id\": \"string\"\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-04T19:28:15.212Z"
},
"season": {
"type": "object",
"properties": {
"category": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"competition": {
"type": "object",
"properties": {
"gender": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"parent_id": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "string"
}
}
},
"competition_id": {
"type": "string",
"example": "string"
},
"disabled": {
"type": "boolean",
"example": true,
"default": true
},
"end_date": {
"type": "string",
"example": "2023-05-04"
},
"id": {
"type": "string",
"example": "string"
},
"info": {
"type": "object",
"properties": {
"competition_status": {
"type": "string",
"example": "delayed"
},
"venue_reduced_capacity": {
"type": "boolean",
"example": true,
"default": true
},
"venue_reduced_capacity_max": {
"type": "integer",
"example": 0,
"default": 0
}
}
},
"name": {
"type": "string",
"example": "string"
},
"sport": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
}
}
},
"start_date": {
"type": "string",
"example": "2023-05-04"
},
"year": {
"type": "string",
"example": "string"
}
}
},
"stages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"end_date": {
"type": "string",
"example": "2023-05-04"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"age_group": {
"type": "string",
"example": "U23"
},
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"date_of_birth": {
"type": "string",
"example": "string"
},
"gender": {
"type": "string",
"example": "female"
},
"id": {
"type": "string",
"example": "string"
},
"name": {
"type": "string",
"example": "string"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"abbreviation": {
"type": "string",
"example": "string"
},
"country": {
"type": "string",
"example": "string"
},
"country_code": {
"type": "string",
"example": "string"
},
"date_of_birth": {
"type": "string",
"example": "2023-05-04"
},
"gender": {
"type": "string",
"example": "female"
},
"height": {
"type": "integer",
"example": 0,
"default": 0
},
"id": {
"type": "string",
"example": "string"
},
"jersey_number": {
"type": "integer",
"example": 0,
"default": 0
},
"name": {
"type": "string",
"example": "string"
},
"nationality": {
"type": "string",
"example": "string"
},
"nickname": {
"type": "string",
"example": "string"
},
"type": {
"type": "string",
"example": "d"
},
"weight": {
"type": "integer",
"example": 0,
"default": 0
}
}
}
},
"qualifier": {
"type": "string",
"example": "home"
},
"virtual": {
"type": "boolean",
"example": true,
"default": true
}
}
}
},
"group_name": {
"type": "string",
"example": "string"
},
"id": {
"type": "string",
"example": "string"
},
"max_rounds": {
"type": "integer",
"example": 0,
"default": 0
},
"name": {
"type": "string",
"example": "string"
},
"parent_group_id": {
"type": "string",
"example": "string"
}
}
}
},
"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
}
```