# UEFA

> Follow UEFA's competitions, from the Champions League to the EURO: fixtures and results, lineups, match events and statistics, standings, squads, player and team leaderboards, and uefa.com's news. Start a workflow when a match finishes. No account or API key needed.

App · 16 actions. Web page: https://docs.lodol.com/docs/integrations/uefa

## Actions

### Get head-to-head

Get every meeting of two teams in a competition, across all seasons: wins, draws and goals for each side, and the matches themselves, newest first.

**Inputs**

- Competition (`competition`, text, required): The UEFA competition. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Team (`team`, text, required): The team. Pick one, or give its UEFA id from an earlier step.
- Opponent (`opponent`, text, required): The other team. Pick one, or give its UEFA id.

**Outputs**

- `competition` (text): The competition.
- `count` (number): Meetings listed, upcoming ones included.
- `draws` (number): Meetings drawn.
- `matches` (list): The meetings, newest first.
- `opponent` (text): The second team.
- `opponent_goals` (number): Goals the opponent scored.
- `opponent_wins` (number): Meetings the opponent won.
- `played` (number): Finished meetings.
- `team` (text): The first team.
- `team_goals` (number): Goals the first team scored.
- `team_wins` (number): Meetings the first team won (shoot-outs count).

**Example output**

```json
{
  "competition": "Champions League",
  "count": 2,
  "draws": 4,
  "matches": [
    {
      "attendance": 75000,
      "away_aggregate": 4,
      "away_penalties": null,
      "away_score": 3,
      "away_team": {
        "code": "RMA",
        "country": "Spain",
        "id": "50051",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50051.png",
        "name": "Real Madrid"
      },
      "city": "Munich",
      "competition": "Champions League",
      "competition_id": "1",
      "date": "2026-04-15",
      "finished_at": "2026-04-15T20:55:53.504Z",
      "goals": [
        {
          "added_time": null,
          "minute": 1,
          "player": "Arda G\u00fcler",
          "player_id": "250161881",
          "team": "Real Madrid",
          "team_id": "50051",
          "time": "1'",
          "type": "goal"
        },
        {
          "added_time": null,
          "minute": 6,
          "player": "Aleksandar Pavlovi\u0107",
          "player_id": "250163777",
          "team": "Bayern M\u00fcnchen",
          "team_id": "50037",
          "time": "6'",
          "type": "goal"
        }
      ],
      "group": null,
      "home_aggregate": 6,
      "home_penalties": null,
      "home_score": 4,
      "home_team": {
        "code": "BAY",
        "country": "Germany",
        "id": "50037",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50037.png",
        "name": "Bayern M\u00fcnchen"
      },
      "id": "2048070",
      "kick_off": "2026-04-15T19:00:00Z",
      "leg": "2nd leg",
      "matchday": "Matchday 14",
      "minute": null,
      "player_of_the_match": "Michael Olise",
      "referee": "Slavko Vin\u010di\u0107",
      "result": "Bayern M\u00fcnchen win",
      "round": "Quarter-finals",
      "season": "2026",
      "stadium": "Fu\u00dfball Arena M\u00fcnchen",
      "stage": "Main competition",
      "status": "finished",
      "summary": "Bayern M\u00fcnchen 4-3 Real Madrid",
      "url": "https://www.uefa.com/uefachampionsleague/match/2048070/",
      "winner": {
        "code": "BAY",
        "country": "Germany",
        "id": "50037",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50037.png",
        "name": "Bayern M\u00fcnchen"
      }
    },
    {
      "attendance": 77106,
      "away_aggregate": 6,
      "away_penalties": null,
      "away_score": 2,
      "away_team": {
        "code": "BAY",
        "country": "Germany",
        "id": "50037",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50037.png",
        "name": "Bayern M\u00fcnchen"
      },
      "city": "Madrid",
      "competition": "Champions League",
      "competition_id": "1",
      "date": "2026-04-07",
      "finished_at": "2026-04-07T20:53:28.463Z",
      "goals": [
        {
          "added_time": null,
          "minute": 41,
          "player": "Luis D\u00edaz",
          "player_id": "250132811",
          "team": "Bayern M\u00fcnchen",
          "team_id": "50037",
          "time": "41'",
          "type": "goal"
        },
        {
          "added_time": null,
          "minute": 46,
          "player": "Harry Kane",
          "player_id": "250016833",
          "team": "Bayern M\u00fcnchen",
          "team_id": "50037",
          "time": "46'",
          "type": "goal"
        }
      ],
      "group": null,
      "home_aggregate": 4,
      "home_penalties": null,
      "home_score": 1,
      "home_team": {
        "code": "RMA",
        "country": "Spain",
        "id": "50051",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50051.png",
        "name": "Real Madrid"
      },
      "id": "2048064",
      "kick_off": "2026-04-07T19:00:00Z",
      "leg": "1st leg",
      "matchday": "Matchday 13",
      "minute": null,
      "player_of_the_match": "Manuel Neuer",
      "referee": "Michael Oliver",
      "result": "Bayern M\u00fcnchen won the first leg",
      "round": "Quarter-finals",
      "season": "2026",
      "stadium": "Estadio Santiago Bernab\u00e9u",
      "stage": "Main competition",
      "status": "finished",
      "summary": "Real Madrid 1-2 Bayern M\u00fcnchen",
      "url": "https://www.uefa.com/uefachampionsleague/match/2048064/",
      "winner": {
        "code": "BAY",
        "country": "Germany",
        "id": "50037",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50037.png",
        "name": "Bayern M\u00fcnchen"
      }
    }
  ],
  "opponent": "Real Madrid",
  "opponent_goals": 49,
  "opponent_wins": 13,
  "played": 30,
  "team": "Bayern M\u00fcnchen",
  "team_goals": 48,
  "team_wins": 13
}
```

### Get lineups

Get both teams' starting eleven, substitutes and coach for a match. Lineups appear about an hour before kick-off; until then 'available' is false.

**Inputs**

- Match ID (`match_id`, text, required): The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.

**Outputs**

- `available` (true/false): False until UEFA publishes the lineups.
- `away` (object): The away team's lineup.
- `home` (object): The home team's lineup.
- `match_id` (text): The match.

**Example output**

```json
{
  "available": true,
  "away": {
    "coach": "Sebastian Hoene\u00df",
    "starting_eleven": [
      {
        "id": "250070418",
        "is_captain": false,
        "name": "Fabian Bredlow",
        "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250070418.jpg",
        "position": "Goalkeeper",
        "shirt_number": 1
      },
      {
        "id": "250106750",
        "is_captain": false,
        "name": "Ramon Hendriks",
        "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250106750.jpg",
        "position": "Defender",
        "shirt_number": 3
      }
    ],
    "substitutes": [
      {
        "id": "250058261",
        "is_captain": false,
        "name": "Marius Funk",
        "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250058261.jpg",
        "position": "Goalkeeper",
        "shirt_number": 33
      },
      {
        "id": "250170952",
        "is_captain": false,
        "name": "Dennis Seimen",
        "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250170952.jpg",
        "position": "Goalkeeper",
        "shirt_number": 41
      }
    ],
    "team": {
      "code": "STU",
      "country": "Germany",
      "id": "50107",
      "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50107.png",
      "name": "Stuttgart"
    }
  },
  "home": {
    "coach": "Yaya Tour\u00e9",
    "starting_eleven": [
      {
        "id": "250157134",
        "is_captain": false,
        "name": "Dominik Tak\u00e1\u010d",
        "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250157134.jpg",
        "position": "Goalkeeper",
        "shirt_number": 71
      },
      {
        "id": "250114171",
        "is_captain": false,
        "name": "Peter Pokorn\u00fd",
        "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250114171.jpg",
        "position": "Midfielder",
        "shirt_number": 3
      }
    ],
    "substitutes": [
      {
        "id": "250089413",
        "is_captain": false,
        "name": "Aleksandar Popovi\u0107",
        "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250089413.jpg",
        "position": "Goalkeeper",
        "shirt_number": 1
      },
      {
        "id": "250089337",
        "is_captain": false,
        "name": "Samuel Kozlovsk\u00fd",
        "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250089337.jpg",
        "position": "Defender",
        "shirt_number": 2
      }
    ],
    "team": {
      "code": "SBR",
      "country": "Slovakia",
      "id": "52797",
      "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52797.png",
      "name": "S. Bratislava"
    }
  },
  "match_id": "2049587"
}
```

### Get match

Get one match: the teams, score (with penalties and aggregate), status, scorers, player of the match, stadium, crowd, referee and its page on uefa.com.

**Inputs**

- Match ID (`match_id`, text, required): The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.

**Outputs**

- `attendance` (number): The crowd.
- `away_aggregate` (number): Away team's aggregate score after a second leg.
- `away_penalties` (number): Away penalties scored in a shoot-out.
- `away_score` (number): Away goals (after extra time); empty before kick-off.
- `away_team` (object): The away team.
- `city` (text): The stadium's city.
- `competition` (text): The competition, e.g. 'Champions League'.
- `competition_id` (text): The competition's UEFA id.
- `date` (text): The match date, YYYY-MM-DD.
- `finished_at` (text): When the final whistle went, ISO 8601 in UTC.
- `goals` (list): The goals, in order.
- `group` (text): The group or league, e.g. 'Group A1' or 'League'.
- `home_aggregate` (number): Home team's aggregate score after a second leg.
- `home_penalties` (number): Home penalties scored in a shoot-out.
- `home_score` (number): Home goals (after extra time); empty before kick-off.
- `home_team` (object): The home team.
- `id` (text): The match's UEFA id: use it with the other match actions.
- `kick_off` (text): Kick-off, ISO 8601 in UTC.
- `leg` (text): '1st leg' or '2nd leg' in a two-legged tie.
- `matchday` (text): The matchday, e.g. 'Matchday 2'.
- `minute` (number): The minute being played, while the match is live.
- `player_of_the_match` (text): The player of the match, when named.
- `referee` (text): The referee.
- `result` (text): 'Stuttgart win', 'Draw' or 'Paris win on penalties'.
- `round` (text): The round, e.g. 'League phase' or 'Final'.
- `season` (text): The year the season ends in, e.g. '2027' for 2026/27.
- `stadium` (text): The stadium.
- `stage` (text): Main competition, Qualifying or Preliminary round.
- `status` (text): upcoming, live, finished, postponed or abandoned.
- `summary` (text): One line: 'Paris 1-1 Arsenal (4-3 on penalties)', or 'Paris v Barcelona' before kick-off.
- `url` (text): The match page on uefa.com.
- `winner` (object): The team that won the match; empty for a draw.

**Example output**

```json
{
  "attendance": 61035,
  "away_aggregate": null,
  "away_penalties": 3,
  "away_score": 1,
  "away_team": {
    "code": "ARS",
    "country": "England",
    "id": "52280",
    "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52280.png",
    "name": "Arsenal"
  },
  "city": "Budapest",
  "competition": "Champions League",
  "competition_id": "1",
  "date": "2026-05-30",
  "finished_at": "2026-05-30T19:00:24.003Z",
  "goals": [
    {
      "added_time": null,
      "minute": 6,
      "player": "Kai Havertz",
      "player_id": "250087938",
      "team": "Arsenal",
      "team_id": "52280",
      "time": "6'",
      "type": "goal"
    },
    {
      "added_time": null,
      "minute": 65,
      "player": "Ousmane Demb\u00e9l\u00e9",
      "player_id": "250066886",
      "team": "Paris",
      "team_id": "52747",
      "time": "65'",
      "type": "penalty"
    }
  ],
  "group": null,
  "home_aggregate": null,
  "home_penalties": 4,
  "home_score": 1,
  "home_team": {
    "code": "PSG",
    "country": "France",
    "id": "52747",
    "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52747.png",
    "name": "Paris"
  },
  "id": "2047742",
  "kick_off": "2026-05-30T16:00:00Z",
  "leg": null,
  "matchday": "Matchday 17",
  "minute": null,
  "player_of_the_match": "Vitinha",
  "referee": "Daniel Siebert",
  "result": "Paris win on penalties",
  "round": "Final",
  "season": "2026",
  "stadium": "Pusk\u00e1s Ar\u00e9na",
  "stage": "Main competition",
  "status": "finished",
  "summary": "Paris 1-1 Arsenal (4-3 on penalties)",
  "url": "https://www.uefa.com/uefachampionsleague/match/2047742/",
  "winner": {
    "code": "PSG",
    "country": "France",
    "id": "52747",
    "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52747.png",
    "name": "Paris"
  }
}
```

### Get match events

Get what happened in a match, minute by minute: goals, cards and substitutions, or every key moment, or everything down to each shot and foul.

**Inputs**

- Match ID (`match_id`, text, required): The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.
- Events (`include`, text): Which events to include. Defaults to goals, cards and substitutions. One of: `LINEUP` (Goals, cards and substitutions), `MAIN` (Key moments (adds kick-off, corners, half-time and full-time)), `ALL` (Everything (adds shots, saves, fouls and free kicks)).

**Outputs**

- `count` (number): How many events were returned.
- `events` (list): The events, in the order they happened.
- `match_id` (text): The match.

**Example output**

```json
{
  "count": 2,
  "events": [
    {
      "added_time": null,
      "description": "Yellow card: Ramon Hendriks (Stuttgart)",
      "id": "fd301487-7aa0-48ee-9385-86bc1d25cc14",
      "minute": 12,
      "other_player": null,
      "period": "First half",
      "player": "Ramon Hendriks",
      "player_id": "250106750",
      "team": "Stuttgart",
      "team_id": "50107",
      "time": "12'",
      "type": "Yellow card"
    },
    {
      "added_time": null,
      "description": "Yellow card: Bilal El Khannouss (Stuttgart)",
      "id": "0a989334-106a-46db-a49b-b95936eb6159",
      "minute": 26,
      "other_player": null,
      "period": "First half",
      "player": "Bilal El Khannouss",
      "player_id": "250154129",
      "team": "Stuttgart",
      "team_id": "50107",
      "time": "26'",
      "type": "Yellow card"
    }
  ],
  "match_id": "2049587"
}
```

### Get match statistics

Get each team's numbers in a match: possession, shots, passes, corners, tackles, saves, fouls, cards, distance covered and top speed. Available once the match is under way.

**Inputs**

- Match ID (`match_id`, text, required): The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.

**Outputs**

- `available` (true/false): False until UEFA has statistics for the match.
- `away` (object): The away team's numbers.
- `home` (object): The home team's numbers.
- `match_id` (text): The match.
- `summary` (text): The score line.

**Example output**

```json
{
  "available": true,
  "away": {
    "balls_recovered": 31,
    "corners": 8,
    "crosses": 27,
    "crosses_completed": 7,
    "distance_covered_km": 124.41,
    "fouls_committed": 15,
    "fouls_suffered": 11,
    "goals": 3,
    "offsides": 2,
    "passes": 634,
    "passes_completed": 577,
    "passing_accuracy": 91,
    "possession": 62,
    "red_cards": 0,
    "saves": 1,
    "shots": 16,
    "shots_blocked": 2,
    "shots_off_target": 7,
    "shots_on_target": 8,
    "tackles": 10,
    "team": {
      "code": "STU",
      "country": "Germany",
      "id": "50107",
      "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50107.png",
      "name": "Stuttgart"
    },
    "top_speed_kmh": 34.34,
    "yellow_cards": 3
  },
  "home": {
    "balls_recovered": 36,
    "corners": 1,
    "crosses": 7,
    "crosses_completed": 1,
    "distance_covered_km": 117.58,
    "fouls_committed": 11,
    "fouls_suffered": 15,
    "goals": 0,
    "offsides": 1,
    "passes": 361,
    "passes_completed": 297,
    "passing_accuracy": 82,
    "possession": 38,
    "red_cards": 0,
    "saves": 6,
    "shots": 15,
    "shots_blocked": 6,
    "shots_off_target": 8,
    "shots_on_target": 1,
    "tackles": 15,
    "team": {
      "code": "SBR",
      "country": "Slovakia",
      "id": "52797",
      "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52797.png",
      "name": "S. Bratislava"
    },
    "top_speed_kmh": 33.24,
    "yellow_cards": 1
  },
  "match_id": "2049587",
  "summary": "S. Bratislava 0-3 Stuttgart"
}
```

### Get player

Get a player's profile: name, position, shirt number, nationality, date of birth, age and height.

**Inputs**

- Player ID (`player`, text, required): The player's UEFA id, from 'Get squad', 'Get lineups' or 'Get top players'.

**Outputs**

- `age` (number): Age in years.
- `birth_date` (text): Date of birth, YYYY-MM-DD.
- `club_id` (text): The UEFA id of the player's club.
- `country_code` (text): UEFA's three-letter country code, e.g. 'NOR'.
- `first_name` (text): First name.
- `height_cm` (number): Height in centimetres, when UEFA has it.
- `id` (text): The player's UEFA id.
- `last_name` (text): Last name.
- `name` (text): The player's name, e.g. 'Erling Haaland'.
- `nationality` (text): The country the player represents, e.g. 'Norway'.
- `position` (text): Goalkeeper, Defender, Midfielder or Forward.
- `shirt_number` (number): Shirt number.

**Example output**

```json
{
  "age": 26,
  "birth_date": "2000-07-21",
  "club_id": "52919",
  "country_code": "NOR",
  "first_name": "Erling",
  "height_cm": null,
  "id": "250103758",
  "last_name": "Haaland",
  "name": "Erling Haaland",
  "nationality": "Norway",
  "position": "Forward",
  "shirt_number": 9
}
```

### Get player match statistics

Get each player's numbers in a match (or one player's): minutes, goals, assists, shots, passes, tackles, saves, distance covered and more, for everyone who played, most minutes first.

**Inputs**

- Match ID (`match_id`, text, required): The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.
- Player ID (`player`, text): Only this player's numbers. Leave blank for everyone who played.

**Outputs**

- `count` (number): How many players were returned.
- `match_id` (text): The match.
- `players` (list): The players who played, most minutes first.

**Example output**

```json
{
  "count": 1,
  "match_id": "2049587",
  "players": [
    {
      "appearances": 1,
      "assists": 0,
      "balls_recovered": 2,
      "clean_sheets": 1,
      "distance_covered_km": 11.18,
      "dribbles": 1,
      "fouls_committed": 4,
      "fouls_suffered": 1,
      "goals": 1,
      "goals_conceded": 0,
      "key_passes": 0,
      "minutes_played": 90,
      "offsides": 1,
      "passes": 33,
      "passes_completed": 26,
      "passing_accuracy": 79,
      "player": "Deniz Undav",
      "player_id": "250194673",
      "position": "Forward",
      "red_cards": 0,
      "saves": 0,
      "shirt_number": 26,
      "shots": 4,
      "shots_on_target": 3,
      "tackles": 3,
      "tackles_won": 1,
      "team": "Stuttgart",
      "team_id": "50107",
      "top_speed_kmh": 28.24,
      "yellow_cards": 0
    }
  ]
}
```

### Get player season statistics

Get a player's totals for a competition's season: appearances, minutes, goals, assists, shots, passes, tackles, saves, clean sheets, cards, distance covered and top speed.

**Inputs**

- Competition (`competition`, text, required): The UEFA competition. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Team (`team`, text): The player's team, to choose the player from its squad.
- Player (`player`, text, required): The player. Pick one, or give their UEFA id from an earlier step.
- Season (`season`, text): The season. Leave blank for the current one.
- Stage (`stage`, text): The main competition or its qualifying rounds. Defaults to the main competition. One of: `TOURNAMENT` (Main competition), `QUALIFYING`.

**Outputs**

- `appearances` (number): Appearances.
- `assists` (number): Assists.
- `balls_recovered` (number): Balls recovered.
- `clean_sheets` (number): Clean sheets.
- `competition` (text): The competition.
- `distance_covered_km` (number): Distance covered (km).
- `dribbles` (number): Dribbles.
- `fouls_committed` (number): Fouls committed.
- `fouls_suffered` (number): Fouls suffered.
- `goals` (number): Goals.
- `goals_conceded` (number): Goals conceded.
- `key_passes` (number): Key passes.
- `minutes_played` (number): Minutes played.
- `offsides` (number): Offsides.
- `passes` (number): Passes.
- `passes_completed` (number): Passes completed.
- `passing_accuracy` (number): Passing accuracy (%).
- `played` (true/false): False when the player has not played in it.
- `player` (text): The player's name.
- `player_id` (text): The player.
- `red_cards` (number): Red cards.
- `saves` (number): Saves.
- `season` (text): The season.
- `shots` (number): Shots.
- `shots_on_target` (number): Shots on target.
- `stage` (text): Main competition or Qualifying.
- `tackles` (number): Tackles.
- `tackles_won` (number): Tackles won.
- `team_id` (text): The team they played for.
- `top_speed_kmh` (number): Top speed (km/h).
- `yellow_cards` (number): Yellow cards.

**Example output**

```json
{
  "appearances": 2,
  "assists": 0,
  "balls_recovered": 2,
  "clean_sheets": 1,
  "competition": "Champions League",
  "distance_covered_km": 20.02,
  "dribbles": 3,
  "fouls_committed": 4,
  "fouls_suffered": 1,
  "goals": 4,
  "goals_conceded": 0,
  "key_passes": 1,
  "minutes_played": 180,
  "offsides": 0,
  "passes": 40,
  "passes_completed": 28,
  "passing_accuracy": 69.5,
  "played": true,
  "player": "Erling Haaland",
  "player_id": "250103758",
  "red_cards": 0,
  "saves": 0,
  "season": "2026/27",
  "shots": 13,
  "shots_on_target": 7,
  "stage": "Main competition",
  "tackles": 0,
  "tackles_won": 0,
  "team_id": "52919",
  "top_speed_kmh": 36.01,
  "yellow_cards": 1
}
```

### Get squad

Get the players a team registered for a competition's season: goalkeepers first, then defenders, midfielders and forwards, each by shirt number.

**Inputs**

- Competition (`competition`, text, required): The UEFA competition. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Team (`team`, text, required): The team. Pick one, or give its UEFA id from an earlier step.
- Season (`season`, text): The season. Leave blank for the current one.

**Outputs**

- `competition` (text): The competition.
- `count` (number): How many players are registered.
- `players` (list): The squad.
- `season` (text): The season.
- `team_id` (text): The team.

**Example output**

```json
{
  "competition": "Champions League",
  "count": 2,
  "players": [
    {
      "age": 31,
      "birth_date": "1995-03-02",
      "club_id": "50107",
      "country_code": "GER",
      "first_name": "Fabian",
      "height_cm": 191,
      "id": "250070418",
      "last_name": "Bredlow",
      "name": "Fabian Bredlow",
      "nationality": "Germany",
      "position": "Goalkeeper",
      "shirt_number": 1
    },
    {
      "age": 17,
      "birth_date": "2009-01-24",
      "club_id": "50107",
      "country_code": "GER",
      "first_name": "Tom",
      "height_cm": null,
      "id": "250218212",
      "last_name": "Walz",
      "name": "Tom Walz",
      "nationality": "Germany",
      "position": "Goalkeeper",
      "shirt_number": 1
    }
  ],
  "season": "2026/27",
  "team_id": "50107"
}
```

### Get standings

Get the league table for a season, or every group's table in a competition played in groups, such as the Nations League: position, played, won, drawn, lost, goals and points.

**Inputs**

- Competition (`competition`, text, required): The UEFA competition. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Season (`season`, text): The season. Leave blank for the current one.

**Outputs**

- `competition` (text): The competition.
- `count` (number): How many tables were returned.
- `groups` (list): One table per league or group. Empty for a competition played only as knockout rounds.
- `season` (text): The season.

**Example output**

```json
{
  "competition": "Nations League",
  "count": 2,
  "groups": [
    {
      "name": "Group A1",
      "round": "League phase",
      "table": [
        {
          "drawn": 1,
          "goal_difference": 5,
          "goals_against": 2,
          "goals_for": 7,
          "lost": 0,
          "played": 4,
          "points": 10,
          "position": 1,
          "team": {
            "code": "FRA",
            "country": "France",
            "id": "43",
            "logo_url": "https://img.uefa.com/imgml/flags/240x240/FRA.png",
            "name": "France"
          },
          "won": 3
        },
        {
          "drawn": 1,
          "goal_difference": 3,
          "goals_against": 5,
          "goals_for": 8,
          "lost": 1,
          "played": 4,
          "points": 7,
          "position": 2,
          "team": {
            "code": "ITA",
            "country": "Italy",
            "id": "66",
            "logo_url": "https://img.uefa.com/imgml/flags/240x240/ITA.png",
            "name": "Italy"
          },
          "won": 2
        }
      ]
    },
    {
      "name": "Group A2",
      "round": "League phase",
      "table": [
        {
          "drawn": 2,
          "goal_difference": 2,
          "goals_against": 5,
          "goals_for": 7,
          "lost": 0,
          "played": 4,
          "points": 8,
          "position": 1,
          "team": {
            "code": "NED",
            "country": "Netherlands",
            "id": "95",
            "logo_url": "https://img.uefa.com/imgml/flags/240x240/NED.png",
            "name": "Netherlands"
          },
          "won": 2
        },
        {
          "drawn": 2,
          "goal_difference": 2,
          "goals_against": 3,
          "goals_for": 5,
          "lost": 0,
          "played": 4,
          "points": 8,
          "position": 2,
          "team": {
            "code": "GRE",
            "country": "Greece",
            "id": "49",
            "logo_url": "https://img.uefa.com/imgml/flags/240x240/GRE.png",
            "name": "Greece"
          },
          "won": 2
        }
      ]
    }
  ],
  "season": "2027"
}
```

### Get team

Get a club or national team: its names, country and badge, with its latest results in every competition (domestic league included) and its form, such as 'WWDLW'.

**Inputs**

- Team (`team`, text, required): The team. Pick one, or give its UEFA id from an earlier step.
- Recent matches (`recent_matches`, number): How many recent results to include, 1 to 10. Defaults to 5. From 1 to 10.

**Outputs**

- `code` (text): The three-letter code, e.g. 'MCI'.
- `country` (text): The team's country, e.g. 'England'.
- `country_code` (text): UEFA's three-letter country code, e.g. 'ENG'.
- `form` (text): Recent results, newest first: W, D or L for each.
- `full_name` (text): The official name, e.g. 'Manchester City FC'.
- `id` (text): The team's UEFA id.
- `is_national_team` (true/false): True for a national team, false for a club.
- `large_logo_url` (text): The team's badge or flag, 700px.
- `logo_url` (text): The team's badge (or flag for a national team), 240px.
- `name` (text): The team's name as UEFA shows it, e.g. 'Man City'.
- `recent_matches` (list): The latest results, newest first.
- `short_name` (text): The short name, e.g. 'Man City'.

**Example output**

```json
{
  "code": "STU",
  "country": "Germany",
  "country_code": "GER",
  "form": "LW",
  "full_name": "VfB Stuttgart",
  "id": "50107",
  "is_national_team": false,
  "large_logo_url": "https://img.uefa.com/imgml/TP/teams/logos/700x700/50107.png",
  "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50107.png",
  "name": "Stuttgart",
  "recent_matches": [
    {
      "competition": "German Bundesliga",
      "date": "2026-10-17",
      "home_or_away": "away",
      "match_id": "6a46593e27729939551db072",
      "opponent": "Hamburg",
      "outcome": "loss",
      "score": "1-0"
    },
    {
      "competition": "Champions League",
      "date": "2026-10-14",
      "home_or_away": "away",
      "match_id": "2049587",
      "opponent": "S. Bratislava",
      "outcome": "win",
      "score": "0-3"
    }
  ],
  "short_name": "Stuttgart"
}
```

### Get top players

Rank a competition's players by one statistic: top scorers, most assists, most saves, fastest players and more, across the competition or within one team.

**Inputs**

- Competition (`competition`, text, required): The UEFA competition. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Ranked by (`statistic`, text, required): The statistic to rank players by. One of: `goals`, `assists`, `appearances`, `minutes_played` (Minutes played), `shots`, `shots_on_target` (Shots on target), `passes_completed` (Passes completed), `key_passes` (Key passes), `tackles_won` (Tackles won), `balls_recovered` (Balls recovered), and 7 more.
- Season (`season`, text): The season. Leave blank for the current one.
- Stage (`stage`, text): The main competition or its qualifying rounds. Defaults to the main competition. One of: `TOURNAMENT` (Main competition), `QUALIFYING`.
- Team (`team`, text): Only this team's. Leave blank for every team.
- Order (`order`, text): Highest first (the default) or lowest first. One of: `DESC` (Highest first), `ASC` (Lowest first).
- How many (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.

**Outputs**

- `competition` (text): The competition.
- `count` (number): How many players were returned.
- `players` (list): The players, best first.
- `season` (text): The season.
- `statistic` (text): What the players are ranked by.

**Example output**

```json
{
  "competition": "Champions League",
  "count": 2,
  "players": [
    {
      "appearances": 2,
      "assists": 0,
      "goals": 4,
      "minutes_played": 180,
      "nationality": "Norway",
      "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250103758.jpg",
      "player": "Erling Haaland",
      "player_id": "250103758",
      "position": "Forward",
      "rank": 1,
      "team": {
        "code": "MCI",
        "country": "England",
        "id": "52919",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52919.png",
        "name": "Man City"
      },
      "value": 4
    },
    {
      "appearances": 2,
      "assists": 0,
      "goals": 4,
      "minutes_played": 173,
      "nationality": "Germany",
      "photo_url": "https://img.uefa.com/imgml/TP/players/1/2027/324x324/250181849.jpg",
      "player": "Nicol\u00f2 Tresoldi",
      "player_id": "250181849",
      "position": "Forward",
      "rank": 2,
      "team": {
        "code": "BRU",
        "country": "Belgium",
        "id": "50043",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50043.png",
        "name": "Club Brugge"
      },
      "value": 4
    }
  ],
  "season": "2026/27",
  "statistic": "Goals"
}
```

### Get top teams

Rank a competition's teams by one statistic: most goals, fewest conceded (choose lowest first), possession, clean sheets and more.

**Inputs**

- Competition (`competition`, text, required): The UEFA competition. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Ranked by (`statistic`, text, required): The statistic to rank teams by. One of: `goals`, `goals_conceded` (Goals conceded), `clean_sheets` (Clean sheets), `possession` (Possession (%)), `shots`, `shots_on_target` (Shots on target), `passes_completed` (Passes completed), `passing_accuracy` (Passing accuracy (%)), `corners`, `tackles`, and 6 more.
- Season (`season`, text): The season. Leave blank for the current one.
- Stage (`stage`, text): The main competition or its qualifying rounds. Defaults to the main competition. One of: `TOURNAMENT` (Main competition), `QUALIFYING`.
- Order (`order`, text): Highest first (the default) or lowest first. One of: `DESC` (Highest first), `ASC` (Lowest first).
- How many (`limit`, number): How many to return, 1 to 100. Defaults to 10. From 1 to 100.

**Outputs**

- `competition` (text): The competition.
- `count` (number): How many teams were returned.
- `season` (text): The season.
- `statistic` (text): What the teams are ranked by.
- `teams` (list): The teams, in ranking order.

**Example output**

```json
{
  "competition": "Champions League",
  "count": 2,
  "season": "2026/27",
  "statistic": "Goals",
  "teams": [
    {
      "appearances": 2,
      "goals": 10,
      "goals_conceded": 3,
      "rank": 1,
      "team": {
        "code": "PSG",
        "country": "France",
        "id": "52747",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52747.png",
        "name": "Paris"
      },
      "value": 10
    },
    {
      "appearances": 2,
      "goals": 9,
      "goals_conceded": 2,
      "rank": 2,
      "team": {
        "code": "AVL",
        "country": "England",
        "id": "52683",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52683.png",
        "name": "Aston Villa"
      },
      "value": 9
    }
  ]
}
```

### List matches

List a competition's fixtures and results for a season, with scores, scorers and venues. Narrow it to one team, to upcoming, live or finished matches, or to a date range. Finished matches come newest first; everything else soonest first.

**Inputs**

- Competition (`competition`, text, required): The UEFA competition. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Season (`season`, text): The season. Leave blank for the current one.
- Team (`team`, text): Only this team's. Leave blank for every team.
- Status (`status`, text): Only upcoming, live or finished matches. Leave blank for all. One of: `UPCOMING`, `LIVE` (Live now), `FINISHED`.
- From (`from_date`, date): Only matches on or after this date.
- To (`to_date`, date): Only matches on or before this date.
- How many (`limit`, number): The most matches to return, 1 to 500. Defaults to 100. From 1 to 500.

**Outputs**

- `competition` (text): The competition.
- `count` (number): How many matches were returned.
- `matches` (list): The matches.
- `season` (text): The season, e.g. '2026/27'.

**Example output**

```json
{
  "competition": "Champions League",
  "count": 2,
  "matches": [
    {
      "attendance": 19725,
      "away_aggregate": null,
      "away_penalties": null,
      "away_score": 3,
      "away_team": {
        "code": "STU",
        "country": "Germany",
        "id": "50107",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50107.png",
        "name": "Stuttgart"
      },
      "city": "Bratislava",
      "competition": "Champions League",
      "competition_id": "1",
      "date": "2026-10-14",
      "finished_at": "2026-10-14T20:52:00.413Z",
      "goals": [
        {
          "added_time": null,
          "minute": 29,
          "player": "Deniz Undav",
          "player_id": "250194673",
          "team": "Stuttgart",
          "team_id": "50107",
          "time": "29'",
          "type": "goal"
        },
        {
          "added_time": null,
          "minute": 65,
          "player": "Sandro Cruz",
          "player_id": "250116653",
          "team": "Stuttgart",
          "team_id": "50107",
          "time": "65'",
          "type": "own goal"
        }
      ],
      "group": "League",
      "home_aggregate": null,
      "home_penalties": null,
      "home_score": 0,
      "home_team": {
        "code": "SBR",
        "country": "Slovakia",
        "id": "52797",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52797.png",
        "name": "S. Bratislava"
      },
      "id": "2049587",
      "kick_off": "2026-10-14T19:00:00Z",
      "leg": null,
      "matchday": "Matchday 2",
      "minute": null,
      "player_of_the_match": "Josha Vagnoman",
      "referee": "Irfan Peljto",
      "result": "Stuttgart win",
      "round": "League phase",
      "season": "2027",
      "stadium": "N\u00e1rodn\u00fd futbalov\u00fd \u0161tadi\u00f3n",
      "stage": "Main competition",
      "status": "finished",
      "summary": "S. Bratislava 0-3 Stuttgart",
      "url": "https://www.uefa.com/uefachampionsleague/match/2049587/",
      "winner": {
        "code": "STU",
        "country": "Germany",
        "id": "50107",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50107.png",
        "name": "Stuttgart"
      }
    },
    {
      "attendance": 21119,
      "away_aggregate": null,
      "away_penalties": null,
      "away_score": 1,
      "away_team": {
        "code": "AEK",
        "country": "Greece",
        "id": "50129",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50129.png",
        "name": "AEK Athens"
      },
      "city": "London",
      "competition": "Champions League",
      "competition_id": "1",
      "date": "2026-10-14",
      "finished_at": "2026-10-14T20:53:37.837Z",
      "goals": [
        {
          "added_time": null,
          "minute": 28,
          "player": "Lovro Majer",
          "player_id": "250098470",
          "team": "AEK Athens",
          "team_id": "50129",
          "time": "28'",
          "type": "goal"
        },
        {
          "added_time": null,
          "minute": 34,
          "player": "Pedrinho",
          "player_id": "250144964",
          "team": "Shakhtar",
          "team_id": "52707",
          "time": "34'",
          "type": "penalty"
        }
      ],
      "group": "League",
      "home_aggregate": null,
      "home_penalties": null,
      "home_score": 3,
      "home_team": {
        "code": "SHK",
        "country": "Ukraine",
        "id": "52707",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52707.png",
        "name": "Shakhtar"
      },
      "id": "2049586",
      "kick_off": "2026-10-14T19:00:00Z",
      "leg": null,
      "matchday": "Matchday 2",
      "minute": null,
      "player_of_the_match": "Alisson Santana",
      "referee": "Chris Kavanagh",
      "result": "Shakhtar win",
      "round": "League phase",
      "season": "2027",
      "stadium": "Stamford Bridge",
      "stage": "Main competition",
      "status": "finished",
      "summary": "Shakhtar 3-1 AEK Athens",
      "url": "https://www.uefa.com/uefachampionsleague/match/2049586/",
      "winner": {
        "code": "SHK",
        "country": "Ukraine",
        "id": "52707",
        "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52707.png",
        "name": "Shakhtar"
      }
    }
  ],
  "season": "2026/27"
}
```

### List news

List the latest stories on uefa.com, newest first: news, match previews and reports, and interviews. Narrow it to one competition or one team.

**Inputs**

- Competition (`competition`, text): Only stories about this competition. Leave blank for all. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Team (`team`, text): Only stories about this team. Leave blank for all.
- How many (`limit`, number): How many stories to return, 1 to 50. Defaults to 10. From 1 to 50.

**Outputs**

- `articles` (list): The stories, newest first.
- `count` (number): How many stories were returned.

**Example output**

```json
{
  "articles": [
    {
      "competition": "Champions League",
      "id": "0253-0d82037aaedd-f371c464f919-1000",
      "image_url": "https://editorial.uefa.com/resources/02a3-201e97722b64-1d9c625aa5b1-1000/format/wide1/image.jpg",
      "kind": "News Article",
      "published_at": "2026-10-20T02:00:00.000Z",
      "summary": "Find out where to watch the 2026/27 UEFA Champions League wherever you are.",
      "title": "Where to watch the Champions League: TV broadcast partners, live streams",
      "url": "https://www.uefa.com/uefachampionsleague/news/0253-0d82037aaedd-f371c464f919-1000--where-to-watch-the-champions-league-tv-broadcast-partners-live-streams/"
    },
    {
      "competition": "Champions League",
      "id": "02aa-21dd91a8e50c-17bdd56af75f-1000",
      "image_url": "https://editorial.uefa.com/resources/02aa-21dd91a8e50b-72f3dab3f20e-1000/format/wide1/image.jpg",
      "kind": "News Article",
      "published_at": "2026-10-19T15:59:11.000Z",
      "summary": "The heavyweight contest between Paris Saint-Germain and Barcelona is among nine fixtures when Matchday 3 kicks off on Tuesday.",
      "title": "Champions League Fantasy Football: Scout notes 20 October",
      "url": "https://www.uefa.com/uefachampionsleague/news/02aa-21dd91a8e50c-17bdd56af75f-1000--champions-league-fantasy-football-scout-notes-20-october/"
    }
  ],
  "count": 2
}
```

### List teams

List the teams taking part in a competition's season, from the first qualifying round on, or only those in the main competition.

**Inputs**

- Competition (`competition`, text, required): The UEFA competition. One of: `1` (Champions League), `14` (Europa League), `2019` (Conference League), `9` (Super Cup), `3` (EURO), `2014` (Nations League), `17` (World Cup), `28` (Women's Champions League), `2027` (Women's Europa Cup), `18` (Women's EURO), and 8 more.
- Season (`season`, text): The season. Leave blank for the current one.
- Stage (`stage`, text): The main competition or its qualifying rounds. Defaults to the main competition. One of: `TOURNAMENT` (Main competition), `QUALIFYING`.

**Outputs**

- `competition` (text): The competition.
- `count` (number): How many teams were returned.
- `season` (text): The season.
- `teams` (list): The teams, by name.

**Example output**

```json
{
  "competition": "Champions League",
  "count": 2,
  "season": "2026/27",
  "teams": [
    {
      "code": "AEK",
      "country": "Greece",
      "country_code": "GRE",
      "full_name": "AEK Athens FC",
      "id": "50129",
      "is_national_team": false,
      "large_logo_url": "https://img.uefa.com/imgml/TP/teams/logos/700x700/50129.png",
      "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/50129.png",
      "name": "AEK Athens",
      "short_name": "AEK"
    },
    {
      "code": "ARS",
      "country": "England",
      "country_code": "ENG",
      "full_name": "Arsenal FC",
      "id": "52280",
      "is_national_team": false,
      "large_logo_url": "https://img.uefa.com/imgml/TP/teams/logos/700x700/52280.png",
      "logo_url": "https://img.uefa.com/imgml/TP/teams/logos/240x240/52280.png",
      "name": "Arsenal",
      "short_name": "Arsenal"
    }
  ]
}
```
