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
| Action | What it does |
|---|---|
| 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. |
| Get lineups | Get both teams' starting eleven, substitutes and coach for a match. |
| 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. |
| 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. |
| Get match statistics | Get each team's numbers in a match: possession, shots, passes, corners, tackles, saves, fouls, cards, distance covered and top speed. |
| Get player | Get a player's profile: name, position, shirt number, nationality, date of birth, age and height. |
| 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. |
| 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. |
| Get squad | Get the players a team registered for a competition's season: goalkeepers first, then defenders, midfielders and forwards, each by shirt number. |
| 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. |
| 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'. |
| 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. |
| Get top teams | Rank a competition's teams by one statistic: most goals, fewest conceded (choose lowest first), possession, clean sheets and more. |
| List matches | List a competition's fixtures and results for a season, with scores, scorers and venues. |
| List news | List the latest stories on uefa.com, newest first: news, match previews and reports, and interviews. |
| 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. |
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
competitiontextRequired - 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
teamtextRequired - The team. Pick one, or give its UEFA id from an earlier step.
- Opponent
opponenttextRequired - 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 ID
match_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 ID
match_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 ID
match_idtextRequired - The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.
- Events
includetext - 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 ID
match_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 ID
playertextRequired - 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 ID
match_idtextRequired - The match's UEFA id, from 'List matches', the 'Match finishes' trigger or the match's address on uefa.com.
- Player ID
playertext - 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
- Competition
competitiontextRequired - 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
teamtext - The player's team, to choose the player from its squad.
- Player
playertextRequired - The player. Pick one, or give their UEFA id from an earlier step.
- Season
seasontext - The season. Leave blank for the current one.
- Stage
stagetext - 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
- Competition
competitiontextRequired - 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
teamtextRequired - The team. Pick one, or give its UEFA id from an earlier step.
- Season
seasontext - 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
- Competition
competitiontextRequired - 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
seasontext - 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
- Team
teamtextRequired - The team. Pick one, or give its UEFA id from an earlier step.
- Recent matches
recent_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
- Competition
competitiontextRequired - 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
statistictextRequired - 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
seasontext - The season. Leave blank for the current one.
- Stage
stagetext - The main competition or its qualifying rounds. Defaults to the main competition.One of:
TOURNAMENT(Main competition),QUALIFYING. - Team
teamtext - Only this team's. Leave blank for every team.
- Order
ordertext - Highest first (the default) or lowest first.One of:
DESC(Highest first),ASC(Lowest first). - How many
limitnumber - 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
- Competition
competitiontextRequired - 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
statistictextRequired - 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
seasontext - The season. Leave blank for the current one.
- Stage
stagetext - The main competition or its qualifying rounds. Defaults to the main competition.One of:
TOURNAMENT(Main competition),QUALIFYING. - Order
ordertext - Highest first (the default) or lowest first.One of:
DESC(Highest first),ASC(Lowest first). - How many
limitnumber - 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
- Competition
competitiontextRequired - 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
seasontext - The season. Leave blank for the current one.
- Team
teamtext - Only this team's. Leave blank for every team.
- Status
statustext - Only upcoming, live or finished matches. Leave blank for all.One of:
UPCOMING,LIVE(Live now),FINISHED. - From
from_datedate - Only matches on or after this date.
- To
to_datedate - Only matches on or before this date.
- How many
limitnumber - 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
- Competition
competitiontext - 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
teamtext - Only stories about this team. Leave blank for all.
- How many
limitnumber - 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
- Competition
competitiontextRequired - 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
seasontext - The season. Leave blank for the current one.
- Stage
stagetext - 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"
}
]
}