---
updatedAt: 2026-01-06T16:59:08.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/more-sports/llms.txt
---

# Seasons

**Olympic Medals Seasons** provides a list of historical “seasons” information for Olympic games. Each unique set of games is considered its own season.

<Callout icon="⏱️" theme="default">
  ### Update Frequency

  **TTL / Cache:**<br />
  During a season: 1 day<br />
  Out of a season: 1 week
</Callout>

***

## Data Points

<Accordion title="Season" icon="fa-light fa-medal">

| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `title` | `season` | String | Title of an Olympic season<br /><br />ex. `2022 Winter Olympics`  |
| `id` | `season` | GUID | Unique Id of a season<br /><br />ex. `3f6d5827-9a4b-4bb2-9cf6-7a19ec2efb14` |
| `start_date` | `season` | Date | Start date of a season<br /><br />ex. `2022-02-04` |
| `end_date` | `season` | Date | End date of a season<br /><br />ex. `2022-02-20` |
| `status` | `season` | String | Status of a season<br /><br />ex. `scheduled`, `inprogress`, `closed` |
| `host_city` | `season` | String | Host city of an Olympic season<br /><br />ex. `Beijing` |
| `host_country` | `season` | String | Host country of an Olympic season<br /><br />ex. `CHN` |

</Accordion>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "olympic-medals",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://api.sportradar.com/olympics/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{access_level}/v1/{language_code}/seasons.{format}": {
      "get": {
        "summary": "Seasons",
        "description": "**Olympic Medals Seasons** provides a list of historical “seasons” information for Olympic games. Each unique set of games is considered its own season.",
        "operationId": "olympic-medals-seasons",
        "parameters": [
          {
            "name": "access_level",
            "in": "path",
            "description": "The access level of your API key<br><br>`production`",
            "schema": {
              "type": "string",
              "enum": [
                "production"
              ],
              "default": "production"
            },
            "required": true
          },
          {
            "name": "language_code",
            "in": "path",
            "description": "2 letter code for supported languages<br><br>`en` (English)",
            "schema": {
              "type": "string",
              "enum": [
                "en"
              ],
              "default": "en"
            },
            "required": true
          },
          {
            "name": "format",
            "in": "path",
            "description": "Format returned<br><br>`json` or `xml`",
            "schema": {
              "type": "string",
              "enum": [
                "json",
                "xml"
              ],
              "default": "json"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"seasons\": [\n        {\n            \"title\": \"2020 Summer Olympics\",\n            \"id\": \"c2c56a05-1b2d-4b49-8c33-d6a182792a3a\",\n            \"start_date\": \"2020-07-24\",\n            \"end_date\": \"2020-08-09\",\n            \"status\": \"inprogress\",\n            \"host_city\": \"Tokyo\",\n            \"host_country\": \"JPN\"\n        },\n        {\n            \"title\": \"2022 Winter Olympics\",\n            \"id\": \"3f6d5827-9a4b-4bb2-9cf6-7a19ec2efb14\",\n            \"start_date\": \"2022-02-04\",\n            \"end_date\": \"2022-02-20\",\n            \"status\": \"scheduled\",\n            \"host_city\": \"Beijing\",\n            \"host_country\": \"CHN\"\n        }\n    ],\n    \"_comment\": \"Generation started @ 2024-05-09 19:44:31 UTC ended @ 2024-05-09 19:44:31 UTC\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "seasons": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "title": {
                            "type": "string",
                            "example": "2020 Summer Olympics"
                          },
                          "id": {
                            "type": "string",
                            "example": "c2c56a05-1b2d-4b49-8c33-d6a182792a3a"
                          },
                          "start_date": {
                            "type": "string",
                            "example": "2020-07-24"
                          },
                          "end_date": {
                            "type": "string",
                            "example": "2020-08-09"
                          },
                          "status": {
                            "type": "string",
                            "example": "inprogress"
                          },
                          "host_city": {
                            "type": "string",
                            "example": "Tokyo"
                          },
                          "host_country": {
                            "type": "string",
                            "example": "JPN"
                          }
                        }
                      }
                    },
                    "_comment": {
                      "type": "string",
                      "example": "Generation started @ 2024-05-09 19:44:31 UTC ended @ 2024-05-09 19:44:31 UTC"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```