// Competitions
Groups in a tournament season
Lists the groups of a season that has a group stage, such as a World Cup, EURO or AFCON, from A up to L. Use the labels to fetch one group's fixtures or table.
GET
https://api.soccer-data.co/v1/competitions/{competition_id}/seasons/{season_id}/groups
- Competitions without groups, like a domestic league, return an empty list.
- Pass a group_label as group to /matches (together with competition_id) or to the season standings endpoint.
- A season_id that belongs to a different competition returns 400 SEASON_COMPETITION_MISMATCH.
Path parameters
competition_idstringrequired
The competition's id, like competition_…. Find one with the ID guide.
season_idstringrequired
The season's id, like season_…. Find one with the ID guide.
Response fields
data[].group_labelstring
The group's letter, A to L. This is the value the group filters accept.
data[].namestring
A name ready to show, in English, such as Group A.
curl "https://api.soccer-data.co/v1/competitions/competition_7vpwx91c7j7h/seasons/season_st2tyewgtq2j/groups" \ -H "X-Api-Key: $SOCCER_DATA_KEY"
const res = await fetch("https://api.soccer-data.co/v1/competitions/competition_7vpwx91c7j7h/seasons/season_st2tyewgtq2j/groups", {
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/competitions/competition_7vpwx91c7j7h/seasons/season_st2tyewgtq2j/groups",
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/competitions/competition_7vpwx91c7j7h/seasons/season_st2tyewgtq2j/groups')
->json('data');
200 · Example response
{
"data": [
{
"group_label": "A",
"name": "Group A"
},
{
"group_label": "B",
"name": "Group B"
},
{
"group_label": "C",
"name": "Group C"
}
]
}
### GET /competitions/{competition_id}/seasons/{season_id}/groups
Groups in a tournament season
Lists the groups of a season that has a group stage, such as a World Cup, EURO or AFCON, from A up to L. Use the labels to fetch one group's fixtures or table.
- Competitions without groups, like a domestic league, return an empty list.
- Pass a group_label as group to /matches (together with competition_id) or to the season standings endpoint.
- A season_id that belongs to a different competition returns 400 SEASON_COMPETITION_MISMATCH.
Response fields:
- `data[].group_label` (string): The group's letter, A to L. This is the value the group filters accept.
- `data[].name` (string): A name ready to show, in English, such as Group A.
Example: curl "https://api.soccer-data.co/v1/competitions/competition_7vpwx91c7j7h/seasons/season_st2tyewgtq2j/groups" -H "X-Api-Key: $SOCCER_DATA_KEY"