// Teams
Where a team has tables
Lists every competition and season in which a team has a row in the table. Use it to find the competition and season ids you need for a team's past and present tables.
GET
https://api.soccer-data.co/v1/teams/{team_id}/standings
- Competitions are ordered by their most recent season. Inside each one, seasons run newest first.
- A team that only plays knockout cups gets an empty list.
- To get the full table, call /competitions/{competition_id}/seasons/{season_id}/standings with the ids from here.
Path parameters
team_idstringrequired
The team's id, like team_…. Find one with the ID guide.
Response fields
data[].competition.idstring
The competition's id.
data[].competition.namestring
The competition's name.
data[].seasons[].idstring
A season in which the team has a table row.
data[].seasons[].namestring
That season's display name.
data[].seasons[].group_labelstring
The group letter, A to L, when the team's table was a group. Null for an ordinary league.
curl "https://api.soccer-data.co/v1/teams/{team_id}/standings" \
-H "X-Api-Key: $SOCCER_DATA_KEY"
const res = await fetch("https://api.soccer-data.co/v1/teams/{team_id}/standings", {
headers: { "X-Api-Key": process.env.SOCCER_DATA_KEY },
});
const { data } = await res.json();
import os, requests
res = requests.get(
"https://api.soccer-data.co/v1/teams/{team_id}/standings",
headers={"X-Api-Key": os.environ["SOCCER_DATA_KEY"]},
)
data = res.json()["data"]
$data = Http::withHeaders(['X-Api-Key' => env('SOCCER_DATA_KEY')])
->get('https://api.soccer-data.co/v1/teams/{team_id}/standings')
->json('data');
200 · Example response
{
"data": [
{
"competition": {
"id": "competition_705uv6jm8myn",
"name": "Premier League"
},
"seasons": [
{
"id": "season_hr1ie7yrsdmt",
"name": "Premier League 26/27",
"group_label": null
},
{
"id": "season_98l95mxugqs9",
"name": "Premier League 25/26",
"group_label": null
}
]
},
{
"competition": {
"id": "competition_b25me9a3vyf7",
"name": "UEFA Europa League"
},
"seasons": [
{
"id": "season_dgf6gghi4mf8",
"name": "UEFA Europa League 22/23",
"group_label": "A"
}
]
}
]
}
### GET /teams/{team_id}/standings
Where a team has tables
Lists every competition and season in which a team has a row in the table. Use it to find the competition and season ids you need for a team's past and present tables.
- Competitions are ordered by their most recent season. Inside each one, seasons run newest first.
- A team that only plays knockout cups gets an empty list.
- To get the full table, call /competitions/{competition_id}/seasons/{season_id}/standings with the ids from here.
Response fields:
- `data[].competition.id` (string): The competition's id.
- `data[].competition.name` (string): The competition's name.
- `data[].seasons[].id` (string): A season in which the team has a table row.
- `data[].seasons[].name` (string): That season's display name.
- `data[].seasons[].group_label` (string): The group letter, A to L, when the team's table was a group. Null for an ordinary league.
Example: curl "https://api.soccer-data.co/v1/teams/{team_id}/standings" -H "X-Api-Key: $SOCCER_DATA_KEY"