Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Info

Provides detailed information for a given season, including participating competitors and league structure.

<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>Category & Sport:</u></b></summary>

<div class="smallfont">

| Attribute      | Parent Element        | Type   | Description                                                                   |
| -------------- | --------------------- | ------ | ----------------------------------------------------------------------------- |
| `country_code` | `season` - `category` | String | Country code for a competition category                                       |
| `id`           | `season` - `category` | String | Unique category ID for a competition<br>ex. `sr:category:136` (International) |
| `name`         | `season` - `category` | String | Name for a competition category<br>ex. `International`                        |
| `id`           | `season` - `sport`    | String | Unique sport ID for a competitor<br>ex. `sr:sport:23`                         |
| `name`         | `season` - `sport`    | String | Name for a competitor's sport<br>ex. `Volleyball`                             |

</div>
</details>

<details>
<summary><b><u>Competition:</u></b></summary>

<div class="smallfont">

| Attribute   | Parent Element           | Type   | Description                                                                        |
| ----------- | ------------------------ | ------ | ---------------------------------------------------------------------------------- |
| `gender`    | `season` - `competition` | String | Gender for a competition<br>ex. `men`, `women`                                     |
| `id`        | `season` - `competition` | String | Unique ID for a competition<br>ex. `sr:competition:497` (Olympic Tournament Women) |
| `name`      | `season` - `competition` | String | Name of a competition<br>ex. `Olympic Tournament Women`                            |
| `parent_id` | `season` - `competition` | String | Unique parent ID for a competition                                                 |

</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:league:84205` (Olympic Tournament Women 2024, Pool A) or `sr:cup:166895` (Olympic Tournament Woman 2024, Knockout stage) |
| `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<br>ex. `Olympic Tournament Women 2024, Pool A` or `Olympic Tournament Woman 2024, Knockout stage`                                         |
| `group_name` | `stage` - `groups` - `group` | String  | Abbreviated name of a stage or season's group<br>ex. `A`                                                                                                                    |

</div>
</details>

<details>
<summary><b><u>Season:</u></b></summary>

<div class="smallfont">

| Attribute        | Parent Element | Type    | Description                                                                                         |
| ---------------- | -------------- | ------- | --------------------------------------------------------------------------------------------------- |
| `competition_id` | `season`       | String  | Unique ID for the competition a season belongs to<br>ex. `sr:competition:497` (Olympic Games Women) |
| `disabled`       | `season`       | Boolean | Signifies a season has been disabled when `true`                                                    |
| `end_date`       | `season`       | Date    | End date of a season<br>ex. `2025-07-13`                                                            |
| `id`             | `season`       | String  | Unique ID for a season<br>ex. `sr:season:105539` (Olympic Games Women 2024)                         |
| `name`           | `season`       | String  | Name of a season<br>ex. `Olympic Games Women 2024`                                                  |
| `start_date`     | `season`       | Date    | Start date of a season<br>ex. `2025-06-23`                                                          |
| `year`           | `season`       | String  | Year of a season<br>ex. `24/25` or `2025`                                                           |

</div>
</details>

<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. `playoffs`, `regular season`<br><br>See the <b>enum\_phase</b> entry in our [Indoor Volleyball OpenAPI](https://api.sportradar.com/volleyball/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>Competitor:</u></b></summary>

<div class="smallfont">

| Attribute      | Parent Element               | Type    | Description                                                                                               |
| -------------- | ---------------------------- | ------- | --------------------------------------------------------------------------------------------------------- |
| `abbreviation` | `competitors` - `competitor` | String  | Abbreviation for a competitor name<br>ex. `FRA`                                                           |
| `age_group`    | `competitors` - `competitor` | String  | Age group of a competitor, when applicable<br>ex. `U23`                                                   |
| `country`      | `competitors` - `competitor` | String  | Country of a competitor<br>ex. `France`                                                                   |
| `country_code` | `competitors` - `competitor` | String  | Country code of a competitor<br>ex. `FRA`                                                                 |
| `gender`       | `competitors` - `competitor` | String  | Gender of a competitor<br>ex. `male`, `female`                                                            |
| `id`           | `competitors` - `competitor` | String  | Unique ID for a competitor<br>ex. `sr:competitor:90974`                                                   |
| `name`         | `competitors` - `competitor` | String  | Name for a competitor<br>ex. `France`                                                                     |
| `virtual`      | `competitors` - `competitor` | Boolean | Signifies a competitor is virtual when `true`. Used for placeholder players/teams in TBD vs TBD matchups. |

</div>
</details>

</body>
</html>
Language
Credentials
Header
Click Try It! to start a request and see the response here!