UEFA

App · 16 actions

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.

Actions

ActionWhat it does
Get head-to-headGet every meeting of two teams in a competition, across all seasons: wins, draws and goals for each side, and the matches themselves, newest first.
Get lineupsGet both teams' starting eleven, substitutes and coach for a match.
Get matchGet one match: the teams, score (with penalties and aggregate), status, scorers, player of the match, stadium, crowd, referee and its page on uefa.com.
Get match eventsGet what happened in a match, minute by minute: goals, cards and substitutions, or every key moment, or everything down to each shot and foul.
Get match statisticsGet each team's numbers in a match: possession, shots, passes, corners, tackles, saves, fouls, cards, distance covered and top speed.
Get playerGet a player's profile: name, position, shirt number, nationality, date of birth, age and height.
Get player match statisticsGet 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.
Get player season statisticsGet 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.
Get squadGet the players a team registered for a competition's season: goalkeepers first, then defenders, midfielders and forwards, each by shirt number.
Get standingsGet 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.
Get teamGet 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'.
Get top playersRank a competition's players by one statistic: top scorers, most assists, most saves, fastest players and more, across the competition or within one team.
Get top teamsRank a competition's teams by one statistic: most goals, fewest conceded (choose lowest first), possession, clean sheets and more.
List matchesList a competition's fixtures and results for a season, with scores, scorers and venues.
List newsList the latest stories on uefa.com, newest first: news, match previews and reports, and interviews.
List teamsList the teams taking part in a competition's season, from the first qualifying round on, or only those in the main competition.

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

CompetitioncompetitiontextRequired
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.
TeamteamtextRequired
The team. Pick one, or give its UEFA id from an earlier step.
OpponentopponenttextRequired
The other team. Pick one, or give its UEFA id.

Outputs

competitiontext
The competition.
countnumber
Meetings listed, upcoming ones included.
drawsnumber
Meetings drawn.
matcheslist
The meetings, newest first.
opponenttext
The second team.
opponent_goalsnumber
Goals the opponent scored.
opponent_winsnumber
Meetings the opponent won.
playednumber
Finished meetings.
teamtext
The first team.
team_goalsnumber
Goals the first team scored.
team_winsnumber
Meetings the first team won (shoot-outs count).
Example output
{
  "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 IDmatch_idtextRequired
The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.

Outputs

availabletrue/false
False until UEFA publishes the lineups.
awayobject
The away team's lineup.
homeobject
The home team's lineup.
match_idtext
The match.
Example output
{
  "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 IDmatch_idtextRequired
The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.

Outputs

attendancenumber
The crowd.
away_aggregatenumber
Away team's aggregate score after a second leg.
away_penaltiesnumber
Away penalties scored in a shoot-out.
away_scorenumber
Away goals (after extra time); empty before kick-off.
away_teamobject
The away team.
citytext
The stadium's city.
competitiontext
The competition, e.g. 'Champions League'.
competition_idtext
The competition's UEFA id.
datetext
The match date, YYYY-MM-DD.
finished_attext
When the final whistle went, ISO 8601 in UTC.
goalslist
The goals, in order.
grouptext
The group or league, e.g. 'Group A1' or 'League'.
home_aggregatenumber
Home team's aggregate score after a second leg.
home_penaltiesnumber
Home penalties scored in a shoot-out.
home_scorenumber
Home goals (after extra time); empty before kick-off.
home_teamobject
The home team.
idtext
The match's UEFA id: use it with the other match actions.
kick_offtext
Kick-off, ISO 8601 in UTC.
legtext
'1st leg' or '2nd leg' in a two-legged tie.
matchdaytext
The matchday, e.g. 'Matchday 2'.
minutenumber
The minute being played, while the match is live.
player_of_the_matchtext
The player of the match, when named.
refereetext
The referee.
resulttext
'Stuttgart win', 'Draw' or 'Paris win on penalties'.
roundtext
The round, e.g. 'League phase' or 'Final'.
seasontext
The year the season ends in, e.g. '2027' for 2026/27.
stadiumtext
The stadium.
stagetext
Main competition, Qualifying or Preliminary round.
statustext
upcoming, live, finished, postponed or abandoned.
summarytext
One line: 'Paris 1-1 Arsenal (4-3 on penalties)', or 'Paris v Barcelona' before kick-off.
urltext
The match page on uefa.com.
winnerobject
The team that won the match; empty for a draw.
Example output
{
  "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 IDmatch_idtextRequired
The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.
Eventsincludetext
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

countnumber
How many events were returned.
eventslist
The events, in the order they happened.
match_idtext
The match.
Example output
{
  "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 IDmatch_idtextRequired
The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.

Outputs

availabletrue/false
False until UEFA has statistics for the match.
awayobject
The away team's numbers.
homeobject
The home team's numbers.
match_idtext
The match.
summarytext
The score line.
Example output
{
  "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 IDplayertextRequired
The player's UEFA id, from 'Get squad', 'Get lineups' or 'Get top players'.

Outputs

agenumber
Age in years.
birth_datetext
Date of birth, YYYY-MM-DD.
club_idtext
The UEFA id of the player's club.
country_codetext
UEFA's three-letter country code, e.g. 'NOR'.
first_nametext
First name.
height_cmnumber
Height in centimetres, when UEFA has it.
idtext
The player's UEFA id.
last_nametext
Last name.
nametext
The player's name, e.g. 'Erling Haaland'.
nationalitytext
The country the player represents, e.g. 'Norway'.
positiontext
Goalkeeper, Defender, Midfielder or Forward.
shirt_numbernumber
Shirt number.
Example output
{
  "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 IDmatch_idtextRequired
The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.
Player IDplayertext
Only this player's numbers. Leave blank for everyone who played.

Outputs

countnumber
How many players were returned.
match_idtext
The match.
playerslist
The players who played, most minutes first.
Example output
{
  "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

CompetitioncompetitiontextRequired
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.
Teamteamtext
The player's team, to choose the player from its squad.
PlayerplayertextRequired
The player. Pick one, or give their UEFA id from an earlier step.
Seasonseasontext
The season. Leave blank for the current one.
Stagestagetext
The main competition or its qualifying rounds. Defaults to the main competition.One of: TOURNAMENT (Main competition), QUALIFYING.

Outputs

appearancesnumber
Appearances.
assistsnumber
Assists.
balls_recoverednumber
Balls recovered.
clean_sheetsnumber
Clean sheets.
competitiontext
The competition.
distance_covered_kmnumber
Distance covered (km).
dribblesnumber
Dribbles.
fouls_committednumber
Fouls committed.
fouls_sufferednumber
Fouls suffered.
goalsnumber
Goals.
goals_concedednumber
Goals conceded.
key_passesnumber
Key passes.
minutes_playednumber
Minutes played.
offsidesnumber
Offsides.
passesnumber
Passes.
passes_completednumber
Passes completed.
passing_accuracynumber
Passing accuracy (%).
playedtrue/false
False when the player has not played in it.
playertext
The player's name.
player_idtext
The player.
red_cardsnumber
Red cards.
savesnumber
Saves.
seasontext
The season.
shotsnumber
Shots.
shots_on_targetnumber
Shots on target.
stagetext
Main competition or Qualifying.
tacklesnumber
Tackles.
tackles_wonnumber
Tackles won.
team_idtext
The team they played for.
top_speed_kmhnumber
Top speed (km/h).
yellow_cardsnumber
Yellow cards.
Example output
{
  "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

CompetitioncompetitiontextRequired
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.
TeamteamtextRequired
The team. Pick one, or give its UEFA id from an earlier step.
Seasonseasontext
The season. Leave blank for the current one.

Outputs

competitiontext
The competition.
countnumber
How many players are registered.
playerslist
The squad.
seasontext
The season.
team_idtext
The team.
Example output
{
  "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

CompetitioncompetitiontextRequired
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.
Seasonseasontext
The season. Leave blank for the current one.

Outputs

competitiontext
The competition.
countnumber
How many tables were returned.
groupslist
One table per league or group. Empty for a competition played only as knockout rounds.
seasontext
The season.
Example output
{
  "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

TeamteamtextRequired
The team. Pick one, or give its UEFA id from an earlier step.
Recent matchesrecent_matchesnumber
How many recent results to include, 1 to 10. Defaults to 5.From 1 to 10.

Outputs

codetext
The three-letter code, e.g. 'MCI'.
countrytext
The team's country, e.g. 'England'.
country_codetext
UEFA's three-letter country code, e.g. 'ENG'.
formtext
Recent results, newest first: W, D or L for each.
full_nametext
The official name, e.g. 'Manchester City FC'.
idtext
The team's UEFA id.
is_national_teamtrue/false
True for a national team, false for a club.
large_logo_urltext
The team's badge or flag, 700px.
logo_urltext
The team's badge (or flag for a national team), 240px.
nametext
The team's name as UEFA shows it, e.g. 'Man City'.
recent_matcheslist
The latest results, newest first.
short_nametext
The short name, e.g. 'Man City'.
Example output
{
  "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

CompetitioncompetitiontextRequired
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 bystatistictextRequired
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.
Seasonseasontext
The season. Leave blank for the current one.
Stagestagetext
The main competition or its qualifying rounds. Defaults to the main competition.One of: TOURNAMENT (Main competition), QUALIFYING.
Teamteamtext
Only this team's. Leave blank for every team.
Orderordertext
Highest first (the default) or lowest first.One of: DESC (Highest first), ASC (Lowest first).
How manylimitnumber
How many to return, 1 to 100. Defaults to 10.From 1 to 100.

Outputs

competitiontext
The competition.
countnumber
How many players were returned.
playerslist
The players, best first.
seasontext
The season.
statistictext
What the players are ranked by.
Example output
{
  "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

CompetitioncompetitiontextRequired
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 bystatistictextRequired
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.
Seasonseasontext
The season. Leave blank for the current one.
Stagestagetext
The main competition or its qualifying rounds. Defaults to the main competition.One of: TOURNAMENT (Main competition), QUALIFYING.
Orderordertext
Highest first (the default) or lowest first.One of: DESC (Highest first), ASC (Lowest first).
How manylimitnumber
How many to return, 1 to 100. Defaults to 10.From 1 to 100.

Outputs

competitiontext
The competition.
countnumber
How many teams were returned.
seasontext
The season.
statistictext
What the teams are ranked by.
teamslist
The teams, in ranking order.
Example output
{
  "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

CompetitioncompetitiontextRequired
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.
Seasonseasontext
The season. Leave blank for the current one.
Teamteamtext
Only this team's. Leave blank for every team.
Statusstatustext
Only upcoming, live or finished matches. Leave blank for all.One of: UPCOMING, LIVE (Live now), FINISHED.
Fromfrom_datedate
Only matches on or after this date.
Toto_datedate
Only matches on or before this date.
How manylimitnumber
The most matches to return, 1 to 500. Defaults to 100.From 1 to 500.

Outputs

competitiontext
The competition.
countnumber
How many matches were returned.
matcheslist
The matches.
seasontext
The season, e.g. '2026/27'.
Example output
{
  "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

Competitioncompetitiontext
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.
Teamteamtext
Only stories about this team. Leave blank for all.
How manylimitnumber
How many stories to return, 1 to 50. Defaults to 10.From 1 to 50.

Outputs

articleslist
The stories, newest first.
countnumber
How many stories were returned.
Example output
{
  "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

CompetitioncompetitiontextRequired
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.
Seasonseasontext
The season. Leave blank for the current one.
Stagestagetext
The main competition or its qualifying rounds. Defaults to the main competition.One of: TOURNAMENT (Main competition), QUALIFYING.

Outputs

competitiontext
The competition.
countnumber
How many teams were returned.
seasontext
The season.
teamslist
The teams, by name.
Example output
{
  "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"
    }
  ]
}

On this page