Football Data

https://www.football-data.org/documentation
Admin
Football Data is a free RESTful API providing reliable football data including areas, competitions,...
Tokens:25,186
Snippets:168
Trust Score:9.6
Update:5 months ago
Show doc for...
Tokens:
Raw
### Retrieve League Table

Source: https://www.football-data.org/documentation/quickstart

This example shows how to get the league table for a specific competition.

```APIDOC
## GET /competitions/{code}/standings

### Description
Retrieves the league table (standings) for a specified competition.

### Method
GET

### Endpoint
/v4/competitions/{code}/standings

### Parameters
#### Path Parameters
- **code** (String) - Required - The unique code of the competition (e.g., 'PL' for Premier League, 'DED' for Eredivisie).

### Query Parameters
- **season** (String /yyyy/) - Optional - Filters the standings for a specific season.
```

--------------------------------

### Retrieve Matches for a Specific Competition

Source: https://www.football-data.org/documentation/quickstart

This example demonstrates how to get all matches for a particular competition, such as the Champions League.

```APIDOC
## GET /competitions/{code}/matches

### Description
Retrieves all matches for a specific competition identified by its code.

### Method
GET

### Endpoint
/v4/competitions/{code}/matches

### Parameters
#### Path Parameters
- **code** (String) - Required - The unique code of the competition (e.g., 'CL' for Champions League, 'PL' for Premier League).

### Query Parameters
- **matchday** (Integer /[1-4]+[0-9]*/) - Optional - Filters matches by a specific matchday.
- **status** (Enum /[A-Z]+/) - Optional - The status of a match. Possible values: [SCHEDULED | LIVE | IN_PLAY | PAUSED | FINISHED | POSTPONED | SUSPENDED | CANCELLED]
- **dateFrom** (String /yyyy-MM-dd/) - Optional - Filters matches from a specific start date.
- **dateTo** (String /yyyy-MM-dd/) - Optional - Filters matches up to a specific end date.
- **season** (String /yyyy/) - Optional - Filters matches for a specific season.
- **limit** (Integer /\d+/) - Optional - Limits the number of results. Defaults to 10.
- **offset** (Integer /\d+/) - Optional - Skips a specified number of records for pagination.
```

--------------------------------

### Get Team Information

Source: https://www.football-data.org/documentation/quickstart

This example shows how to retrieve detailed information about a specific football team using its ID.

```APIDOC
## GET /teams/{id}

### Description
Retrieves detailed information about a specific football team.

### Method
GET

### Endpoint
/teams/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the team.

### Request Example
```bash
curl -X GET http://api.football-data.org/v4/teams/2061
```

### Response
#### Success Response (200)
- **area** (object) - Information about the team's area.
- **id** (integer) - The unique identifier of the team.
- **name** (string) - The full name of the team.
- **shortName** (string) - The short name of the team.
- **tla** (string) - The three-letter abbreviation for the team.
- **crest** (string) - URL to the team's crest image.
- **address** (string) - The team's physical address.
- **website** (string) - The team's official website URL.
- **founded** (integer) - The year the team was founded.
- **clubColors** (string) - The primary colors of the club.
- **venue** (string) - The name of the team's home stadium.
- **runningCompetitions** (array) - List of competitions the team is currently participating in.
- **coach** (object) - Information about the team's current coach.
- **marketValue** (integer) - The estimated market value of the team.
- **squad** (array) - A list of players in the team's squad.

#### Response Example
```json
{
    "area": {
        "id": 2011,
        "name": "Argentina",
        "code": "ARG",
        "flag": "https://crests.football-data.org/762.png"
    },
    "id": 2061,
    "name": "CA Boca Juniors",
    "shortName": "Boca Juniors",
    "tla": "BOC",
    "crest": "https://crests.football-data.org/2061.png",
    "address": "Brandsen 805, La Boca Buenos Aires, Buenos Aires 1161",
    "website": "http://www.bocajuniors.com.ar",
    "founded": 1905,
    "clubColors": "Dark Blue / Yellow",
    "venue": "Estadio Alberto José Armando",
    "runningCompetitions": [
        {
            "id": 2152,
            "name": "Copa Libertadores",
            "code": "CLI",
            "type": "CUP",
            "emblem": "https://crests.football-data.org/CLI.svg"
        }
    ],
    "coach": {
        "id": 60123,
        "firstName": "Sebastián",
        "lastName": "Battaglia",
        "name": "Sebastián Battaglia",
        "dateOfBirth": "1980-11-08",
        "nationality": "Argentina",
        "contract": {
            "start": "2021-08",
            "until": "2022-12"
        }
    },
    "marketValue": 99700000,
    "squad": [
        {
            "id": 11656,
            "firstName": "Agustín",
            "lastName": "Rossi",
            "name": "Agustín Rossi",
            "position": "Goalkeeper",
            "dateOfBirth": "1995-08-21",
            "nationality": "Argentina",
            "shirtNumber": 1,
            "marketValue": 3200000,
            "contract": {
                "start": "2017-02",
                "until": "2023-12"
            }
        }
    ]
}
```
```

--------------------------------

### Get Competition Details

Source: https://www.football-data.org/documentation/quickstart

This example shows how to retrieve detailed information about a specific football competition, such as the Premier League (PL), using its code.

```APIDOC
## GET /competitions/{code}

### Description
Retrieves detailed information about a specific football competition.

### Method
GET

### Endpoint
/v4/competitions/PL

### Parameters
#### Path Parameters
- **code** (string) - Required - The unique code of the competition (e.g., PL for Premier League).

### Request Example
```bash
curl -X GET http://api.football-data.org/v4/competitions/PL
```

### Response
#### Success Response (200)
- **area** (object) - Information about the competition's area.
- **id** (integer) - The unique identifier of the competition.
- **name** (string) - The name of the competition.
- **code** (string) - The code representing the competition.
- **type** (string) - The type of competition (e.g., LEAGUE).
- **emblem** (string) - URL to the competition's emblem.
- **currentSeason** (object) - Details about the current season.
- **seasons** (array) - A list of past and current seasons for the competition.

#### Response Example
```json
{
    "area": {
        "id": 2072,
        "name": "England",
        "code": "ENG",
        "flag": "https://crests.football-data.org/770.svg"
    },
    "id": 2021,
    "name": "Premier League",
    "code": "PL",
    "type": "LEAGUE",
    "emblem": "https://crests.football-data.org/PL.png",
    "currentSeason": {
        "id": 733,
        "startDate": "2021-08-13",
        "endDate": "2022-05-22",
        "currentMatchday": 37,
        "winner": null,
        "stages": [
            "REGULAR_SEASON"
        ]
    },
    "seasons": [
        {
            "id": 733,
            "startDate": "2021-08-13",
            "endDate": "2022-05-22",
            "currentMatchday": 37,
            "winner": null,
            "stages": [
                "REGULAR_SEASON"
            ]
        }
    ]
}
```
```

--------------------------------

### Retrieve All Matches

Source: https://www.football-data.org/documentation/quickstart

This example shows how to retrieve all matches. You can apply various filters to narrow down the results.

```APIDOC
## GET /matches

### Description
Retrieves a list of all matches. This endpoint can be filtered using various query parameters.

### Method
GET

### Endpoint
/v4/matches

### Query Parameters
- **status** (Enum /[A-Z]+/) - Optional - The status of a match. Possible values: [SCHEDULED | LIVE | IN_PLAY | PAUSED | FINISHED | POSTPONED | SUSPENDED | CANCELLED]
- **matchday** (Integer /[1-4]+[0-9]*/) - Optional - Filters matches by a specific matchday.
- **dateFrom** (String /yyyy-MM-dd/) - Optional - Filters matches from a specific start date.
- **dateTo** (String /yyyy-MM-dd/) - Optional - Filters matches up to a specific end date.
- **season** (String /yyyy/) - Optional - Filters matches for a specific season.
- **competitions** (String /\d+,\d+/) - Optional - Comma separated list of competition IDs.
- **areas** (String /\d+,\d+/) - Optional - Comma separated list of area IDs.
- **limit** (Integer /\d+/) - Optional - Limits the number of results. Defaults to 10.
- **offset** (Integer /\d+/) - Optional - Skips a specified number of records for pagination.
```

--------------------------------

### Retrieve Matches for a Specific Team

Source: https://www.football-data.org/documentation/quickstart

This example shows how to fetch all upcoming matches for a given team, filtering by status.

```APIDOC
## GET /teams/{id}/matches

### Description
Retrieves all matches associated with a specific team, identified by its ID.

### Method
GET

### Endpoint
/v4/teams/{id}/matches

### Parameters
#### Path Parameters
- **id** (Integer) - Required - The unique ID of the team.

### Query Parameters
- **status** (Enum /[A-Z]+/) - Optional - Filters matches by status. Example: 'SCHEDULED'. Possible values: [SCHEDULED | LIVE | IN_PLAY | PAUSED | FINISHED | POSTPONED | SUSPENDED | CANCELLED]
- **dateFrom** (String /yyyy-MM-dd/) - Optional - Filters matches from a specific start date.
- **dateTo** (String /yyyy-MM-dd/) - Optional - Filters matches up to a specific end date.
- **limit** (Integer /\d+/) - Optional - Limits the number of results. Defaults to 10.
- **offset** (Integer /\d+/) - Optional - Skips a specified number of records for pagination.
```

--------------------------------

### Get Matches for a Specific Person

Source: https://www.football-data.org/documentation/quickstart

Find all matches where a particular person, identified by their ID, was involved. This example filters for 'FINISHED' matches.

```HTTP
https://api.football-data.org/v4/persons/2019/matches?status=FINISHED
```

--------------------------------

### Get League Table Standings

Source: https://www.football-data.org/documentation/quickstart

Retrieve the current league table standings for a specified competition. This example uses the Eredivisie competition code.

```HTTP
https://api.football-data.org/v4/competitions/DED/standings
```

--------------------------------

### Retrieve Matches for a Specific Person

Source: https://www.football-data.org/documentation/quickstart

This example demonstrates how to find matches involving a specific person, filtered by match status.

```APIDOC
## GET /persons/{id}/matches

### Description
Retrieves matches associated with a specific person, identified by their ID.

### Method
GET

### Endpoint
/v4/persons/{id}/matches

### Parameters
#### Path Parameters
- **id** (Integer) - Required - The unique ID of the person.

### Query Parameters
- **status** (Enum /[A-Z]+/) - Optional - Filters matches by status. Example: 'FINISHED'. Possible values: [SCHEDULED | LIVE | IN_PLAY | PAUSED | FINISHED | POSTPONED | SUSPENDED | CANCELLED]
- **dateFrom** (String /yyyy-MM-dd/) - Optional - Filters matches from a specific start date.
- **dateTo** (String /yyyy-MM-dd/) - Optional - Filters matches up to a specific end date.
- **limit** (Integer /\d+/) - Optional - Limits the number of results. Defaults to 10.
- **offset** (Integer /\d+/) - Optional - Skips a specified number of records for pagination.
```

--------------------------------

### Retrieve Top Scorers

Source: https://www.football-data.org/documentation/quickstart

This example demonstrates how to fetch the top scorers for a given competition. The limit defaults to 10.

```APIDOC
## GET /competitions/{code}/scorers

### Description
Retrieves a list of top scorers for a specified competition.

### Method
GET

### Endpoint
/v4/competitions/{code}/scorers

### Parameters
#### Path Parameters
- **code** (String) - Required - The unique code of the competition (e.g., 'SA' for Serie A).

### Query Parameters
- **limit** (Integer /\d+/) - Optional - Limits the number of top scorers returned. Defaults to 10.
```

--------------------------------

### Fetch Matches for a Specific Competition

Source: https://www.football-data.org/documentation/quickstart

Use this endpoint to retrieve all matches for a given competition and matchday. Include the 'X-Unfold-Goals' header to get detailed goal information.

```bash
curl -X GET http://api.football-data.org/v4/competitions/2003/matches?matchday=1 -H "X-Unfold-Goals: true"
```

--------------------------------

### Get Today's Matches

Source: https://www.football-data.org/documentation/quickstart

Retrieve all matches scheduled for the current day from your subscribed competitions.

```HTTP
https://api.football-data.org/v4/matches
```

--------------------------------

### Get Champions League Matches

Source: https://www.football-data.org/documentation/quickstart

Fetch all matches belonging to the Champions League competition.

```HTTP
https://api.football-data.org/v4/competitions/CL/matches
```

--------------------------------

### Get Upcoming Matches for a Specific Team

Source: https://www.football-data.org/documentation/quickstart

Retrieve all scheduled matches for a given team, identified by its ID. This example filters for matches with a 'SCHEDULED' status.

```HTTP
https://api.football-data.org/v4/teams/86/matches?status=SCHEDULED
```

--------------------------------

### Get Player Information

Source: https://www.football-data.org/documentation/quickstart

Retrieve detailed information about a specific player using their unique ID.

```APIDOC
## GET /persons/{id}

### Description
Retrieves detailed information about a specific player.

### Method
GET

### Endpoint
`/v4/persons/{id}`

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the player.

### Request Example
```bash
curl -X GET http://api.football-data.org/v4/persons/44
```

### Response
#### Success Response (200)
- **id** (integer) - The player's unique identifier.
- **name** (string) - The full name of the player.
- **firstName** (string) - The first name of the player.
- **lastName** (string) - The last name of the player.
- **dateOfBirth** (string) - The player's date of birth (YYYY-MM-DD).
- **nationality** (string) - The player's nationality.
- **position** (string) - The player's primary position.
- **shirtNumber** (integer) - The player's current shirt number.
- **lastUpdated** (string) - The timestamp when the player's data was last updated.
- **currentTeam** (object) - Information about the player's current team.

#### Response Example
```json
{
    "id": 44,
    "name": "Cristiano Ronaldo",
    "firstName": "Cristiano Ronaldo",
    "lastName": "dos Santos Aveiro",
    "dateOfBirth": "1985-02-05",
    "nationality": "Portugal",
    "position": "Centre-Forward",
    "shirtNumber": 7,
    "lastUpdated": "2021-10-13T08:04:10Z",
    "currentTeam": {
        "area": {
            "id": 2072,
            "name": "England",
            "code": "ENG",
            "flag": "https://crests.football-data.org/770.svg"
        },
        "id": 66,
        "name": "Manchester United FC",
        "shortName": "Man United",
        "tla": "MUN",
        "crest": "https://crests.football-data.org/66.png",
        "address": "Sir Matt Busby Way Manchester M16 0RA",
        "website": "http://www.manutd.com",
        "founded": 1878,
        "clubColors": "Red / White",
        "venue": "Old Trafford",
        "runningCompetitions": [
            {
                "id": 2021,
                "name": "Premier League",
                "code": "PL",
                "type": "LEAGUE",
                "emblem": "https://crests.football-data.org/PL.png"
            },
            {
                "id": 2001,
                "name": "UEFA Champions League",
                "code": "CL",
                "type": "CUP",
                "emblem": "https://crests.football-data.org/CL.png"
            },
            {
                "id": 2055,
                "name": "FA Cup",
                "code": "FAC",
                "type": "CUP",
                "emblem": "https://crests.football-data.org/FA_CUP.png"
            }
        ],
        "contract": {
            "start": "2021-08",
            "until": "2023-06"
        }
    }
}
```
```

--------------------------------

### Get Player Matches

Source: https://www.football-data.org/documentation/quickstart

Fetches a list of matches a specific player has participated in, with optional filtering.

```APIDOC
## GET /persons/{id}/matches

### Description
Retrieves a list of matches for a given player ID. You can limit the number of results and specify competitions or permissions.

### Method
GET

### Endpoint
/persons/{id}/matches

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Maximum number of matches to return.
- **competitions** (string) - Optional - Comma-separated list of competition codes to filter by.
- **permission** (string) - Optional - Permission level for filtering results.

### Request Example
```bash
curl -X GET http://api.football-data.org/v4/persons/16271/matches?limit=5 -H "X-Unfold-Goals: true"
```

### Response
#### Success Response (200)
- **filters** (object) - Contains the filters applied to the request.
- **resultSet** (object) - Contains metadata about the results, such as count and date range.
- **aggregations** (object) - Provides aggregated statistics for the player across the returned matches.
- **person** (object) - Details about the player.
- **matches** (array) - A list of match objects.

#### Response Example
```json
{
    "filters": {
        "limit": 5,
        "offset": 0,
        "competitions": "BL1,DFB,EL,WC",
        "permission": "TIER_THREE"
    },
    "resultSet": {
        "count": 5,
        "competitions": "EL,BL1",
        "first": "2022-05-02",
        "last": "2022-05-18"
    },
    "aggregations": {
        "matchesOnPitch": 5,
        "startingXI": 3,
        "minutesPlayed": 328,
        "goals": 0,
        "ownGoals": 0,
        "assists": 0,
        "penalties": 0,
        "subbedOut": 1,
        "subbedIn": 2,
        "yellowCards": 0,
        "yellowRedCards": 0,
        "redCards": 0
    },
    "person": {
        "id": 16275,
        "name": "Djibril Sow",
        "firstName": "Djibril",
        "lastName": "Sow",
        "dateOfBirth": "1997-02-06",
        "nationality": "Switzerland",
        "position": "Midfield",
        "shirtNumber": null,
        "lastUpdated": "2022-03-17T16:47:43Z"
    },
    "matches": [
        {
            "area": {
                "id": 2077,
                "name": "Europe",
                "code": "EUR",
                "flag": "https://crests.football-data.org/EUR.svg"
            },
            "competition": {
                "id": 2146,
                "name": "UEFA Europa League",
                "code": "EL",
                "type": "CUP",
                "emblem": "https://crests.football-data.org/EL.png"
            },
            "season": {
                "id": 762,
                "startDate": "2021-08-05",
                "endDate": "2022-08-26",
                "currentMatchday": 6,
                "winner": {
                    "id": 19,
                    "name": "Eintracht Frankfurt",
                    "shortName": "Frankfurt",
                    "tla": "SGE",
                    "crest": "https://crests.football-data.org/19.svg",
                    "address": "Mörfelder Landstraße 362 Frankfurt am Main 60528",
                    "website": "http://www.eintracht.de",
                    "founded": 1899,
                    "clubColors": "Red / Black",
                    "venue": "Deutsche Bank Park",
                    "lastUpdated": "2020-11-26T02:04:32Z"
                },
                "stages": [
                    "QUALIFICATION_ROUND_3",
                    "GROUP_STAGE",
                    "PLAYOFF_ROUND",
                    "LAST_16",
                    "QUARTER_FINALS",
                    "SEMI_FINALS",
                    "FINAL"
                ]
            },
            "id": 391844,
            "utcDate": "2022-05-18T19:00:00Z",
            "status": "FINISHED",
            "minute": 120,
            "injuryTime": 1,
            "attendance": 38842,
            "venue": "Estadio R. Sanchez Pizjuan",
            "matchday": null,
            "stage": "FINAL",
            "group": null,
            "lastUpdated": "2022-05-20T08:41:17Z",
            "homeTeam": {
                "id": 19,
                "name": "Eintracht Frankfurt",
                "shortName": "Frankfurt",
                "tla": "SGE",
                "crest": "https://crests.football-data.org/19.svg",
                "coach": {
                    "id": 10727,
                    "name": "Oliver Glasner",
                    "nationality": "Austria"
                },
                "leagueRank": null,
                "formation": "3-4-2-1",
                "lineup": [],
                "bench": []
            },
            "awayTeam": {
                "id": 5376,
                "name": "Rangers FC",
                "shortName": "Rangers",
                "tla": "RAN",
                "crest": "https://crests.football-data.org/5376.svg",
                "coach": {
                    "id": 9580,
                    "name": "Giovanni van Bronckhorst",
                    "nationality": "Netherlands"
                },
                "leagueRank": null,
                "formation": "4-3-3",
                "lineup": [],
                "bench": []
            },
            "score": {
                "winner": "HOME_TEAM",
                "duration": "PENALTY_SHOOTOUT",
                "fullTime": {
                    "home": 6,
                    "away": 5
                },
                "halfTime": {
                    "home": 0,
                    "away": 0
                },
                "regularTime": {
                    "home": null,
                    "away": null
                },
                "extraTime": {
                    "home": 0,
                    "away": 0
                },
                "penalties": {
                    "home": 5,
                    "away": 4
                }
            },
            "goals": [],
            "penalties": [],
            "bookings": []
        }
    ]
}
```
```

--------------------------------

### Get Player Matches - cURL

Source: https://www.football-data.org/documentation/quickstart

Use this cURL command to retrieve a list of matches for a specific player. The 'X-Unfold-Goals' header can be used to include goal details.

```bash
curl -X GET http://api.football-data.org/v4/persons/16271/matches?limit=5 -H "X-Unfold-Goals: true"
```

--------------------------------

### Get Head-to-Head Match Data

Source: https://www.football-data.org/documentation/quickstart

Use this endpoint to retrieve historical match data between two specific teams. The 'limit' parameter can be used to control the number of returned matches.

```bash
curl -X GET http://api.football-data.org/v4/matches/327125/head2head?limit=50
```

--------------------------------

### Response for a Specific Area

Source: https://www.football-data.org/documentation/quickstart

This is an example JSON response when requesting details for a specific area. It includes the area's ID, name, code, and a list of child areas.

```json
{
    "id": 2267,
    "name": "World",
    "code": "INT",
    "flag": null,
    "parentAreaId": null,
    "parentArea": null,
    "childAreas": [
        {
            "id": 2001,
            "name": "Africa",
            "countryCode": "AFR",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2010,
            "name": "Arameans Suryoye",
            "countryCode": "ARS",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2014,
            "name": "Asia",
            "countryCode": "ASI",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2064,
            "name": "Darfur",
            "countryCode": "DAR",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2077,
            "name": "Europe",
            "countryCode": "EUR",
            "flag": "https://crests.football-data.org/EUR.svg",
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2159,
            "name": "N/C America",
            "countryCode": "NCA",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2166,
            "name": "NF-Board",
            "countryCode": "NFB",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2174,
            "name": "Occitania",
            "countryCode": "OCC",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2175,
            "name": "Oceania",
            "countryCode": "OCE",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2177,
            "name": "Padania",
            "countryCode": "PAD",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2188,
            "name": "Provence",
            "countryCode": "PRO",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2191,
            "name": "Raetia",
            "countryCode": "RAE",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2202,
            "name": "Sápmi",
            "countryCode": "SAP",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2220,
            "name": "South America",
            "countryCode": "SAM",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2222,
            "name": "Southern Cameroon",
            "countryCode": "SCM",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2238,
            "name": "Tamil Eelam",
            "countryCode": "TEL",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2251,
            "name": "Two Sicilies",
            "countryCode": "TSI",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        },
        {
            "id": 2265,
            "name": "West Indies",
            "countryCode": "WIN",
            "flag": null,
            "parentAreaId": 2267,
            "parentArea": "World"
        }
    ]
}
```

--------------------------------

### Get Match Details

Source: https://www.football-data.org/documentation/quickstart

This endpoint retrieves detailed information about a specific football match using its unique ID.

```APIDOC
## GET /matches/{id}

### Description
Retrieves detailed information about a specific football match.

### Method
GET

### Endpoint
/matches/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the match.

### Request Example
```bash
curl -X GET http://api.football-data.org/v4/matches/327117
```

### Response
#### Success Response (200)
- **area** (object) - Information about the match's area.
- **competition** (object) - Information about the competition.
- **season** (object) - Information about the season.
- **id** (integer) - The unique identifier of the match.
- **utcDate** (string) - The date and time of the match in UTC.
- **status** (string) - The current status of the match (e.g., FINISHED, LIVE).
- **minute** (integer) - The current minute of the match if ongoing.
- **injuryTime** (integer) - The injury time added to the match.
- **attendance** (integer) - The number of attendees for the match.
- **venue** (string) - The venue where the match was played.
- **matchday** (integer) - The matchday number.
- **stage** (string) - The stage of the competition.
- **group** (string) - The group the match belongs to, if applicable.
- **lastUpdated** (string) - The last time the match data was updated.
- **homeTeam** (object) - Information about the home team.
- **awayTeam** (object) - Information about the away team.

#### Response Example
```json
{
    "area": {
        "id": 2072,
        "name": "England",
        "code": "ENG",
        "flag": "https://crests.football-data.org/770.svg"
    },
    "competition": {
        "id": 2021,
        "name": "Premier League",
        "code": "PL",
        "type": "LEAGUE",
        "emblem": "https://crests.football-data.org/PL.png"
    },
    "season": {
        "id": 733,
        "startDate": "2021-08-13",
        "endDate": "2022-05-22",
        "currentMatchday": 37,
        "winner": null,
        "stages": [
            "REGULAR_SEASON"
        ]
    },
    "id": 327117,
    "utcDate": "2022-02-12T12:30:00Z",
    "status": "FINISHED",
    "minute": 90,
    "injuryTime": 6,
    "attendance": 73084,
    "venue": "Old Trafford",
    "matchday": 25,
    "stage": "REGULAR_SEASON",
    "group": null,
    "lastUpdated": "2022-05-17T17:33:08Z",
    "homeTeam": {
        "id": 66,
        "name": "Manchester United FC",
        "shortName": "Man United",
        "tla": "MUN",
        "crest": "https://crests.football-data.org/66.png",
        "coach": {
            "id": 59070,
            "name": "Ralf Rangnick",
            "nationality": "Germany"
        },
        "leagueRank": null,
        "formation": "4-2-3-1",
        "lineup": [
            {
                "id": 3188,
                "name": "David De Gea",
                "position": "Goalkeeper",
                "shirtNumber": 1
            }
        ],
        "bench": [
            {
                "id": 5457,
                "name": "Dean Henderson",
                "position": "Goalkeeper",
                "shirtNumber": 26
            }
        ],
        "statistics": {
            "goals": 1,
            "possession": 67,
            "shots": {
                "total": 15,
                "onTarget": 5,
                "offTarget": 10
            },
            "tackles": {
                "total": 30,
                "blocks": 3
            },
            "passes": {
                "total": 578,
                "accuracy": 87
            },
            "duels": {
                "total": 95,
                "won": 55
            },
            "fouls": 12,
            "corners": 7,
            "offsides": 3,
            "saves": 2,
            "yellowCards": 2,
            "redCards": 0
        }
    },
    "awayTeam": {
        "id": 522,
        "name": "Southampton FC",
        "shortName": "Southampton",
        "tla": "SOU",
        "crest": "https://crests.football-data.org/522.png",
        "coach": {
            "id": 8643,
            "name": "Ralph Hasenhüttl",
            "nationality": "Austria"
        },
        "leagueRank": null,
        "formation": "3-5-2",
        "lineup": [
            {
                "id": 8653,
                "name": "Fraser Forster",
                "position": "Goalkeeper",
                "shirtNumber": 44
            }
        ],
        "bench": [
            {
                "id": 8650,
                "name": "Alex McCarthy",
                "position": "Goalkeeper",
                "shirtNumber": 1
            }
        ],
        "statistics": {
            "goals": 1,
            "possession": 33,
            "shots": {
                "total": 7,
                "onTarget": 3,
                "offTarget": 4
            },
            "tackles": {
                "total": 25,
                "blocks": 5
            },
            "passes": {
                "total": 270,
                "accuracy": 79
            },
            "duels": {
                "total": 90,
                "won": 45
            },
            "fouls": 10,
            "corners": 3,
            "offsides": 1,
            "saves": 4,
            "yellowCards": 3,
            "redCards": 0
        }
    }
}
```
```

--------------------------------

### Get Premier League Matches for a Specific Matchday

Source: https://www.football-data.org/documentation/quickstart

Check the schedule for a specific competition (Premier League in this case) on a particular matchday. Requires the competition code and matchday number.

```HTTP
https://api.football-data.org/v4/competitions/PL/matches?matchday=11
```

--------------------------------

### Fetch Team Information

Source: https://www.football-data.org/documentation/quickstart

Use this `curl` command to make a GET request to the Football-Data API to retrieve details about a specific team. Replace '2061' with the desired team ID.

```bash
curl -X GET http://api.football-data.org/v4/teams/2061
```

--------------------------------

### Fetch Competition Details (PL)

Source: https://www.football-data.org/documentation/quickstart

Use this cURL command to retrieve detailed information about a specific competition, such as the Premier League (PL).

```bash
curl -X GET http://api.football-data.org/v4/competitions/PL
```

--------------------------------

### Fetch Matches Across Competitions

Source: https://www.football-data.org/documentation/quickstart

Use this endpoint to retrieve a list of matches across specified competitions. The X-Unfold-Goals header can be used to include goal details.

```bash
curl -X GET http://api.football-data.org/v4/matches -X "X-Unfold-Goals: true"
```

--------------------------------

### Fetch Competitions List

Source: https://www.football-data.org/documentation/quickstart

Use this cURL command to retrieve a list of all available football competitions from the API. Ensure you have the necessary API key for authentication.

```bash
curl -X GET http://api.football-data.org/v4/competitions/
```

--------------------------------

### Get Scorers for a Competition

Source: https://www.football-data.org/documentation/quickstart

This endpoint retrieves a list of top scorers for a specific competition. You can filter by season and limit the number of results.

```APIDOC
## GET /competitions/SA/scorers

### Description
Retrieves the top scorers for a given competition.

### Method
GET

### Endpoint
/competitions/{code}/scorers

### Parameters
#### Query Parameters
- **season** (integer) - Optional - Filter by season (e.g., 2021).
- **limit** (integer) - Optional - Limit the number of results returned.

### Request Example
```bash
curl -X GET http://api.football-data.org/v4/competitions/SA/scorers
```

### Response
#### Success Response (200)
- **count** (integer) - The number of scorers returned.
- **filters** (object) - The filters applied to the request.
  - **season** (string) - The season filter.
  - **limit** (integer) - The limit filter.
- **competition** (object) - Information about the competition.
  - **id** (integer) - The competition ID.
  - **name** (string) - The competition name.
  - **code** (string) - The competition code.
  - **type** (string) - The competition type.
  - **emblem** (string) - URL to the competition's emblem.
- **season** (object) - Information about the season.
  - **id** (integer) - The season ID.
  - **startDate** (string) - The start date of the season.
  - **endDate** (string) - The end date of the season.
  - **currentMatchday** (integer) - The current matchday.
  - **winner** (object or null) - Information about the season winner.
  - **stages** (array) - An array of strings representing the stages of the season.
- **scorers** (array) - An array of scorer objects.
  - **player** (object) - Information about the player.
    - **id** (integer) - The player ID.
    - **name** (string) - The player's full name.
    - **firstName** (string) - The player's first name.
    - **lastName** (string) - The player's last name.
    - **dateOfBirth** (string) - The player's date of birth.
    - **nationality** (string) - The player's nationality.
    - **position** (string) - The player's position.
    - **shirtNumber** (integer or null) - The player's shirt number.
    - **lastUpdated** (string) - The last time the player's data was updated.
  - **team** (object) - Information about the team the player belongs to.
    - **id** (integer) - The team ID.
    - **name** (string) - The team name.
    - **shortName** (string) - The team's short name.
    - **tla** (string) - The team's three-letter abbreviation.
    - **crest** (string) - URL to the team's crest.
    - **address** (string) - The team's address.
    - **website** (string) - The team's website.
    - **founded** (integer) - The year the team was founded.
    - **clubColors** (string) - The team's club colors.
    - **venue** (string) - The team's home venue.
    - **lastUpdated** (string) - The last time the team's data was updated.
  - **goals** (integer) - The number of goals scored by the player.
  - **assists** (integer) - The number of assists made by the player.
  - **penalties** (integer or null) - The number of penalties scored by the player.

### Response Example
```json
{
  "count": 10,
  "filters": {
    "season": "2021",
    "limit": 10
  },
  "competition": {
    "id": 2019,
    "name": "Serie A",
    "code": "SA",
    "type": "LEAGUE",
    "emblem": "https://crests.football-data.org/SA.png"
  },
  "season": {
    "id": 757,
    "startDate": "2021-08-21",
    "endDate": "2022-05-22",
    "currentMatchday": 37,
    "winner": null,
    "stages": [
      "REGULAR_SEASON"
    ]
  },
  "scorers": [
    {
      "player": {
        "id": 2076,
        "name": "Ciro Immobile",
        "firstName": "Ciro",
        "lastName": "Immobile",
        "dateOfBirth": "1990-02-20",
        "nationality": "Italy",
        "position": "Offence",
        "shirtNumber": null,
        "lastUpdated": "2021-10-13T08:03:51Z"
      },
      "team": {
        "id": 110,
        "name": "SS Lazio",
        "shortName": "Lazio",
        "tla": "LAZ",
        "crest": "https://crests.football-data.org/110.svg",
        "address": "Via di Santa Cornelia, 1000 Formello 00060",
        "website": "http://www.sslazio.it",
        "founded": 1900,
        "clubColors": "White / Sky Blue",
        "venue": "Stadio Olimpico",
        "lastUpdated": "2020-11-26T02:19:41Z"
      },
      "goals": 27,
      "assists": 2,
      "penalties": 7
    }
  ]
}
```
Tokens:
Raw