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

ActionWhat it does
Get matchGet 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 eventsGet 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 playerGet a player: nationality, date and place of birth, height, weight, preferred foot, and their caps, debut and goals for their national team.
Get squadGet 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 standingsGet 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 teamGet a club or national team: its name, country, confederation, city, the year it was founded and its badge.
Get world rankingGet the FIFA/Coca-Cola World Ranking of national teams, men's or women's: each team's place, points and places moved.
List competitionsList 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 matchesList the matches being played right now, with the score and minute, in every competition FIFA covers or in one.
List matchesList 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 seasonsList a competition's seasons, newest first, with the dates each runs.
List teamsList the teams taking part in a season of a competition.
Search playersFind players by name, the most-capped internationals first.
Search teamsFind 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 IDmatch_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 IDmatch_idtextRequired
The match's id, from 'List matches', 'List live matches' or a FIFA trigger.
Eventsincludetext
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 IDplayer_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

Competitioncompetition_idtextRequired
The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
Seasonseason_idtextRequired
The season, newest first. Pick the competition first.
TeamteamtextRequired
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

Competitioncompetition_idtextRequired
The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
Seasonseason_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 IDteamtextRequired
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 womengendertext
The men's or the women's ranking. Defaults to men's.One of: men, women.
Confederationconfederationtext
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 onas_ofdate
The ranking that was current on this day. Leave empty for the latest.
Maximum teamslimitnumber
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 containssearchtext
Only competitions whose name or country contains this, e.g. 'World Cup' or 'England'.
Confederationconfederationtext
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 womengendertext
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

Competitioncompetition_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

Competitioncompetition_idtext
Only matches in this competition. Type to search the list.
Seasonseason_idtext
Only matches in this season: the whole season unless dates are given too. Pick the competition first.
Teamteamtext
Only this team's matches. The list shows the competition's current teams; any team id from 'Search teams' works too.
From datefrom_datedate
Matches on or after this day (UTC). Without dates or a season, the next 7 days.
To dateto_datedate
Matches on or before this day (UTC), at most a year after the first.
Statusstatustext
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 matcheslimitnumber
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

Competitioncompetition_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

Competitioncompetition_idtextRequired
The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
Seasonseason_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

NamenametextRequired
All or part of the player's name, e.g. 'Saka'.
Maximum resultslimitnumber
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

NamenametextRequired
All or part of the team's name, e.g. 'Arsenal'.
Clubs or national teamsteam_typetext
Only clubs, or only national teams.One of: club (Clubs), national (National teams).
Men or womengendertext
Only men's or only women's teams.One of: men, women.
Maximum resultslimitnumber
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"
    }
  ]
}

On this page