Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Standings

Provides detailed standings info for a given season.

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

  10s 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>Groups:</u></b></summary>

<div class="smallfont">

| Attribute         | Parent Element                         | Type    | Description                                                        |
| ----------------- | -------------------------------------- | ------- | ------------------------------------------------------------------ |
| `id`              | `season_standing` - `groups` - `group` | String  | Unique ID for a standings group<br>ex. `sr:league:84667` (Group A) |
| `live`            | `season_standing` - `groups` - `group` | Boolean | Signifies standings are based on live scores when `true`           |
| `name`            | `season_standing` - `groups` - `group` | String  | Name of a standings group<br>ex. `Group A`                         |
| `group_name`      | `season_standing` - `groups` - `group` | String  | Abbreviated name of a standings group<br>ex. `A`                   |
| `parent_group_id` | `season_standing` - `groups` - `group` | String  | Unique ID for a parent of a standings group                        |

</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>
        `season_standing` - `groups` - `group` - `stage`
      </td>

      <td>
        Date
      </td>

      <td>
        End date of a standings stage<br>ex. `2024-05-19`
      </td>
    </tr>

    <tr>
      <td>
        `order`
      </td>

      <td>
        `season_standing` - `groups` - `group` - `stage`
      </td>

      <td>
        Integer
      </td>

      <td>
        Order of a stage within a season
      </td>
    </tr>

    <tr>
      <td>
        `phase`
      </td>

      <td>
        `season_standing` - `groups` - `group` - `stage`
      </td>

      <td>
        String
      </td>

      <td>
        Name of a standings stage<br>ex. `playoffs`, `regular season`<br><br>See the <b>enum\_phase</b> entry in our [Beach Volleyball OpenAPI](https://api.sportradar.com/beachvolleyball/trial/v2/openapi/swagger/index.html) spec for a complete list of valid `phase` enum values
      </td>
    </tr>

    <tr>
      <td>
        `start_date`
      </td>

      <td>
        `season_standing` - `groups` - `group` - `stage`
      </td>

      <td>
        Date
      </td>

      <td>
        Start date of a standings stage<br>ex. `2023-08-11`
      </td>
    </tr>

    <tr>
      <td>
        `type`
      </td>

      <td>
        `season_standing` - `groups` - `group` - `stage`
      </td>

      <td>
        String
      </td>

      <td>
        Type of a standings stage<br>`cup`, `league`
      </td>
    </tr>

    <tr>
      <td>
        `year`
      </td>

      <td>
        `season_standing` - `groups` - `group` - `stage`
      </td>

      <td>
        String
      </td>

      <td>
        Year of a standings stage<br>ex. `23/24`
      </td>
    </tr>
  </tbody>
</table>

</div>
</details>

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

<div class="smallfont">

| Attribute      | Parent Element            | Type    | Description                                                                                               |
| -------------- | ------------------------- | ------- | --------------------------------------------------------------------------------------------------------- |
| `abbreviation` | `standing` - `competitor` | String  | Abbreviation for a competitor name<br>ex. `HPWI` (Humana-Paredes M / Wilkerson B)                         |
| `age_group`    | `standing` - `competitor` | String  | Age group of a competitor, when applicable<br>ex. `U23`                                                   |
| `country`      | `standing` - `competitor` | String  | Country of a competitor<br>ex. `Canada`                                                                   |
| `country_code` | `standing` - `competitor` | String  | Country code of a competitor<br>ex. `CAN`                                                                 |
| `gender`       | `standing` - `competitor` | String  | Gender of a competitor<br>ex. `male`, `female`                                                            |
| `id`           | `standing` - `competitor` | String  | Unique ID for a competitor<br>ex. `sr:competitor:936055`                                                  |
| `name`         | `standing` - `competitor` | String  | Name for a competitor<br>ex. `Humana-Paredes M / Wilkerson B`                                             |
| `virtual`      | `standing` - `competitor` | Boolean | Signifies a competitor is virtual when `true`. Used for placeholder players/teams in TBD vs TBD matchups. |

</div>
</details>

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

<div class="smallfont">

| Attribute         | Parent Element       | Type    | Description                                                                                                                                                                                       |
| ----------------- | -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `change`          | `group` - `standing` | Integer | Change in a competitor's standing rank from the previous week<br>ex. `2` or `-1`                                                                                                                  |
| `current_outcome` | `group` - `standing` | String  | Current outcome of a competitor for the season<br>ex. `Relegation Round` or `Qualification Playoffs`                                                                                              |
| `draw`            | `group` - `standing` | Integer | Number of ties for a competitor in the season standing group                                                                                                                                      |
| `loss`            | `group` - `standing` | Integer | Number of losses for a competitor in the season standing group                                                                                                                                    |
| `played`          | `group` - `standing` | Integer | Number of matches played for a competitor in the season standing group                                                                                                                            |
| `points`          | `group` - `standing` | Integer | Number of points for a competitor in the season standing group                                                                                                                                    |
| `rank`            | `group` - `standing` | Integer | Competitor rank in the season standing group                                                                                                                                                      |
| `round`           | `season_standing`    | Integer | Number of rounds in the season standing group                                                                                                                                                     |
| `sets_against`    | `group` - `standing` | Integer | Number of sets against for a competitor in the season standing group                                                                                                                              |
| `sets_diff`       | `group` - `standing` | Integer | Set differential for a competitor in the season standing group<br>ex. `18`, `-18`                                                                                                                 |
| `sets_for`        | `group` - `standing` | Integer | Number of sets scored for a competitor in the season standing group                                                                                                                               |
| `tie_break_rule`  | `season_standing`    | String  | Tie break rule for the season standing group<br>ex. `In the event that two (or more) teams have an equal number of points, the following rules break the tie: 1. Goal difference 2. Goals scored` |
| `type`            | `season_standing`    | String  | Category of the season standing group<br>ex. `total`, `home`, `away`                                                                                                                              |
| `win`             | `group` - `standing` | Integer | Number of wins for a competitor in the season standing group                                                                                                                                      |

</div>
</details>

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