League List

get
Get Leagues
https://api.football-data-api.com/league-list?key=YOURKEY
Sample Response (Access the URL below)
https://api.football-data-api.com/league-list?key=example

Returns a JSON array of all leagues available in the API Database. Each season of a competition gives a unique ID.
Request
Response
Request
Query Parameters
chosen_leagues_only
optional
string
If set to "true", the list will only return leagues that have been chosen by the user. ie ?key=xxxx&chosen_leagues_only=true
key
required
string
Your API Key
country
optional
integer
ISO number of the country. Will filter the response to leagues from the selected country.
Response
200: OK
Successfully retrieved all leagues.
{
    success: true,
    data: [
        {
            name: "USA MLS",
            season: [
                {
                    id: 1,
                    year: 2016
                },
                {
                    id: 16,
                    year: 2015
                },
                {
                    id: 1076,
                    year: 2018
                }
            ]
        },
    ]
}
Variable Name
Description
name
Name of the league
league_name
Name of the league without country
country
Country name
season > id
ID of the season
season > year
Year of the season

Tutorials - Previous

Make the First API Call

Next - Endpoints

Country List

Last updated 1 month ago

Variable Name	Description
name	Name of the league
league_name	Name of the league without country
country	Country name
season > id	ID of the season
season > year	Year of the season

League List

getGet Leagues

get
Get Leagues