API-FOOTBALL.COM

api documentation

API DEMO

A demo version of the API is available at this url : https://www.api-football.com/demo.

Here are the leagues present in the demo version :

  • 2018 Russia World Cup
  • Champions League (2016-2017)
  • Brazil - Serie A (2016-2017-2018)
  • England - Premier League (2016-2017-2018)
  • Netherlands - Eredivisie (2016-2017-2018)
You can use it without restriction in your development environment.

This is a demo and does not represent the entire API. The data is limited and not up to date and serves only as an example. For production environement use : https://api-football-v1.p.mashape.com.

authentification

To use our API you must subscribe to one of our pricing plans (we have a FREE PLAN) on https://market.mashape.com.
For all your requests you must use the access key provided by mashape (X-Mashape-Key).

Requests

Whathever your programming language, our data works with and remain the same across all plateforms.
All requests to the API should be made with the unirest open-source library http://unirest.io.
All requests to the API will send you an answer in JSON format
Here are some examples of API calls.

Curl
curl --get --include 'https://api-football-v1.p.mashape.com/seasons' \
   -H 'X-Mashape-Key: XXXXXXXXXXXXXXXXXXXXXXXXX' \
   -H 'Accept: application/json'

Java
HttpResponse response = Unirest.get("https://api-football-v1.p.mashape.com/seasons")
   .header("X-Mashape-Key", "XXXXXXXXXXXXXXXXXXXXXXXXX")
   .header("Accept", "application/json")
   .asJson();

Node
unirest.get("https://api-football-v1.p.mashape.com/seasons")
   .header("X-Mashape-Key", "XXXXXXXXXXXXXXXXXXXXXXXXX")
   .header("Accept", "application/json")
   .end(function (result) {
      console.log(result.status, result.headers, result.body);
	});

Php
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/seasons",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Python
response = unirest.get("https://api-football-v1.p.mashape.com/seasons",
   headers={
      "X-Mashape-Key": "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept": "application/json"
   }
)

Objective-c
NSDictionary *headers = @{@"X-Mashape-Key": @"XXXXXXXXXXXXXXXXXXXXXXXXX", @"Accept": @"application/json"};
   UNIUrlConnection *asyncConnection = [[UNIRest get:^(UNISimpleRequest *request) {
      [request setUrl:@"https://api-football-v1.p.mashape.com/seasons"];
      [request setHeaders:headers];
   }] asJsonAsync:^(UNIHTTPJsonResponse *response, NSError *error) {
      NSInteger code = response.code;
      NSDictionary *responseHeaders = response.headers;
      UNIJsonNode *body = response.body;
      NSData *rawBody = response.rawBody;
	}];

Ruby
response = Unirest.get "https://api-football-v1.p.mashape.com/seasons",
   headers:{
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   }

.Net
Task response = Unirest.get("https://api-football-v1.p.mashape.com/seasons")
   .header("X-Mashape-Key", "XXXXXXXXXXXXXXXXXXXXXXXXX")
   .header("Accept", "application/json")
   .asJson();

Countries

Get all available countries in the API across all seasons and competitions.

Endoint Definition
Test this https://api-football-v1.p.mashape.com/countries

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/countries",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 22,
    "countries": {
      "1": "Argentina",
      "2": "Belarus",
      "3": "Belgium",
      "4": "Brazil",
      "5": "Bulgaria",
      "6": "China",
      "7": "Costa Rica",
      "8": "Denmark",
      "9": "England",
      "10": "France",
      "11": "Germany",
      "12": "Iceland",
      "13": "Italy",
      "14": "Japan",
      "15": "Netherlands",
      "16": "Norway",
      "17": "Poland",
      "18": "Portugal",
      "19": "Spain",
      "20": "Sweden",
      "21": "Wales",
      "22": "World"
    }
  }
}

Seasons

Get all available seasons.

Endoint Definition
Test this https://api-football-v1.p.mashape.com/seasons

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/seasons",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 3,
    "seasons": {
      "1": "2016",
      "2": "2017",
      "3": "2018"
    }
  }
}

Leagues

/leagues

Get all available leagues

Endoint Definition
Test this https://api-football-v1.p.mashape.com/leagues

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/leagues",
  array(
    "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
    "Accept" => "application/json"
  )
);

Response body 200 / JSON
{
  "api": {
    "results": 85,
    "leagues": {
      "1": {
        "league_id": "1",
        "name": "2018 Russia World cup",
        "country": "World",
        "season": "2018",
        "season_start": "2018-06-14",
        "season_end": "2018-07-15",
        "logo": "https://www.api-football.com/public/leagues/1.png",
        "standings": false
      },
      "2": {
        "league_id": "2",
        "name": "Premier League",
        "country": "England",
        "season": "2018",
        "season_start": "2018-08-10",
        "season_end": "2019-05-12",
        "logo": "https://www.api-football.com/public/leagues/2.png",
        "standings": true
      },
      "3": {
        "league_id": "3",
        "name": "Championship",
        "country": "England",
        "season": "2018",
        "season_start": "2018-08-03",
        "season_end": "2019-05-05",
        "logo": "https://www.api-football.com/public/leagues/3.png",
        "standings": true
      },
      "4": {
        "league_id": "4",
        "name": "Ligue 1",
        "country": "France",
        "season": "2018",
        "season_start": "2018-08-11",
        "season_end": "2019-05-25",
        "logo": "https://www.api-football.com/public/leagues/4.svg",
        "standings": true
      },
...



/leagues/league/{league_id}

Get one league from his ID

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/leagues/league/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/leagues/league/5",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "leagues": {
      "5": {
        "league_id": "5",
        "name": "Ligue 2",
        "country": "France",
        "season": "2018",
        "season_start": "2018-07-27",
        "season_end": "2019-09-21",
        "logo": "https://www.api-football.com/public/leagues/5.png",
        "standings": true
      }
    }
  }
}



/leagues/season/{season}

Get all leagues from one season

URL Parameters
SEASON
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/leagues/season/{season}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/leagues/season/2018",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 29,
    "leagues": {
      "1": {
        "league_id": "1",
        "name": "2018 Russia World Cup",
        "country": "World",
        "season": "2018",
        "season_start": "2018-06-14",
        "season_end": "2018-07-15",
        "logo": "https://www.api-football.com/public/leagues/1.png",
        "standings": false
      },
      "2": {
        "league_id": "2",
        "name": "Premier League",
        "country": "England",
        "season": "2018",
        "season_start": "2018-08-10",
        "season_end": "2019-05-12",
        "logo": "https://www.api-football.com/public/leagues/2.png",
        "standings": true
      },
      "3": {
        "league_id": "3",
        "name": "Championship",
        "country": "England",
        "season": "2018",
        "season_start": "2018-08-03",
        "season_end": "2019-05-05",
        "logo": "https://www.api-football.com/public/leagues/3.png",
        "standings": true
      },
...



/leagues/country/{country_name}/{season}

Get all leagues from one country and filter by season. (Filter by season is optional)

URL Parameters
COUNTRY
STRING
SEASON
NUMBER (optional)

Endoint Definition
Test this https://api-football-v1.p.mashape.com/leagues/country/{country_name}/{season}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/leagues/country/france/2018",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 2,
    "leagues": {
      "4": {
        "league_id": "4",
        "name": "Ligue 1",
        "country": "France",
        "season": "2018",
        "season_start": "2018-08-10",
        "season_end": "2019-05-25",
        "logo": "https://www.api-football.com/public/leagues/4.svg",
        "standings": true
      },
      "5": {
        "league_id": "5",
        "name": "Ligue 2",
        "country": "France",
        "season": "2018",
        "season_start": "2018-07-27",
        "season_end": "2019-09-21",
        "logo": "https://www.api-football.com/public/leagues/5.png",
        "standings": true
      }
    }
  }
}

Teams

/teams/team/{team_id}

Get one team from his ID

URL Parameters
TEAM_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/teams/team/{team_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/teams/team/33",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "teams": {
      "33": {
        "team_id": "33",
        "name": "Manchester United",
        "logo": "https://www.api-football.com/public/teams/33.png"
      }
    }
  }
}



/teams/league/{league_id}

Get all teams from one league

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/teams/league/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/teams/league/37",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 20,
    "teams": {
      "33": {
        "team_id": "33",
        "name": "Manchester United",
        "logo": "https://www.api-football.com/public/teams/33.png"
      },
      "34": {
        "team_id": "34",
        "name": "Newcastle",
        "logo": "https://www.api-football.com/public/teams/34.png"
      },
      "35": {
        "team_id": "35",
        "name": "Bournemouth",
        "logo": "https://www.api-football.com/public/teams/35.png"
      },
      "37": {
        "team_id": "37",
        "name": "Huddersfield",
        "logo": "https://www.api-football.com/public/teams/37.png"
      },
...

Players

Get coachs and players from one team and season.

URL Parameters
SEASON
NUMBER
TEAM_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/players/{season}/{team_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/players/2018/33",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 28,
    "coachs": [
      "Jose Mourinho"
    ],
    "players": [
      {
        "number": "",
        "player": "David De Gea"
      },
      {
        "number": "",
        "player": "Victor Nilsson-Lindelof"
      },
      {
        "number": "",
        "player": "Chris Smalling"
      },
      {
        "number": "",
        "player": "Ashley Young"
      },
      {
        "number": "",
        "player": "Matteo Darmian"
      },
      {
        "number": "",
        "player": "Paul Pogba"
      },
      {
        "number": "",
        "player": "Juan Mata"
      },
      {
        "number": "",
        "player": "Anthony Martial"
      },
      {
        "number": "",
        "player": "Jesse Lingard"
      },
      {
        "number": "",
        "player": "Nemanja Matic"
      },
      {
        "number": "",
        "player": "Romelu Lukaku"
      },
      {
        "number": "",
        "player": "Phil Jones"
      },
      {
        "number": "",
        "player": "Alexis Sanchez"
      },
      {
        "number": "",
        "player": "Marcus Rashford"
      },
      {
        "number": "",
        "player": "Lee Grant"
      },
      {
        "number": "",
        "player": "Fred"
      },
      {
        "number": "",
        "player": "Antonio Valencia"
      },
      {
        "number": "",
        "player": "Marouane Fellaini"
      },
      {
        "number": "",
        "player": "Luke Shaw"
      },
      {
        "number": "",
        "player": "Eric Bailly"
      },
      {
        "number": "",
        "player": "Andreas Pereira"
      },
      {
        "number": "",
        "player": "Sergio Romero"
      },
      {
        "number": "",
        "player": "Scott McTominay"
      },
      {
        "number": "39",
        "player": "Scott Mctominay"
      },
      {
        "number": "21",
        "player": "Ander Herrera"
      },
      {
        "number": "5",
        "player": "Faustino Marcos Alberto Rojo"
      },
      {
        "number": "20",
        "player": "Diogo Dalot"
      }
    ]
  }
}

Standings

Get the league table from one league. Updated every four hours.

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/standings/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/standings/37",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 20,
    "standings": {
      "1": {
        "league_id": "37",
        "team_id": "50",
        "teamName": "Manchester City",
        "play": "38",
        "win": "32",
        "draw": "4",
        "lose": "2",
        "goalsFor": "106",
        "goalsAgainst": "27",
        "goalsDiff": "79",
        "points": "100"
      },
      "2": {
        "league_id": "37",
        "team_id": "33",
        "teamName": "Manchester United",
        "play": "38",
        "win": "25",
        "draw": "6",
        "lose": "7",
        "goalsFor": "68",
        "goalsAgainst": "28",
        "goalsDiff": "40",
        "points": "81"
      },
      "3": {
        "league_id": "37",
        "team_id": "47",
        "teamName": "Tottenham",
        "play": "38",
        "win": "23",
        "draw": "8",
        "lose": "7",
        "goalsFor": "74",
        "goalsAgainst": "36",
        "goalsDiff": "38",
        "points": "77"
      },
      "4": {
        "league_id": "37",
        "team_id": "40",
        "teamName": "Liverpool",
        "play": "38",
        "win": "21",
        "draw": "12",
        "lose": "5",
        "goalsFor": "84",
        "goalsAgainst": "38",
        "goalsDiff": "46",
        "points": "75"
      },
...

Fixtures

/fixtures/live

Get all fixtures in play. Updated every minutes. it can be delayed from 1 to 5 minutes depending on the league/cup.

Endoint Definition
Test this https://api-football-v1.p.mashape.com/fixtures/live

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/fixtures/live",
  array(
    "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
    "Accept" => "application/json"
  )
);

Response body 200 / JSON
{
  "api": {
    "results": 12,
    "fixtures": {
      "2839": {
        "fixture_id": "2839",
        "event_timestamp": "1534185000",
        "event_date": "2018-08-13T18:30:00+00:00",
        "league_id": "9",
        "round": "2. Bundesliga - 2",
        "homeTeam_id": "192",
        "awayTeam_id": "182",
        "homeTeam": "FC Koln",
        "awayTeam": "Union Berlin",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "1",
        "halftime_score": "1 - 0",
        "final_score": "1 - 1",
        "penalty": null,
        "elapsed": "93",
        "firstHalfStart": "1534185060",
        "secondHalfStart": "1534188780"
      },
      "3439": {
        "fixture_id": "3439",
        "event_timestamp": "1534187700",
        "event_date": "2018-08-13T19:15:00+00:00",
        "league_id": "11",
        "round": "Primeira Liga - 1",
        "homeTeam_id": "216",
        "awayTeam_id": "222",
        "homeTeam": "Portimonense",
        "awayTeam": "Boavista",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "2",
        "halftime_score": "0 - 0",
        "final_score": "0 - 2",
        "penalty": null,
        "elapsed": "94",
        "firstHalfStart": "1534187760",
        "secondHalfStart": "1534191480"
      },
      "4951": {
        "fixture_id": "4951",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "15",
        "round": "Eliteserien - 18",
        "homeTeam_id": "328",
        "awayTeam_id": "326",
        "homeTeam": "Haugesund",
        "awayTeam": "Valerenga",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1534179600",
        "secondHalfStart": "1534183200"
      },
	  {...}
      }
    }
  }
}



/fixtures/date/{date}

Get all fixtures from one date

URL Parameters
DATE
STRING

Endoint Definition
Test this https://api-football-v1.p.mashape.com/fixtures/date/{date}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/fixtures/date/2018-07-15",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
	  "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 12,
    "fixtures": {
      "2839": {
        "fixture_id": "2839",
        "event_timestamp": "1534185000",
        "event_date": "2018-08-13T18:30:00+00:00",
        "league_id": "9",
        "round": "2. Bundesliga - 2",
        "homeTeam_id": "192",
        "awayTeam_id": "182",
        "homeTeam": "FC Koln",
        "awayTeam": "Union Berlin",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "1",
        "halftime_score": "1 - 0",
        "final_score": "1 - 1",
        "penalty": null,
        "elapsed": "93",
        "firstHalfStart": "1534185060",
        "secondHalfStart": "1534188780"
      },
      "3439": {
        "fixture_id": "3439",
        "event_timestamp": "1534187700",
        "event_date": "2018-08-13T19:15:00+00:00",
        "league_id": "11",
        "round": "Primeira Liga - 1",
        "homeTeam_id": "216",
        "awayTeam_id": "222",
        "homeTeam": "Portimonense",
        "awayTeam": "Boavista",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "2",
        "halftime_score": "0 - 0",
        "final_score": "0 - 2",
        "penalty": null,
        "elapsed": "94",
        "firstHalfStart": "1534187760",
        "secondHalfStart": "1534191480"
      },
      "4951": {
        "fixture_id": "4951",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "15",
        "round": "Eliteserien - 18",
        "homeTeam_id": "328",
        "awayTeam_id": "326",
        "homeTeam": "Haugesund",
        "awayTeam": "Valerenga",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1534179600",
        "secondHalfStart": "1534183200"
      },
      "5085": {
        "fixture_id": "5085",
        "event_timestamp": "1534176000",
        "event_date": "2018-08-13T16:00:00+00:00",
        "league_id": "16",
        "round": "Ekstraklasa - 4",
        "homeTeam_id": "346",
        "awayTeam_id": "337",
        "homeTeam": "Korona Kielce",
        "awayTeam": "Slask Wroclaw",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "2",
        "goalsAwayTeam": "1",
        "halftime_score": "1 - 1",
        "final_score": "2 - 1",
        "penalty": null,
        "elapsed": "95",
        "firstHalfStart": "1534176060",
        "secondHalfStart": "1534179780"
      },
      "5558": {
        "fixture_id": "5558",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "18",
        "round": "Allsvenskan - 17",
        "homeTeam_id": "378",
        "awayTeam_id": "363",
        "homeTeam": "IFK Norrkoping",
        "awayTeam": "Hammarby FF",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "0 - 0",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1534179600",
        "secondHalfStart": "1534183200"
      },
      "5561": {
        "fixture_id": "5561",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "18",
        "round": "Allsvenskan - 17",
        "homeTeam_id": "369",
        "awayTeam_id": "373",
        "homeTeam": "trelleborgs FF",
        "awayTeam": "GIF Sundsvall",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "6",
        "halftime_score": "1 - 3",
        "final_score": "1 - 6",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1534179600",
        "secondHalfStart": "1534183200"
      },
      "5940": {
        "fixture_id": "5940",
        "event_timestamp": "1534179600",
        "event_date": "2018-08-13T17:00:00+00:00",
        "league_id": "20",
        "round": "Superligaen - 5",
        "homeTeam_id": "403",
        "awayTeam_id": "396",
        "homeTeam": "Esbjerg",
        "awayTeam": "Sonderjyske",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "94",
        "firstHalfStart": "1534179660",
        "secondHalfStart": "1534183380"
      },
	  {...}
    }
  }
}



/fixtures/id/{fixture_id}

Get one fixture from his ID

URL Parameters
FIXTURE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/fixtures/id/{fixture_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/fixtures/id/65",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "fixtures": {
      "65": {
        "fixture_id": "65",
        "event_timestamp": "1533927600",
        "event_date": "2018-08-10T19:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 1",
        "homeTeam_id": "33",
        "awayTeam_id": "46",
        "homeTeam": "Manchester United",
        "awayTeam": "Leicester",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "2",
        "goalsAwayTeam": "1",
        "halftime_score": "1 - 0",
        "final_score": "2 - 1",
        "penalty": null,
        "elapsed": "95",
        "firstHalfStart": "1533927660",
        "secondHalfStart": "1533931380"
      }
    }
  }
}



/fixtures/league/{league_id}

Get all fixtures from one league

URL Parameters
LEAGUE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/fixtures/league/{league_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/fixtures/league/5",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 380,
    "fixtures": {
      "1377": {
        "fixture_id": "1377",
        "event_timestamp": "1532714400",
        "event_date": "2018-07-27T18:00:00+00:00",
        "league_id": "5",
        "round": "Ligue 2 - 1",
        "homeTeam_id": "98",
        "awayTeam_id": "110",
        "homeTeam": "Ajaccio",
        "awayTeam": "Estac Troyes",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "1",
        "halftime_score": "0 - 1",
        "final_score": "0 - 1",
        "penalty": null,
        "elapsed": "95",
        "firstHalfStart": "1532714460",
        "secondHalfStart": "1532718180"
      },
      "1378": {
        "fixture_id": "1378",
        "event_timestamp": "1532714400",
        "event_date": "2018-07-27T18:00:00+00:00",
        "league_id": "5",
        "round": "Ligue 2 - 1",
        "homeTeam_id": "99",
        "awayTeam_id": "107",
        "homeTeam": "Clermont Foot",
        "awayTeam": "Chateauroux",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "0 - 0",
        "penalty": null,
        "elapsed": "95",
        "firstHalfStart": "1532714460",
        "secondHalfStart": "1532718180"
      },
      "1379": {
        "fixture_id": "1379",
        "event_timestamp": "1532714400",
        "event_date": "2018-07-27T18:00:00+00:00",
        "league_id": "5",
        "round": "Ligue 2 - 1",
        "homeTeam_id": "100",
        "awayTeam_id": "114",
        "homeTeam": "Gazelec FC Ajaccio",
        "awayTeam": "Paris FC",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "1",
        "halftime_score": "0 - 1",
        "final_score": "1 - 1",
        "penalty": null,
        "elapsed": "110",
        "firstHalfStart": "1532714460",
        "secondHalfStart": "1532718180"
      },
      "1380": {
        "fixture_id": "1380",
        "event_timestamp": "1532714400",
        "event_date": "2018-07-27T18:00:00+00:00",
        "league_id": "5",
        "round": "Ligue 2 - 1",
        "homeTeam_id": "101",
        "awayTeam_id": "115",
        "homeTeam": "Grenoble",
        "awayTeam": "Sochaux",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "115",
        "firstHalfStart": "1532714460",
        "secondHalfStart": "1532718180"
      },
	  {...}
    }
  }
}



/fixtures/h2h/{team_1}/{team_2}

Get all Head 2 Heads between 2 teams

URL Parameters
TEAM_ID
NUMBER
TEAM_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/fixtures/h2H/{team_1}/{team_2}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/fixtures/h2h/33/34",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
	  "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 4,
    "fixtures": {
      "141": {
        "fixture_id": "141",
        "event_timestamp": "1538834400",
        "event_date": "2018-10-06T14:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 8",
        "homeTeam_id": "33",
        "awayTeam_id": "34",
        "homeTeam": "Manchester United",
        "awayTeam": "Newcastle",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
      "272": {
        "fixture_id": "272",
        "event_timestamp": "1546358400",
        "event_date": "2019-01-01T16:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 21",
        "homeTeam_id": "34",
        "awayTeam_id": "33",
        "homeTeam": "Newcastle",
        "awayTeam": "Manchester United",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
      "11644": {
        "fixture_id": "11644",
        "event_timestamp": "1518362100",
        "event_date": "2018-02-11T15:15:00+00:00",
        "league_id": "37",
        "round": "Premier League - 27",
        "homeTeam_id": "34",
        "awayTeam_id": "33",
        "homeTeam": "Newcastle",
        "awayTeam": "Manchester United",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "1",
        "goalsAwayTeam": "0",
        "halftime_score": "0 - 0",
        "final_score": "1 - 0",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1518362100",
        "secondHalfStart": "1518365700"
      },
      "11794": {
        "fixture_id": "11794",
        "event_timestamp": "1511029800",
        "event_date": "2017-11-18T18:30:00+00:00",
        "league_id": "37",
        "round": "Premier League - 12",
        "homeTeam_id": "33",
        "awayTeam_id": "34",
        "homeTeam": "Manchester United",
        "awayTeam": "Newcastle",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "4",
        "goalsAwayTeam": "1",
        "halftime_score": "2 - 1",
        "final_score": "4 - 1",
        "penalty": null,
        "elapsed": "90",
        "firstHalfStart": "1511029800",
        "secondHalfStart": "1511033400"
      }
    }
  }
}



/fixtures/team/{team_id}

Get all fixtures from one team

URL Parameters
TEAM_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/fixtures/team/{team_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/fixtures/team/52",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 114,
    "fixtures": {
      "68": {
        "fixture_id": "68",
        "event_timestamp": "1533996000",
        "event_date": "2018-08-11T14:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 1",
        "homeTeam_id": "36",
        "awayTeam_id": "52",
        "homeTeam": "Fulham",
        "awayTeam": "Crystal Palace",
        "status": "Match Finished",
        "statusShort": "FT",
        "goalsHomeTeam": "0",
        "goalsAwayTeam": "2",
        "halftime_score": "0 - 1",
        "final_score": "0 - 2",
        "penalty": null,
        "elapsed": "93",
        "firstHalfStart": "1533996060",
        "secondHalfStart": "1533999780"
      },
      "84": {
        "fixture_id": "84",
        "event_timestamp": "1534791600",
        "event_date": "2018-08-20T19:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 2",
        "homeTeam_id": "52",
        "awayTeam_id": "40",
        "homeTeam": "Crystal Palace",
        "awayTeam": "Liverpool",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
      "92": {
        "fixture_id": "92",
        "event_timestamp": "1535286600",
        "event_date": "2018-08-26T12:30:00+00:00",
        "league_id": "2",
        "round": "Premier League - 3",
        "homeTeam_id": "38",
        "awayTeam_id": "52",
        "homeTeam": "Watford",
        "awayTeam": "Crystal Palace",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
      "99": {
        "fixture_id": "99",
        "event_timestamp": "1535810400",
        "event_date": "2018-09-01T14:00:00+00:00",
        "league_id": "2",
        "round": "Premier League - 4",
        "homeTeam_id": "52",
        "awayTeam_id": "41",
        "homeTeam": "Crystal Palace",
        "awayTeam": "Southampton",
        "status": "Not Started",
        "statusShort": "NS",
        "goalsHomeTeam": null,
        "goalsAwayTeam": null,
        "halftime_score": null,
        "final_score": null,
        "penalty": null,
        "elapsed": "0",
        "firstHalfStart": "0",
        "secondHalfStart": "0"
      },
	  {...}
    }
  }
}

Events Beta

Get all events from one fixture. (This endpoint is in Beta version, it may not be up to date until its final version planned for 01/2019).

Match events are updated at half-time and at the end of the match.

URL Parameters
FIXTURE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/events/{fixture_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/events/37509",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 10,
    "events": [
      {
        "elapsed": "12",
        "teamName": "Parana",
        "player": "Richard",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "14",
        "teamName": "Atletico mg",
        "player": "Fabio Santos",
        "type": "Goal",
        "detail": "Penalty"
      },
      {
        "elapsed": "18",
        "teamName": "Parana",
        "player": "Andrey",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "29",
        "teamName": "Parana",
        "player": "Silvinho",
        "type": "Card",
        "detail": "Red Card"
      },
      {
        "elapsed": "35",
        "teamName": "Atletico mg",
        "player": "Emerson Junior",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "45",
        "teamName": "Parana",
        "player": "Alex Santana",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "48",
        "teamName": "Parana",
        "player": "Andrey",
        "type": "Card",
        "detail": "Second Yellow Card"
      },
      {
        "elapsed": "49",
        "teamName": "Atletico mg",
        "player": "Bruno Roberto",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "52",
        "teamName": "Atletico mg",
        "player": "Patric",
        "type": "Card",
        "detail": "Yellow Card"
      },
      {
        "elapsed": "62",
        "teamName": "Parana",
        "player": "Charles",
        "type": "Card",
        "detail": "Yellow Card"
      }
    ]
  }
}

Line Ups

Get all line ups from one fixture.

  • Formation
  • Coach
  • Start XI
  • Substitutes
URL Parameters
FIXTURE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/lineups/{fixture_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/lineups/40697",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 2,
    "lineUps": {
      "germany": {
        "formation": "3-4-3",
        "coach": "Joachim Loew",
        "startXI": [
          {
            "number": "",
            "player": "Manuel Neuer"
          },
          {
            "number": "",
            "player": "Mats Hummels"
          },
          {
            "number": "",
            "player": "Niklas Suele"
          },
          {
            "number": "",
            "player": "Antonio Rudiger"
          },
          {
            "number": "",
            "player": "Thilo Kehrer"
          },
          {
            "number": "",
            "player": "Toni Kroos"
          },
          {
            "number": "",
            "player": "Nico Schulz"
          },
          {
            "number": "",
            "player": "Joshua Kimmich"
          },
          {
            "number": "",
            "player": "Timo Werner"
          },
          {
            "number": "",
            "player": "Leroy Sane"
          },
          {
            "number": "",
            "player": "Serge Gnabry"
          }
        ],
        "substitutes": [
          {
            "number": "",
            "player": "Jonas Hector"
          },
          {
            "number": "",
            "player": "Matthias Ginter"
          },
          {
            "number": "",
            "player": "Leon Goretzka"
          },
          {
            "number": "",
            "player": "Julian Brandt"
          },
          {
            "number": "",
            "player": "Marco Reus"
          },
          {
            "number": "",
            "player": "Bernd Leno"
          },
          {
            "number": "",
            "player": "Thomas Mueller"
          }
        ]
      },
      "netherlands": {
        "formation": "4-3-3",
        "coach": "Ronald Koeman",
        "startXI": [
          {
            "number": "1",
            "player": "Jasper Cillessen"
          },
          {
            "number": "",
            "player": "Kenny Tete"
          },
          {
            "number": "",
            "player": "Matthijs De Ligt"
          },
          {
            "number": "",
            "player": "Virgil Van Dijk"
          },
          {
            "number": "5",
            "player": "Daley Blind"
          },
          {
            "number": "",
            "player": "Marten De Roon"
          },
          {
            "number": "",
            "player": "Frenkie De Jong"
          },
          {
            "number": "20",
            "player": "Georginio Wijnaldum"
          },
          {
            "number": "",
            "player": "Quincy Promes"
          },
          {
            "number": "21",
            "player": "Memphis Depay"
          },
          {
            "number": "",
            "player": "Ryan Babel"
          }
        ],
        "substitutes": [
          {
            "number": "",
            "player": "Denzel Dumfries"
          },
          {
            "number": "",
            "player": "Jeroen Zoet"
          },
          {
            "number": "3",
            "player": "Stefan De Vrij"
          },
          {
            "number": "",
            "player": "Nathan Ake"
          },
          {
            "number": "17",
            "player": "Kevin Strootman"
          },
          {
            "number": "",
            "player": "Donny Van De Beek"
          },
          {
            "number": "",
            "player": "Pablo Paulino Rosario"
          }
        ]
      }
    }
  }
}

Odds

Get all pre-match odds from one fixture. We provide pre-match odds between 1 and 15 days before the match. (Some competitions do not have this feature).

URL Parameters
FIXTURE_ID
NUMBER

Endoint Definition
Test this https://api-football-v1.p.mashape.com/odds/{fixture_id}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/odds/123",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
	  "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 29,
    "odds": {
      "Win the match": {
        "1": {
          "label": "1",
          "pos": "1",
          "odd": "1.83"
        },
        "2": {
          "label": "2",
          "pos": "3",
          "odd": "5.00"
        },
        "N": {
          "label": "N",
          "pos": "2",
          "odd": "3.25"
        }
      },
      "Handicap [0:3]": {
        "1": {
          "label": "1",
          "pos": "1",
          "odd": "14.00"
        },
        "2": {
          "label": "2",
          "pos": "3",
          "odd": "1.01"
        },
        "N": {
          "label": "N",
          "pos": "2",
          "odd": "7.00"
        }
      },
      "Half Time": {
        "1": {
          "label": "1",
          "pos": "1",
          "odd": "2.35"
        },
        "2": {
          "label": "2",
          "pos": "3",
          "odd": "4.50"
        },
        "N": {
          "label": "N",
          "pos": "2",
          "odd": "1.80"
        }
      },
      "Exact score": {
        "1 - 0": {
          "label": "1 - 0",
          "pos": "1",
          "odd": "4.60"
        },
        "2 - 0": {
          "label": "2 - 0",
          "pos": "2",
          "odd": "6.50"
        },
        "2 - 1": {
          "label": "2 - 1",
          "pos": "3",
          "odd": "9.00"
        }
		{...}
      },
      "Double chance": {
        "1/N": {
          "label": "1/N",
          "pos": "1",
          "odd": "1.11"
        },
        "N/2": {
          "label": "N/2",
          "pos": "2",
          "odd": "1.88"
        },
        "1/2": {
          "label": "1/2",
          "pos": "3",
          "odd": "1.28"
        }
      },
      "Result & The 2 teams score": {
        "France / Yes": {
          "label": "France / Yes",
          "pos": "1",
          "odd": "4.45"
        },
        "France / No": {
          "label": "France / No",
          "pos": "2",
          "odd": "2.20"
        },
        "N / Yes": {
          "label": "N / Yes",
          "pos": "3",
          "odd": "4.20"
        },
        "N / No": {
          "label": "N / No",
          "pos": "4",
          "odd": "5.25"
        },
        "Croatie / Yes": {
          "label": "Croatie / Yes",
          "pos": "5",
          "odd": "10.00"
        },
        "Croatie / No": {
          "label": "Croatie / No",
          "pos": "6",
          "odd": "5.25"
        }
      },
      "Both teams score": {
        "Yes": {
          "label": "Yes",
          "pos": "1",
          "odd": "2.05"
        },
        "No": {
          "label": "No",
          "pos": "2",
          "odd": "1.45"
        }
      },
      "Over / Under 4.5 goals (Regulatory time)": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "6.00"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.01"
        }
      },
      "Over / Under 3.5 goals (Regulatory time)": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "3.70"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.10"
        }
      },
      "Over / Under 2.5 goals (Regulatory time)": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "2.30"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.35"
        }
      },
      "Over / Under 1.5 goal (Regulatory time)": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "1.42"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "2.10"
        }
      },
      "Scorer (90 Mins)": {
        "A.Griezmann": {
          "label": "A.Griezmann",
          "pos": "1",
          "odd": "2.60"
        },
        "A.Griezmann & L.Modric": {
          "label": "A.Griezmann & L.Modric",
          "pos": "2",
          "odd": "13.00"
        },
        "A.Griezmann & O.Girord": {
          "label": "A.Griezmann & O.Girord",
          "pos": "3",
          "odd": "8.50"
        },
        "A.Griezmann (2 or +)": {
          "label": "A.Griezmann (2 or +)",
          "pos": "4",
          "odd": "9.00"
        },
		{...}
      },
      "1st Goal scorer (90 Mins)": {
        "A.Griezmann": {
          "label": "A.Griezmann",
          "pos": "1",
          "odd": "5.00"
        },
        "B.Matuidi": {
          "label": "B.Matuidi",
          "pos": "2",
          "odd": "15.00"
        },
		{...}
      },
      "Face to Face": {
        "France": {
          "label": "France",
          "pos": "1",
          "odd": "1.28"
        },
        "Croatie": {
          "label": "Croatie",
          "pos": "2",
          "odd": "2.55"
        }
      },
      "1st goal": {
        "Team 1": {
          "label": "Team 1",
          "pos": "1",
          "odd": "1.50"
        },
        "Team 2": {
          "label": "Team 2",
          "pos": "2",
          "odd": "2.65"
        },
        "No goal": {
          "label": "No goal",
          "pos": "3",
          "odd": "6.50"
        }
      },
      "HT/FT": {
        "1/1": {
          "label": "1/1",
          "pos": "1",
          "odd": "2.65"
        },
        "1/N": {
          "label": "1/N",
          "pos": "2",
          "odd": "14.50"
        },
        "1/2": {
          "label": "1/2",
          "pos": "3",
          "odd": "30.00"
        },
        "N/1": {
          "label": "N/1",
          "pos": "4",
          "odd": "3.90"
        },
        "N/N": {
          "label": "N/N",
          "pos": "5",
          "odd": "4.00"
        },
        "N/2": {
          "label": "N/2",
          "pos": "6",
          "odd": "8.50"
        },
        "2/1": {
          "label": "2/1",
          "pos": "7",
          "odd": "22.00"
        },
        "2/N": {
          "label": "2/N",
          "pos": "8",
          "odd": "15.00"
        },
        "2/2": {
          "label": "2/2",
          "pos": "9",
          "odd": "7.50"
        }
      },
      "Result & Over/Under": {
        "France & over 3,5": {
          "label": "France & over 3,5",
          "pos": "1",
          "odd": "6.00"
        },
        "Draw & over 3,5": {
          "label": "Draw & over 3,5",
          "pos": "2",
          "odd": "11.00"
        },
        "Croatie & over 3,5": {
          "label": "Croatie & over 3,5",
          "pos": "3",
          "odd": "18.50"
        },
        "France & under 3,5": {
          "label": "France & under 3,5",
          "pos": "4",
          "odd": "2.00"
        },
        "Draw & under 3,5": {
          "label": "Draw & under 3,5",
          "pos": "5",
          "odd": "3.30"
        },
        "Croatie & under 3,5": {
          "label": "Croatie & under 3,5",
          "pos": "6",
          "odd": "5.00"
        },
        "France & over 1,5": {
          "label": "France & over 1,5",
          "pos": "1",
          "odd": "2.45"
        },
        "Draw & over 1,5": {
          "label": "Draw & over 1,5",
          "pos": "2",
          "odd": "3.65"
        },
        "Croatie & over 1,5": {
          "label": "Croatie & over 1,5",
          "pos": "3",
          "odd": "7.00"
        },
        "France & under 1,5": {
          "label": "France & under 1,5",
          "pos": "4",
          "odd": "4.70"
        },
        "Draw & under 1,5": {
          "label": "Draw & under 1,5",
          "pos": "5",
          "odd": "6.50"
        },
        "Croatie & under 1,5": {
          "label": "Croatie & under 1,5",
          "pos": "6",
          "odd": "8.50"
        },
        "France & over 2,5": {
          "label": "France & over 2,5",
          "pos": "1",
          "odd": "3.75"
        },
        "Draw & over 2,5": {
          "label": "Draw & over 2,5",
          "pos": "2",
          "odd": "11.00"
        },
        "Croatie & over 2,5": {
          "label": "Croatie & over 2,5",
          "pos": "3",
          "odd": "10.00"
        },
        "France & under 2,5": {
          "label": "France & under 2,5",
          "pos": "4",
          "odd": "2.60"
        },
        "Draw & under 2,5": {
          "label": "Draw & under 2,5",
          "pos": "5",
          "odd": "3.50"
        },
        "Croatie & under 2,5": {
          "label": "Croatie & under 2,5",
          "pos": "6",
          "odd": "6.25"
        },
        "France & over 4,5": {
          "label": "France & over 4,5",
          "pos": "1",
          "odd": "8.25"
        },
        "Draw & over 4,5": {
          "label": "Draw & over 4,5",
          "pos": "2",
          "odd": "19.50"
        },
        "Croatie & over 4,5": {
          "label": "Croatie & over 4,5",
          "pos": "3",
          "odd": "25.00"
        },
        "France & under 4,5": {
          "label": "France & under 4,5",
          "pos": "4",
          "odd": "1.85"
        },
        "Draw & under 4,5": {
          "label": "Draw & under 4,5",
          "pos": "5",
          "odd": "3.25"
        },
        "Croatie & under 4,5": {
          "label": "Croatie & under 4,5",
          "pos": "6",
          "odd": "5.00"
        }
      },
      "Double Chance HT": {
        "1/N": {
          "label": "1/N",
          "pos": "1",
          "odd": "1.10"
        },
        "N/2": {
          "label": "N/2",
          "pos": "2",
          "odd": "1.40"
        },
        "1/2": {
          "label": "1/2",
          "pos": "3",
          "odd": "1.68"
        }
      },
      "Exact Score HT": {
        "1 - 0": {
          "label": "1 - 0",
          "pos": "1",
          "odd": "3.15"
        },
        "2 - 0": {
          "label": "2 - 0",
          "pos": "2",
          "odd": "10.50"
        },
		{...}
      },
      "Over/Under HT 0.5 goal": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "1.45"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "2.05"
        }
      },
      "Over/Under MT 2,5 goals": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "5.50"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.01"
        }
      },
      "Over/Under HT 1.5 goal": {
        "Over": {
          "label": "Over",
          "pos": "1",
          "odd": "3.00"
        },
        "Under": {
          "label": "Under",
          "pos": "2",
          "odd": "1.19"
        }
      },
      "Both teams score HT": {
        "Yes": {
          "label": "Yes",
          "pos": "1",
          "odd": "4.20"
        },
        "No": {
          "label": "No",
          "pos": "2",
          "odd": "1.06"
        }
      },
      "1N2_2eMT": {
        "1": {
          "label": "1",
          "pos": "1",
          "odd": "2.10"
        },
        "2": {
          "label": "2",
          "pos": "3",
          "odd": "4.20"
        },
        "N": {
          "label": "N",
          "pos": "2",
          "odd": "2.05"
        }
      }
    }
  }
}

Statistics

Get team statistics for a one league/cup. You can pass the date if you want to add a limit.

URL Parameters
LEAGUE_ID
NUMBER
TEAM_ID
NUMBER
DATE
STRING (optional)

Endoint Definition
Test this https://api-football-v1.p.mashape.com/statistics/{league_id}/{team_id}/{date}

Php Request example
$response = Unirest\Request::get("https://api-football-v1.p.mashape.com/statistics/22/77/2018-12-10",
   array(
      "X-Mashape-Key" => "XXXXXXXXXXXXXXXXXXXXXXXXX",
      "Accept" => "application/json"
   )
);

Response body 200 / JSON
{
  "api": {
    "results": 1,
    "stats": {
      "matchs": {
        "matchsPlayed": {
          "home": "19",
          "away": "19",
          "total": "38"
        },
        "wins": {
          "home": "5",
          "away": "4",
          "total": "9"
        },
        "draws": {
          "home": "7",
          "away": "7",
          "total": "14"
        },
        "loses": {
          "home": "7",
          "away": "8",
          "total": "15"
        }
      },
      "goals": {
        "goalsFor": {
          "home": "23",
          "away": "19",
          "total": "42"
        },
        "goalsAgainst": {
          "home": "28",
          "away": "24",
          "total": "52"
        }
      },
      "goalsAvg": {
        "goalsFor": {
          "home": "1.2",
          "away": "1.0",
          "total": "1.1"
        },
        "goalsAgainst": {
          "home": "1.5",
          "away": "1.3",
          "total": "1.4"
        }
      }
    }
  }
}