Competitions
Get season standings
Returns the league table for one competition season, one row per team, sorted by position. Group-stage tournaments return every group’s table, sorted by group_label and then position; add group to get one group. Knockout-only cups (such as the FA Cup) return an empty list. Returns 400 if season_id belongs to a different competition.
Examples
- Premier League 2026/27:
GET /football/competitions/comp_3039/seasons/sn_8406098/standings - World Cup 2022, Group A:
GET /football/competitions/comp_6107/seasons/sn_326766/standings?group=A
GET
/
football
/
competitions
/
{competition_id}
/
seasons
/
{season_id}
/
standings
Get season standings
curl --request GET \
--url https://api.thestatsapi.com/api/football/competitions/{competition_id}/seasons/{season_id}/standings \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.thestatsapi.com/api/football/competitions/{competition_id}/seasons/{season_id}/standings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.thestatsapi.com/api/football/competitions/{competition_id}/seasons/{season_id}/standings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"team": {
"id": "tm_9145",
"name": "Arsenal"
},
"matches_played": 38,
"wins": 26,
"draws": 7,
"losses": 5,
"goals_for": 71,
"goals_against": 27,
"goal_difference": 44,
"points": 85,
"position": 1,
"group_label": null
}
]
}Walkthrough with code: Standings.
Authorizations
Your API key, sent as Authorization: Bearer YOUR_API_KEY. Get one at https://www.thestatsapi.com/api-keys
Path Parameters
Query Parameters
⌘I
Get season standings
curl --request GET \
--url https://api.thestatsapi.com/api/football/competitions/{competition_id}/seasons/{season_id}/standings \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.thestatsapi.com/api/football/competitions/{competition_id}/seasons/{season_id}/standings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.thestatsapi.com/api/football/competitions/{competition_id}/seasons/{season_id}/standings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"team": {
"id": "tm_9145",
"name": "Arsenal"
},
"matches_played": 38,
"wins": 26,
"draws": 7,
"losses": 5,
"goals_for": 71,
"goals_against": 27,
"goal_difference": 44,
"points": 85,
"position": 1,
"group_label": null
}
]
}