# UEFA API: Get competition matches

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

Unofficial. Not affiliated with or endorsed by UEFA.

- Page: https://fous.com/methods/uefa.com/get-competition-matches
- Method: `uefa.com/get_competition_matches`, version 1
- Website: uefa.com
- Returns: stage, kick-off, clubs, score, status, stadium, city, match 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 |
|---|---|---|---|---|
| `club` | string | no |  | Only matches involving this club, for example Bayern Munich. |
| `season` | integer | no | `2026` | Starting year of the season, for example 2026 for 2026/27. Defaults to the current season. |
| `end_date` | string | no | `"2026-09-23"` | Last local match date as YYYY-MM-DD, for example 2026-09-10. Defaults to fourteen days from now. |
| `time_zone` | string | no | `"America/New_York"` | Time zone for dates and kick-offs, for example Europe/Paris or America/New_York. Defaults to Central European Time. |
| `start_date` | string | no | `"2026-09-22"` | First local match date as YYYY-MM-DD, for example 2026-09-08. Defaults to seven days ago. |
| `competition` | string | yes | `"womens_champions_league"` | UEFA competition, for example champions_league. One of "champions_league", "europa_league", "conference_league", "womens_champions_league". |

## Output

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

```json
{
  "season": 2026,
  "end_date": "2026-09-23",
  "time_zone": "America/New_York",
  "start_date": "2026-09-22",
  "competition": "womens_champions_league"
}
```

Its output:

```json
{
  "matches": [
    {
      "city": "Unterhaching",
      "score": "2-2",
      "stage": "League phase, Matchday 1",
      "status": "Finished",
      "stadium": "Stadion Am Sportpark",
      "kick_off": "2026-09-22T12:45:00-04:00",
      "match_id": "2050547",
      "away_club": "Man City",
      "home_club": "Bayern",
      "match_link": "https://www.uefa.com/womenschampionsleague/match/2050547/"
    },
    {
      "city": "Monza",
      "score": "1-0",
      "stage": "League phase, Matchday 1",
      "status": "Finished",
      "stadium": "Brianteo",
      "kick_off": "2026-09-22T12:45:00-04:00",
      "match_id": "2050551",
      "away_club": "Häcken",
      "home_club": "Inter",
      "match_link": "https://www.uefa.com/womenschampionsleague/match/2050551/"
    },
    {
      "city": "Borehamwood",
      "score": "1-0",
      "stage": "League phase, Matchday 1",
      "status": "Finished",
      "stadium": "Meadow Park",
      "kick_off": "2026-09-22T15:00:00-04:00",
      "match_id": "2050548",
      "away_club": "HB Køge",
      "home_club": "Arsenal",
      "match_link": "https://www.uefa.com/womenschampionsleague/match/2050548/"
    }
  ]
}
```

## 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":"uefa.com/get_competition_matches","input":{"season":2026,"end_date":"2026-09-23","time_zone":"America/New_York","start_date":"2026-09-22","competition":"womens_champions_league"}}'
```

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

- What Champions League games does Arsenal play between March 1 and March 20, and what time do they kick off in New York time?
- Show me all Europa League matches next week with scores, venues and cities.
- Any Women's Champions League fixtures for the 2026/27 season in September, with kick-off times in Tokyo time?
- Which Conference League matches are scheduled for late October, and where are they being played?
- On uefa.com, list the Bayern Munich matches from the upcoming Champions League round with stadium names and match links.

## Input schema

```json
{
  "type": "object",
  "required": [
    "competition"
  ],
  "properties": {
    "club": {
      "type": "string",
      "description": "Only matches involving this club, for example Bayern Munich."
    },
    "season": {
      "type": "integer",
      "maximum": 2200,
      "minimum": 1950,
      "description": "Starting year of the season, for example 2026 for 2026/27. Defaults to the current season."
    },
    "end_date": {
      "type": "string",
      "description": "Last local match date as YYYY-MM-DD, for example 2026-09-10. Defaults to fourteen days from now."
    },
    "time_zone": {
      "type": "string",
      "description": "Time zone for dates and kick-offs, for example Europe/Paris or America/New_York. Defaults to Central European Time."
    },
    "start_date": {
      "type": "string",
      "description": "First local match date as YYYY-MM-DD, for example 2026-09-08. Defaults to seven days ago."
    },
    "competition": {
      "enum": [
        "champions_league",
        "europa_league",
        "conference_league",
        "womens_champions_league"
      ],
      "type": "string",
      "description": "UEFA competition, for example champions_league."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "matches"
  ],
  "properties": {
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "stage",
          "kick_off",
          "home_club",
          "away_club",
          "score",
          "status",
          "stadium",
          "city",
          "match_link",
          "match_id"
        ],
        "properties": {
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "score": {
            "type": [
              "string",
              "null"
            ]
          },
          "stage": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "stadium": {
            "type": [
              "string",
              "null"
            ]
          },
          "kick_off": {
            "type": [
              "string",
              "null"
            ]
          },
          "match_id": {
            "type": "string"
          },
          "away_club": {
            "type": [
              "string",
              "null"
            ]
          },
          "home_club": {
            "type": [
              "string",
              "null"
            ]
          },
          "match_link": {
            "type": "string"
          }
        }
      },
      "description": "Matches in kick-off order."
    }
  }
}
```

## See more

- [UEFA API: Get competition table](https://fous.com/methods/uefa.com/get-competition-table.md): Returns the league-phase or group-stage table for a UEFA club competition and season, with qualification labels where shown.
- [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.
- [FIFA API: Get tournament matches](https://fous.com/methods/fifa.com/get-tournament-matches.md): Gets FIFA tournament matches in kick-off order, with scores, stages, teams and venues. The tournament name must include a year.
- [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.
- [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.
- [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.
- [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.
- [NFL API: Get scores](https://fous.com/methods/nfl.com/get-scores.md): Gets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone.
- [All UEFA methods](https://fous.com/methods/uefa.com.md)
