# FIFA

> 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.

App · 14 actions. Web page: https://docs.lodol.com/docs/integrations/fifa

## Actions

### 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_id`, text, required): The match's id, from 'List matches', 'List live matches' or a FIFA trigger.

**Outputs**

- `match` (object): The match

**Example output**

```json
{
  "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_id`, text, required): The match's id, from 'List matches', 'List live matches' or a FIFA trigger.
- Events (`include`, text): 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**

- `count` (number): How many were returned
- `events` (list): The events, in order
- `match` (text): The match in one line, with its score
- `match_id` (text): The match's id

**Example output**

```json
{
  "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_id`, text, required): The player's id, from 'Search players', 'Get squad' or a match.

**Outputs**

- `player` (object): A player

**Example output**

```json
{
  "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_id`, text, required): The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
- Season (`season_id`, text, required): The season, newest first. Pick the competition first.
- Team (`team`, text, required): The team. Pick the competition and season first.

**Outputs**

- `coaches` (list): The coaches
- `count` (number): How many were returned
- `players` (list): The players, by shirt number
- `team` (text): The team's name
- `team_id` (text): The team's id

**Example output**

```json
{
  "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_id`, text, required): The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
- Season (`season_id`, text, required): The season, newest first. Pick the competition first.

**Outputs**

- `competition_id` (text): The competition's id
- `count` (number): How many were returned
- `groups` (list): The groups, e.g. 'Group A'. Empty for a league.
- `season_id` (text): The season's id
- `standings` (list): Every team's line, by stage, group and position

**Example output**

```json
{
  "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 (`team`, text, required): The team's id, from 'Search teams', 'List teams' or a match.

**Outputs**

- `team` (object): A team

**Example output**

```json
{
  "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 (`gender`, text): The men's or the women's ranking. Defaults to men's. One of: `men`, `women`.
- Confederation (`confederation`, text): 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_of`, date): The ranking that was current on this day. Leave empty for the latest.
- Maximum teams (`limit`, number): How many teams to return at most, from the top. Defaults to all. From 1 to 250.

**Outputs**

- `count` (number): How many were returned
- `gender` (text): 'men' or 'women'
- `published_on` (text): The day FIFA published it, YYYY-MM-DD
- `rankings` (list): The teams, by place

**Example output**

```json
{
  "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 (`search`, text): Only competitions whose name or country contains this, e.g. 'World Cup' or 'England'.
- Confederation (`confederation`, text): 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 (`gender`, text): Only men's or only women's competitions. One of: `men`, `women`.

**Outputs**

- `competitions` (list): The competitions
- `count` (number): How many were returned

**Example output**

```json
{
  "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_id`, text): Only matches in this competition. Type to search the list.

**Outputs**

- `count` (number): How many were returned
- `matches` (list): The matches, in kick-off order

**Example output**

```json
{
  "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_id`, text): Only matches in this competition. Type to search the list.
- Season (`season_id`, text): Only matches in this season: the whole season unless dates are given too. Pick the competition first.
- Team (`team`, text): Only this team's matches. The list shows the competition's current teams; any team id from 'Search teams' works too.
- From date (`from_date`, date): Matches on or after this day (UTC). Without dates or a season, the next 7 days.
- To date (`to_date`, date): Matches on or before this day (UTC), at most a year after the first.
- Status (`status`, text): 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 (`limit`, number): How many matches to return at most, 1 to 500. Defaults to 500. From 1 to 500.

**Outputs**

- `count` (number): How many were returned
- `from_date` (text): The first day covered, when dates were used
- `matches` (list): The matches, in kick-off order
- `more_available` (true/false): True when there were more matches than returned: narrow the dates or pick a competition
- `to_date` (text): The last day covered, when dates were used

**Example output**

```json
{
  "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_id`, text, required): The competition, such as the FIFA World Cup or the Premier League. Type to search the list.

**Outputs**

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

**Example output**

```json
{
  "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_id`, text, required): The competition, such as the FIFA World Cup or the Premier League. Type to search the list.
- Season (`season_id`, text, required): The season, newest first. Pick the competition first.

**Outputs**

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

**Example output**

```json
{
  "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 (`name`, text, required): All or part of the player's name, e.g. 'Saka'.
- Maximum results (`limit`, number): How many to return at most, 1 to 50. Defaults to 20. From 1 to 50.

**Outputs**

- `count` (number): How many were returned
- `players` (list): The players found

**Example output**

```json
{
  "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 (`name`, text, required): All or part of the team's name, e.g. 'Arsenal'.
- Clubs or national teams (`team_type`, text): Only clubs, or only national teams. One of: `club` (Clubs), `national` (National teams).
- Men or women (`gender`, text): Only men's or only women's teams. One of: `men`, `women`.
- Maximum results (`limit`, number): How many to return at most, 1 to 50. Defaults to 20. From 1 to 50.

**Outputs**

- `count` (number): How many were returned
- `teams` (list): The teams found

**Example output**

```json
{
  "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"
    }
  ]
}
```
