Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Season Standings

Global Football 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:83005` (NFL 24/25)                                                                                        |
| `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. `NFL 24/25`                                                                                                                |
| `group_name`      | `season_standing` - `groups` - `group` | String  | Abbreviated name of a standings group<br>ex. `NFL 24/25, AFC`                                                                                               |
| `parent_group_id` | `season_standing` - `groups` - `group` | String  | Unique ID for a parent of a standings group. For example, the AFC (`sr:league:83007`) could be a child of NFL (`sr:league:83005`) <br>ex. `sr:league:83007` |

</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. `2025-01-05`
      </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. `regular season`, `conference`, `playoffs`<br><br>See the <b>enum\_phase</b> entry in our [Global American Football OpenAPI spec](https://api.sportradar.com/americanfootball/trial/v2/openapi/swagger/index.html) 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. `2024-09-05`
      </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. `DEN` (Denver Broncos)                                         |
| `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. `USA`                                                                     |
| `country_code` | `standing` - `competitor`    | String  | Country code of a competitor<br>ex. `USA` (United States))                                               |
| `division`     | `standing` - `competitor`    | Integer | Division number for a competitor                                                                         |
| `gender`       | `standing` - `competitor`    | String  | Gender for a competitor<br>`male`, `female`                                                              |
| `id`           | `competitors` - competitor\` | String  | Unique ID for a competitor<br>ex. `sr:competitor:4418` (Denver Broncos)                                  |
| `name`         | `standing` - `competitor`    | String  | Name for a competitor<br>ex. `Denver Broncos`                                                            |
| `qualifier`    | `standing` - `competitor`    | String  | Designation of a competitor for a sport event<br>`home`, `away`                                          |
| `state`        | `standing` - `competitor`    | String  | State of a competitor<br>ex. `CO` (Colorado)                                                             |
| `virtual`      | `standing` - `competitor`    | Boolean | Signifies a competitor is a virtual team whan `true`. Used for placeholder teams in TBD vs TBD matchups. |

</div>
</details>

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

<div class="smallfont">

| Attribute         | Parent Element       | Type    | Description                                                                                                                                                                             |
| ----------------- | -------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tie_break_rule`  | `season_standing`    | String  | Tie break rule for the season standing group<br>ex. `The NFL overall table is sorted by percentage`                                                                                     |
| `type`            | `season_standing`    | String  | Category of the season standing group<br>`total`, `home`, `away`, `first_half_total`, `first_half_home`, `first_half_away`, `second_half_total`, `second_half_home`, `second_half_away` |
| `round`           | `season_standing`    | Integer | Number of rounds in the season standing group                                                                                                                                           |
| `change`          | `group` - `standing` | Integer | Change in a team's standing rank from the previous week<br>ex. `2` or `-1`                                                                                                              |
| `current_outcome` | `group` - `standing` | String  | Current outcome of a team for the season<br>ex. `Qualification Playoffs` or `Playoffs`                                                                                                  |
| `draw`            | `group` - `standing` | Integer | Number of ties for a team in the season standing group                                                                                                                                  |
| `goals_against`   | `group` - `standing` | Integer | Number of points against for a team in the season standing group                                                                                                                        |
| `goals_diff`      | `group` - `standing` | Integer | Points differential for a team in the season standing group<br>ex. `18`, `-18`                                                                                                          |
| `goals_for`       | `group` - `standing` | Integer | Number of points scored for a team in the season standing group                                                                                                                         |
| `loss`            | `group` - `standing` | Integer | Number of losses for a team in the season standing group                                                                                                                                |
| `played`          | `group` - `standing` | Integer | Number of games played for a team in the season standing group                                                                                                                          |
| `rank`            | `group` - `standing` | Integer | Team rank in the season standing group                                                                                                                                                  |
| `win`             | `group` - `standing` | Integer | Number of wins for a team in the season standing group                                                                                                                                  |

</div>
</details>

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