FIFA
App · 14 actions
Follow football with FIFA's own data: fixtures, results and live scores, goals, cards and line-ups, league and group tables, teams, squads and players, and the FIFA World Ranking, for the World Cup and about 600 competitions worldwide. Start a workflow when a match finishes or a goal is scored. No account needed.
Actions
| Action | What it does |
|---|---|
| Get match | Get one match in full: the live or final score and minute, goals with scorers and assists, cards, substitutions, both line-ups and formations, possession and the referees. |
| Get match events | Get what happened in a match, minute by minute: goals, cards, substitutions, VAR reviews and the whistles, each with FIFA's own one-line description and the score after it. |
| Get player | Get a player: nationality, date and place of birth, height, weight, preferred foot, and their caps, debut and goals for their national team. |
| Get squad | Get a team's squad for a season: every player's shirt number, position, nationality, date of birth and their matches, goals and cards that season, plus the coaches. |
| Get standings | Get a season's league table, or every group table of a tournament: position, played, won, drawn, lost, goals and points, and who has qualified or been eliminated. |
| Get team | Get a club or national team: its name, country, confederation, city, the year it was founded and its badge. |
| Get world ranking | Get the FIFA/Coca-Cola World Ranking of national teams, men's or women's: each team's place, points and places moved. |
| List competitions | List the competitions FIFA has data for, from the World Cup to national leagues and cups, optionally only those whose name contains some text, in one confederation, or for men or women. |
| List live matches | List the matches being played right now, with the score and minute, in every competition FIFA covers or in one. |
| List matches | List fixtures and results between two dates, or for a whole season: kick-off, teams, score and status, for one competition, season or team or for every match FIFA covers. |
| List seasons | List a competition's seasons, newest first, with the dates each runs. |
| List teams | List the teams taking part in a season of a competition. |
| Search players | Find players by name, the most-capped internationals first. |
| Search teams | Find clubs and national teams by name, senior football teams first. |
Get match
Get one match in full: the live or final score and minute, goals with scorers and assists, cards, substitutions, both line-ups and formations, possession and the referees.
Inputs
- Match ID
match_idtextRequired - The match's id, from 'List matches', 'List live matches' or a FIFA trigger.
Outputs
matchobject- The match
Example output
{
"match": {
"attendance": 61559,
"away_formation": "4-2-3-1",
"away_lineup": [],
"away_penalty_score": null,
"away_possession": 34.6,
"away_score": 1,
"away_team": {
"abbreviation": "COV",
"country": "ENG",
"id": "dacoc20k0n3fxu4zek8wufmko",
"name": "Coventry City"
},
"cards": [
{
"card": "yellow",
"minute": "22'",
"player": "Dominic Solanke",
"player_id": "403060",
"team": "Tottenham Hotspur"
}
],
"city": "London",
"competition": "Premier League",
"competition_id": "2000000000",
"date": "2026-10-19T19:00:00Z",
"decided_by": "normal time",
"goals": [
{
"assist_player": "Andy Robertson",
"minute": "58'",
"player": "Omar Marmoush",
"player_id": "430476",
"team": "Tottenham Hotspur",
"team_id": "23437",
"type": "goal"
}
],
"group": null,
"home_formation": "3-1-4-2",
"home_lineup": [
{
"captain": false,
"id": "491239",
"name": "Antonin Kinsky",
"position": "goalkeeper",
"shirt_number": 31,
"starter": true
}
],
"home_penalty_score": null,
"home_possession": 65.4,
"home_score": 3,
"home_team": {
"abbreviation": "TOT",
"country": "ENG",
"id": "23437",
"name": "Tottenham Hotspur"
},
"id": "4jzrwlbjz3g6rdfsb2bzezmdw",
"match_day": "7",
"minute": null,
"officials": [
{
"country": "ENG",
"name": "Andy Madley",
"role": "Referee"
}
],
"period": "full time",
"season": "Premier League 2026/2027",
"season_id": "6pdwluctev9iebv00r4qqukno",
"stadium": "Tottenham Hotspur Stadium",
"stage": "Regular Season",
"stage_id": "6qer7wlpw2n77kwgbp7t06bys",
"status": "finished",
"substitutions": [
{
"minute": "69'",
"player_off": "Andy Robertson",
"player_on": "Ben Davies",
"team": "Tottenham Hotspur"
}
],
"summary": "Tottenham Hotspur 3-1 Coventry City, full time",
"winner": "Tottenham Hotspur",
"winner_team_id": "23437"
}
}Get match events
Get what happened in a match, minute by minute: goals, cards, substitutions, VAR reviews and the whistles, each with FIFA's own one-line description and the score after it. Or every event, including shots, fouls and corners.
Inputs
- Match ID
match_idtextRequired - The match's id, from 'List matches', 'List live matches' or a FIFA trigger.
- Events
includetext - Key events only (goals, cards, substitutions, VAR and the whistles), or everything, including every shot, foul and corner. Defaults to key events.One of:
key(Key events),all(Everything).
Outputs
countnumber- How many were returned
eventslist- The events, in order
matchtext- The match in one line, with its score
match_idtext- The match's id
Example output
{
"count": 1,
"events": [
{
"away_score": 1,
"description": "Omar Marmoush (Tottenham Hotspur) scores!",
"home_score": 2,
"id": "625",
"is_goal": true,
"minute": "58'",
"period": "second half",
"player": "Omar Marmoush",
"player_id": "430476",
"team": "Tottenham Hotspur",
"team_id": "23437",
"time": "2026-10-19T20:17:38.639Z",
"type": "Goal!"
}
],
"match": "Tottenham Hotspur 3-1 Coventry City, full time",
"match_id": "4jzrwlbjz3g6rdfsb2bzezmdw"
}Get player
Get a player: nationality, date and place of birth, height, weight, preferred foot, and their caps, debut and goals for their national team.
Inputs
- Player ID
player_idtextRequired - The player's id, from 'Search players', 'Get squad' or a match.
Outputs
playerobject- A player
Example output
{
"player": {
"birth_date": "1995-09-15",
"birth_place": "BARCELONA",
"country": "ESP",
"height_cm": 186.0,
"id": "447853",
"international_caps": 13,
"international_debut": "2022-03-26",
"international_goals": 0,
"name": "David RAYA",
"preferred_foot": "right",
"weight_kg": 82.0
}
}Get squad
Get a team's squad for a season: every player's shirt number, position, nationality, date of birth and their matches, goals and cards that season, plus the coaches.
Inputs
- Competition
competition_idtextRequired - The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
- Season
season_idtextRequired - The season, newest first. Pick the competition first.
- Team
teamtextRequired - The team. Pick the competition and season first.
Outputs
coacheslist- The coaches
countnumber- How many were returned
playerslist- The players, by shirt number
teamtext- The team's name
team_idtext- The team's id
Example output
{
"coaches": [
{
"country": "ESP",
"id": "175416",
"name": "Mikel Arteta Amatriain"
}
],
"count": 1,
"players": [
{
"birth_date": "1995-09-15",
"country": "ESP",
"goals": 0,
"height_cm": 183.0,
"id": "447853",
"matches_played": 7,
"name": "David RAYA",
"position": "goalkeeper",
"preferred_foot": "right",
"red_cards": 0,
"shirt_number": 1,
"short_name": "David Raya",
"weight_kg": 80.0,
"yellow_cards": 0
}
],
"team": "Arsenal FC",
"team_id": "32847"
}Get standings
Get a season's league table, or every group table of a tournament: position, played, won, drawn, lost, goals and points, and who has qualified or been eliminated.
Inputs
- Competition
competition_idtextRequired - The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
- Season
season_idtextRequired - The season, newest first. Pick the competition first.
Outputs
competition_idtext- The competition's id
countnumber- How many were returned
groupslist- The groups, e.g. 'Group A'. Empty for a league.
season_idtext- The season's id
standingslist- Every team's line, by stage, group and position
Example output
{
"competition_id": "17",
"count": 1,
"groups": [
"Group A"
],
"season_id": "285023",
"standings": [
{
"abbreviation": "MEX",
"drawn": 0,
"goal_difference": 6,
"goals_against": 0,
"goals_for": 6,
"group": "Group A",
"lost": 0,
"played": 3,
"points": 9,
"position": 1,
"qualification": "qualified",
"stage": "First Stage",
"team": "Mexico",
"team_id": "43911",
"won": 3
}
]
}Get team
Get a club or national team: its name, country, confederation, city, the year it was founded and its badge.
Inputs
- Team ID
teamtextRequired - The team's id, from 'Search teams', 'List teams' or a match.
Outputs
teamobject- A team
Example output
{
"team": {
"abbreviation": "BRA",
"age_group": "senior",
"badge_url": "https://api.fifa.com/api/v3/picture/flags-sq-4/BRA",
"city": "RIO DE JANEIRO",
"confederation": "CONMEBOL",
"country": "BRA",
"description": "Brazil (national team, men)",
"founded": 1914,
"gender": "men",
"id": "43924",
"name": "Brazil",
"short_name": "Brazil",
"sport": "football",
"team_type": "national team"
}
}Get world ranking
Get the FIFA/Coca-Cola World Ranking of national teams, men's or women's: each team's place, points and places moved. The latest published ranking, or the one in force on a date.
Inputs
- Men or women
gendertext - The men's or the women's ranking. Defaults to men's.One of:
men,women. - Confederation
confederationtext - Only teams in this confederation, keeping their world places.One of:
AFC(AFC (Asia)),CAF(CAF (Africa)),CONCACAF(CONCACAF (North and Central America, Caribbean)),CONMEBOL(CONMEBOL (South America)),OFC(OFC (Oceania)),UEFA(UEFA (Europe)). - Ranking on
as_ofdate - The ranking that was current on this day. Leave empty for the latest.
- Maximum teams
limitnumber - How many teams to return at most, from the top. Defaults to all.From 1 to 250.
Outputs
countnumber- How many were returned
gendertext- 'men' or 'women'
published_ontext- The day FIFA published it, YYYY-MM-DD
rankingslist- The teams, by place
Example output
{
"count": 1,
"gender": "men",
"published_on": "2026-10-07",
"rankings": [
{
"confederation": "UEFA",
"country": "ESP",
"places_moved": 0,
"points": 2011.57,
"previous_points": 1995.88,
"previous_rank": 1,
"rank": 1,
"team": "Spain",
"team_id": "43969"
}
]
}List competitions
List the competitions FIFA has data for, from the World Cup to national leagues and cups, optionally only those whose name contains some text, in one confederation, or for men or women.
Inputs
- Name contains
searchtext - Only competitions whose name or country contains this, e.g. 'World Cup' or 'England'.
- Confederation
confederationtext - Only competitions in this confederation.One of:
AFC(AFC (Asia)),CAF(CAF (Africa)),CONCACAF(CONCACAF (North and Central America, Caribbean)),CONMEBOL(CONMEBOL (South America)),OFC(OFC (Oceania)),UEFA(UEFA (Europe)). - Men or women
gendertext - Only men's or only women's competitions.One of:
men,women.
Outputs
competitionslist- The competitions
countnumber- How many were returned
Example output
{
"competitions": [
{
"age_group": "senior",
"confederations": [],
"country": null,
"gender": "men",
"id": "17",
"name": "FIFA World Cup\u2122",
"organiser": "FIFA",
"sport": "football",
"team_type": "national team"
}
],
"count": 1
}List live matches
List the matches being played right now, with the score and minute, in every competition FIFA covers or in one.
Inputs
- Competition
competition_idtext - Only matches in this competition. Type to search the list.
Outputs
countnumber- How many were returned
matcheslist- The matches, in kick-off order
Example output
{
"count": 1,
"matches": [
{
"attendance": 61559,
"away_penalty_score": null,
"away_score": 0,
"away_team": {
"abbreviation": "COV",
"country": "ENG",
"id": "dacoc20k0n3fxu4zek8wufmko",
"name": "Coventry City"
},
"city": "London",
"competition": "Premier League",
"competition_id": "2000000000",
"date": "2026-10-19T19:00:00Z",
"decided_by": null,
"group": null,
"home_penalty_score": null,
"home_score": 1,
"home_team": {
"abbreviation": "TOT",
"country": "ENG",
"id": "23437",
"name": "Tottenham Hotspur"
},
"id": "4jzrwlbjz3g6rdfsb2bzezmdw",
"match_day": "7",
"minute": "38'",
"season": "Premier League 2026/2027",
"season_id": "6pdwluctev9iebv00r4qqukno",
"stadium": "Tottenham Hotspur Stadium",
"stage": "Regular Season",
"stage_id": "6qer7wlpw2n77kwgbp7t06bys",
"status": "live",
"summary": "Tottenham Hotspur 1-0 Coventry City, live (38')",
"winner": null,
"winner_team_id": null
}
]
}List matches
List fixtures and results between two dates, or for a whole season: kick-off, teams, score and status, for one competition, season or team or for every match FIFA covers. Up to 500 matches.
Inputs
- Competition
competition_idtext - Only matches in this competition. Type to search the list.
- Season
season_idtext - Only matches in this season: the whole season unless dates are given too. Pick the competition first.
- Team
teamtext - Only this team's matches. The list shows the competition's current teams; any team id from 'Search teams' works too.
- From date
from_datedate - Matches on or after this day (UTC). Without dates or a season, the next 7 days.
- To date
to_datedate - Matches on or before this day (UTC), at most a year after the first.
- Status
statustext - Only matches that have not started, are live, or have finished.One of:
scheduled(Not started yet),live(Being played now),finished,postponed,cancelled. - Maximum matches
limitnumber - How many matches to return at most, 1 to 500. Defaults to 500.From 1 to 500.
Outputs
countnumber- How many were returned
from_datetext- The first day covered, when dates were used
matcheslist- The matches, in kick-off order
more_availabletrue/false- True when there were more matches than returned: narrow the dates or pick a competition
to_datetext- The last day covered, when dates were used
Example output
{
"count": 1,
"from_date": "2026-10-19",
"matches": [
{
"attendance": 61559,
"away_penalty_score": null,
"away_score": 1,
"away_team": {
"abbreviation": "COV",
"country": "ENG",
"id": "dacoc20k0n3fxu4zek8wufmko",
"name": "Coventry City"
},
"city": "London",
"competition": "Premier League",
"competition_id": "2000000000",
"date": "2026-10-19T19:00:00Z",
"decided_by": "normal time",
"group": null,
"home_penalty_score": null,
"home_score": 3,
"home_team": {
"abbreviation": "TOT",
"country": "ENG",
"id": "23437",
"name": "Tottenham Hotspur"
},
"id": "4jzrwlbjz3g6rdfsb2bzezmdw",
"match_day": "7",
"minute": null,
"season": "Premier League 2026/2027",
"season_id": "6pdwluctev9iebv00r4qqukno",
"stadium": "Tottenham Hotspur Stadium",
"stage": "Regular Season",
"stage_id": "6qer7wlpw2n77kwgbp7t06bys",
"status": "finished",
"summary": "Tottenham Hotspur 3-1 Coventry City, full time",
"winner": "Tottenham Hotspur",
"winner_team_id": "23437"
}
],
"more_available": false,
"to_date": "2026-10-19"
}List seasons
List a competition's seasons, newest first, with the dates each runs.
Inputs
- Competition
competition_idtextRequired - The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
Outputs
countnumber- How many were returned
seasonslist- The seasons, newest first
Example output
{
"count": 1,
"seasons": [
{
"abbreviation": "FWC 2026",
"competition_id": "17",
"end_date": "2026-07-19",
"id": "285023",
"name": "FIFA World Cup 2026\u2122",
"start_date": "2026-06-11"
}
]
}List teams
List the teams taking part in a season of a competition.
Inputs
- Competition
competition_idtextRequired - The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
- Season
season_idtextRequired - The season, newest first. Pick the competition first.
Outputs
countnumber- How many were returned
teamslist- The teams, by name
Example output
{
"count": 1,
"teams": [
{
"abbreviation": "BRA",
"age_group": "senior",
"badge_url": "https://api.fifa.com/api/v3/picture/flags-sq-4/BRA",
"city": "RIO DE JANEIRO",
"confederation": "CONMEBOL",
"country": "BRA",
"description": "Brazil (national team, men)",
"founded": 1914,
"gender": "men",
"id": "43924",
"name": "Brazil",
"short_name": "Brazil",
"sport": "football",
"team_type": "national team"
}
]
}Search players
Find players by name, the most-capped internationals first.
Inputs
- Name
nametextRequired - All or part of the player's name, e.g. 'Saka'.
- Maximum results
limitnumber - How many to return at most, 1 to 50. Defaults to 20.From 1 to 50.
Outputs
countnumber- How many were returned
playerslist- The players found
Example output
{
"count": 1,
"players": [
{
"birth_date": "1995-09-15",
"birth_place": "BARCELONA",
"country": "ESP",
"height_cm": 186.0,
"id": "447853",
"international_caps": 13,
"international_debut": "2022-03-26",
"international_goals": 0,
"name": "David RAYA",
"preferred_foot": "right",
"weight_kg": 82.0
}
]
}Search teams
Find clubs and national teams by name, senior football teams first. Each result says which team it is, since many share a name (Brazil's men, women, under-17s, futsal...).
Inputs
- Name
nametextRequired - All or part of the team's name, e.g. 'Arsenal'.
- Clubs or national teams
team_typetext - Only clubs, or only national teams.One of:
club(Clubs),national(National teams). - Men or women
gendertext - Only men's or only women's teams.One of:
men,women. - Maximum results
limitnumber - How many to return at most, 1 to 50. Defaults to 20.From 1 to 50.
Outputs
countnumber- How many were returned
teamslist- The teams found
Example output
{
"count": 1,
"teams": [
{
"abbreviation": "BRA",
"age_group": "senior",
"badge_url": "https://api.fifa.com/api/v3/picture/flags-sq-4/BRA",
"city": "RIO DE JANEIRO",
"confederation": "CONMEBOL",
"country": "BRA",
"description": "Brazil (national team, men)",
"founded": 1914,
"gender": "men",
"id": "43924",
"name": "Brazil",
"short_name": "Brazil",
"sport": "football",
"team_type": "national team"
}
]
}