Team details

Returns one team with its country, main competition and home stadium. Use it to show a team's profile once you have its id.

curl "https://api.soccer-data.co/v1/teams/team_74p8tg2k93z4" \
  -H "X-Api-Key: $SOCCER_DATA_KEY"

const res = await fetch("https://api.soccer-data.co/v1/teams/team_74p8tg2k93z4", {
  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_74p8tg2k93z4",
    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_74p8tg2k93z4')
    ->json('data');

{
    "data": {
        "id": "team_74p8tg2k93z4",
        "name": "Liverpool",
        "short_name": "Liverpool",
        "country": "England",
        "is_mens_team": true,
        "primary_competition": {
            "id": "competition_705uv6jm8myn",
            "name": "Premier League"
        },
        "stadium": {
            "name": "Anfield",
            "capacity": 61276,
            "city": "Liverpool"
        }
    }
}

### GET /teams/{team_id}

Team details

Returns one team with its country, main competition and home stadium. Use it to show a team's profile once you have its id.
- For the team's fixtures and results, pass its id as team_id to /matches.
- stadium isn't guaranteed to be present for every team.

Response fields:
- `data.id` (string): The team's id.
- `data.name` (string): The team's full name.
- `data.short_name` (string): A shorter name for tight spaces.
- `data.country` (string): The team's country.
- `data.is_mens_team` (boolean): true for a men's team, false for a women's team, null when unknown. Useful when a men's and a women's side share a name.
- `data.primary_competition` (object): The main competition the team plays in. Can be null.
- `data.primary_competition.id` (string): That competition's id.
- `data.primary_competition.name` (string): That competition's name.
- `data.stadium` (object): The team's home ground.
- `data.stadium.name` (string): Stadium name.
- `data.stadium.capacity` (integer): How many people it holds.
- `data.stadium.city` (string): The city it's in.

Example: curl "https://api.soccer-data.co/v1/teams/team_74p8tg2k93z4" -H "X-Api-Key: $SOCCER_DATA_KEY"