get https://api.sportradar.com/americanfootball//v2//seasons//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>