# FIFA API: Get tournament matches

> Gets FIFA tournament matches in kick-off order, with scores, stages, teams and venues. The tournament name must include a year.

Unofficial. Not affiliated with or endorsed by FIFA.

- Page: https://fous.com/methods/fifa.com/get-tournament-matches
- Method: `fifa.com/get_tournament_matches`, version 1
- Website: fifa.com
- Returns: tournament name; matches with stage, kick-off, teams, score, status, stadium, city, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `team` | string | no |  | Keep only matches involving this team, for example Argentina. Default "". |
| `time_zone` | string | no |  | Kick-off time zone. UTC is supported; any other value gives each venue's local time. Default "venue local time". |
| `tournament` | string | yes | `"World Cup 2026"` | Tournament name and year, for example World Cup 2026. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "tournament": "World Cup 2026"
}
```

Its output:

```json
{
  "matches": [
    {
      "city": "Mexico City",
      "score": "2-0",
      "stage": "Group A",
      "status": "finished",
      "stadium": "Mexico City Stadium",
      "kick_off": "2026-06-11T13:00:00-06:00",
      "match_id": "400021443",
      "away_team": "South Africa",
      "home_team": "Mexico",
      "match_link": "https://www.fifa.com/en/match-centre/match/17/285023/289273/400021443"
    },
    {
      "city": "Guadalajara",
      "score": "2-1",
      "stage": "Group A",
      "status": "finished",
      "stadium": "Guadalajara Stadium",
      "kick_off": "2026-06-11T20:00:00-06:00",
      "match_id": "400021441",
      "away_team": "Czechia",
      "home_team": "Korea Republic",
      "match_link": "https://www.fifa.com/en/match-centre/match/17/285023/289273/400021441"
    },
    {
      "city": "Toronto",
      "score": "1-1",
      "stage": "Group B",
      "status": "finished",
      "stadium": "Toronto Stadium",
      "kick_off": "2026-06-12T15:00:00-04:00",
      "match_id": "400021449",
      "away_team": "Bosnia and Herzegovina",
      "home_team": "Canada",
      "match_link": "https://www.fifa.com/en/match-centre/match/17/285023/289273/400021449"
    }
  ],
  "tournament_name": "FIFA World Cup 2026™"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"fifa.com/get_tournament_matches","input":{"tournament":"World Cup 2026"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me every match in the 2022 World Cup with kick-off times in UTC and the final scores
- List the Brazil games at the 2014 World Cup, with stadium and city for each one
- What are the fixtures for the Women's World Cup 2023, sorted by kick-off, in venue local time?
- Pull up the Germany matches from the 2018 World Cup on fifa.com, including stage and status
- Give me the full schedule of the 2026 World Cup as UTC kick-off times, filtered to Argentina

## Input schema

```json
{
  "type": "object",
  "required": [
    "tournament"
  ],
  "properties": {
    "team": {
      "type": "string",
      "default": "",
      "description": "Keep only matches involving this team, for example Argentina."
    },
    "time_zone": {
      "type": "string",
      "default": "venue local time",
      "description": "Kick-off time zone. UTC is supported; any other value gives each venue's local time."
    },
    "tournament": {
      "type": "string",
      "description": "Tournament name and year, for example World Cup 2026."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "tournament_name",
    "matches"
  ],
  "properties": {
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "score": {
            "type": [
              "string",
              "null"
            ]
          },
          "stage": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "enum": [
              "scheduled",
              "live",
              "finished"
            ],
            "type": "string"
          },
          "stadium": {
            "type": [
              "string",
              "null"
            ]
          },
          "kick_off": {
            "type": [
              "string",
              "null"
            ]
          },
          "match_id": {
            "type": "string"
          },
          "away_team": {
            "type": [
              "string",
              "null"
            ]
          },
          "home_team": {
            "type": [
              "string",
              "null"
            ]
          },
          "match_link": {
            "type": "string"
          }
        }
      }
    },
    "tournament_name": {
      "type": "string"
    }
  }
}
```

## See more

- [FIFA API: Get world ranking](https://fous.com/methods/fifa.com/get-world-ranking.md): Gets the latest official FIFA men's or women's national-team ranking, with points and movement since the previous ranking. Unranked teams are excluded.
- [UEFA API: Get competition matches](https://fous.com/methods/uefa.com/get-competition-matches.md): Gets UEFA club competition matches in a date range, with kick-off times in a chosen time zone, scores, stages and venues. You can limit the list to one club.
- [ESPN API: Get team schedule](https://fous.com/methods/espn.com/get-team-schedule.md): Returns a team's past results and upcoming games for a season on ESPN, with opponents, local start times, scores, broadcasts and venues. Soccer fixtures include all competitions shown for the team.
- [Premier League API: Get fixtures and results](https://fous.com/methods/premierleague.com/get-fixtures-and-results.md): Gets Premier League fixtures and results in a date range, with kickoff times in your chosen time zone. Returns up to 380 matches.
- [SofaScore API: Get football match](https://fous.com/methods/sofascore.com/get-match.md): Finds a football match between two teams on SofaScore (on a given date, or their latest played or live match) and returns its score, goals, red cards, team statistics and player ratings.
- [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games.
- [Cricbuzz API: Get live scores](https://fous.com/methods/cricbuzz.com/get-live-scores.md): Lists live, recent and upcoming cricket matches from Cricbuzz with teams, scores, venue and status. Filter by team or series name.
- [ESPN API: Get scores](https://fous.com/methods/espn.com/get-scores.md): Gets ESPN scores and the schedule for a league on a local day. You can filter by team, and start times are shown in your time zone.
- [All FIFA methods](https://fous.com/methods/fifa.com.md)
