sandalsoft · July 11, 2025 01:01
diff --git a/api-football.llms.txt b/api-football.llms.txt
 # https://www.api-football.com/documentation-v3 llms-full.txt

 ## API-Football Documentation
 We use cookies

 We use cookies and other tracking technologies to improve your browsing experience on our website, to show you personalized content and targeted ads, to analyze our website traffic, and to understand where our visitors are coming from.

 OKChange my preferences

 [![api-football logo](https://www.api-football.com/public/img/home1/hero-banner.png)](https://www.api-football.com/)

 - Introduction
 - Authentication
  - API-SPORTS Account
  - RAPIDAPI Account
 - Architecture
 - Logos / Images
 - Sample Scripts
  - C
  - C#
  - cURL
  - Dart
  - Go
  - Java
  - Javascript
  - NodeJs
  - Objective-c
  - OCaml
  - Php
  - PowerShell
  - Python
  - Ruby
  - Shell
  - Swift
 - Changelog
 - Integrations
  - CDN
    - Optimizing Sports Websites with BunnyCDN
  - Databases Solutions
    - Enhance Your Data Management with Aiven
    - Real-Time Data Management with Firebase
 - Widgets
  - Widgets
    - getGames
    - getGame
    - getStandings
 - Endpoints
  - Timezone
    - getTimezone
  - Countries
    - getCountries
  - Leagues
    - getLeagues
    - getSeasons
  - Teams
    - getTeams information
    - getTeams statistics
    - getTeams seasons
    - getTeams countries
  - Venues
    - getVenues
  - Standings
    - getStandings
  - Fixtures
    - getRounds
    - getFixtures
    - getHead To Head
    - getStatistics
    - getEvents
    - getLineups
    - getPlayers statistics
  - Injuries
    - getInjuries
  - Predictions
    - getPredictions
  - Coachs
    - getCoachs
  - Players
    - getSeasons
    - getProfiles
    - getStatistics
    - getSquads
    - getTeams
    - getTop Scorers
    - getTop Assists
    - getTop Yellow Cards
    - getTop Red Cards
  - Transfers
    - getTransfers
  - Trophies
    - getTrophies
  - Sidelined
    - getSidelined
  - Odds (In-Play)
    - getodds/live
    - getodds/live/bets
  - Odds (Pre-Match)
    - getOdds
    - getMapping
    - getBookmakers
    - getBets

 [API docs by Redocly](https://redocly.com/redoc/)

 # API-FOOTBALL (3.9.3)

 support: [https://dashboard.api-football.com](mailto:https://dashboard.api-football.com)URL: [https://www.api-football.com](https://www.api-football.com/)

 # [section/Introduction](https://www.api-football.com/documentation-v3\#section/Introduction) Introduction

 Welcome to Api-Football! You can use our API to access all API endpoints, which can get information about Football Leagues & Cups.

 We have language bindings in C, C#, cURL, Dart, Go, Java, Javascript, NodeJs, Objective-c, OCaml, Php, PowerShell, Python, Ruby, Shell and Swift! You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

 The update frequency indicated in the documentation is given as an indication and may vary for certain competitions.

 # [section/Authentication](https://www.api-football.com/documentation-v3\#section/Authentication) Authentication

 We uses API keys to allow access to the API. You can register a new API key in our [dashboard](https://dashboard.api-football.com/register).

 The accounts on **RapidAPI** and on our **Dashboard** are dissociated. Each of these registration methods has its own **URL** and **API-KEY**. You must therefore adapt your scripts according to your subscription by adapting the URL and your API-KEY.

 **RAPIDAPI** : [https://api-football-v1.p.rapidapi.com/v3/](https://api-football-v1.p.rapidapi.com/v3/)

 **API-SPORTS** : [https://v3.football.api-sports.io/](https://v3.football.api-sports.io/)

 Our API expects for the API key to be included in all API requests to the server in a header that looks like the following:

 > Make sure to replace `XxXxXxXxXxXxXxXxXxXxXxXx` with your API key.

 **REQUESTS HEADERS & CORS**

 The API is configured to work only with **GET** requests and allows only the headers listed below:

 - `x-rapidapi-host`
 - `x-rapidapi-key`
 - `x-apisports-key`

 If you make non-GET requests or add headers that are not in the list, you will receive an error from the API.

 Some frameworks _(especially in JS, nodeJS..)_ automatically add extra headers, you have to make sure to remove them in order to get a response from the API.

 ## [section/Authentication/API-SPORTS-Account](https://www.api-football.com/documentation-v3\#section/Authentication/API-SPORTS-Account) API-SPORTS Account

 If you decided to subscribe directly on our site, you have a dashboard at your disposal at the following url: [dashboard](https://dashboard.api-football.com/register)

 It allows you to:

 - To follow your consumption in real time
 - Manage your subscription and change it if necessary
 - Check the status of our servers
 - Test all endpoints without writing a line of code.

 You can also consult all this information directly through the API by calling the endpoint `status`.

 > This call does not count against the daily quota.

 ```json
 get("https://v3.football.api-sports.io/status");

 // response
 {
    "get": "status",
    "parameters": [],
    "errors": [],
    "results": 1,
    "response": {
        "account": {
            "firstname": "xxxx",
            "lastname": "XXXXXX",
            "email": "[email protected]"
        },
        "subscription": {
            "plan": "Free",
            "end": "2020-04-10T23:24:27+00:00",
            "active": true
        },
        "requests": {
            "current": 12,
            "limit_day": 100
        }
    }
 }

 ```

 ### Headers sent as response

 When consuming our API, you will always receive the following headers appended to the response:

 - `x-ratelimit-requests-limit`: The number of requests allocated per day according to your subscription.
 - `x-ratelimit-requests-remaining`: The number of remaining requests per day according to your subscription.
 - `X-RateLimit-Limit`: Maximum number of API calls per minute.
 - `X-RateLimit-Remaining`: Number of API calls remaining before reaching the limit per minute.

 ### Dashboard

 ![dashboard](https://www.api-football.com/public/img/news/baseball-dashboard.png)

 ### Requests

 ![requests](https://www.api-football.com/public/img/news/baseball-requests.png)

 ### Live tester

 ![requests](https://www.api-football.com/public/img/news/baseball-live.png)

 ## [section/Authentication/RAPIDAPI-Account](https://www.api-football.com/documentation-v3\#section/Authentication/RAPIDAPI-Account) RAPIDAPI Account

 All information related to your subscription are available on the rapidApi developer dashboard.

 The RapidAPI developer dashboard is where you can see all of your apps, locate API keys, view analytics, and manage billing settings.

 To access the dashboard, simply login to RapidAPI and select 'My Apps' in the top-right menu. Alternatively, you can head directly to [https://rapidapi.com/developer/dashboard](https://rapidapi.com/developer/dashboard).

 In the main dashboard, you will see account-wide analytics and account information. To get more detailed information, you can select tabs on the left-hand side of the screen.

 ### App Specific Analytics

 Using the RapidAPI dashboard, you can also view analytics specific to each app in your account. To do so, switch over to the 'Analytics' tab of your application in the dashboard.

 On the top of the page, you'll be able to see a chart with all the calls being made to all the APIs your app is connected to. You'll also be able to see a log with all the request data. You are also able to filter these analytics to only show certain APIs within the app.

 In each graph, you can view the following metrics:

 - `API Calls`: how many requests are being made
 - `Error rates`: how many requests are error some
 - `Latency`: how long (on average) requests take to execute

 You may change the time period you're looking at by clicking the calendar icon and choosing a time range.

 ### Headers sent as response

 When consuming our API, you will always receive the following headers appended to the response:

 - `server`: The current version of the API proxy used by RapidAPI.
 - `x-ratelimit-requests-limit`: The number of requests the plan you are currently subscribed to allows you to make, before incurring overages.
 - `x-ratelimit-requests-remaining`: The number of requests remaining before you reach the limit of requests your application is allowed to make, before experiencing overage charges.
 - `X-RapidAPI-Proxy-Response`: This header is set to true when the RapidAPI proxy generates the response, (i.e. the response is not generated from our servers)

 # [section/Architecture](https://www.api-football.com/documentation-v3\#section/Architecture) Architecture

 ![image](https://www.api-football.com/public/img/news/archi-beta.jpg)

 # [section/Logos-Images](https://www.api-football.com/documentation-v3\#section/Logos-Images) Logos / Images

 Calls to logos/images do not count towards your daily quota and are provided for free. However these calls are subject to a **rate per second & minute**, it is recommended to save this data on your side in order not to slow down or impact the user experience of your application or website. For this you can use **CDNs** such as [bunny.net](https://bunny.net/?ref=8r6al7jhm4).

 We have a tutorial available [here](https://www.api-football.com/news/post/optimizing-sports-websites-bunnycdn-api-sports-image-storage-guide), which explains how to set up your own media system with **BunnyCDN**.

 Logos, images and trademarks delivered through the API are provided solely for identification and descriptive purposes (e.g., identifying leagues, teams, players or venues). We does not own any of these visual assets, and no intellectual property rights are claimed over them. Some images or data may be subject to intellectual property or trademark rights held by third parties (including but not limited to leagues, federations, or clubs). The use of such content in your applications, websites, or products may require additional authorization or licensing from the respective rights holders. You are fully responsible for ensuring that your usage of any logos, images, or branded content complies with applicable laws in your country or the countries where your services are made available. We are not affiliated with, sponsored by, or endorsed by any sports league, federation, or brand featured in the data provided.

 # [section/Sample-Scripts](https://www.api-football.com/documentation-v3\#section/Sample-Scripts) Sample Scripts

 Here are some examples of how the API is used in the main development languages.

 You have to replace `{endpoint}` by the real name of the endpoint you want to call, like `leagues` or `fixtures` for example. In all the sample scripts we will use the `leagues` endpoint as example.

 Also you will have to replace `XxXxXxXxXxXxXxXxXxXxXx` with your API-KEY provided in the [dashboard](https://dashboard.api-football.com/) or on [rapidapi](https://rapidapi.com/api-sports/api/api-football/pricing).

 ## [section/Sample-Scripts/C](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/C) C

 `libcurl`

 ```shell
 CURL *curl;
 CURLcode res;
 curl = curl_easy_init();
 if(curl) {
  curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
  curl_easy_setopt(curl, CURLOPT_URL, "https://v3.football.api-sports.io/leagues");
  curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
  curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
  struct curl_slist *headers = NULL;
  headers = curl_slist_append(headers, "x-rapidapi-key: XxXxXxXxXxXxXxXxXxXxXxXx");
  headers = curl_slist_append(headers, "x-rapidapi-host: v3.football.api-sports.io");
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  res = curl_easy_perform(curl);
 }
 curl_easy_cleanup(curl);

 ```

 ## [section/Sample-Scripts/C](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/C) C\#

 `RestSharp`

 ```shell
 var client = new RestClient("https://v3.football.api-sports.io/leagues");
 client.Timeout = -1;
 var request = new RestRequest(Method.GET);
 request.AddHeader("x-rapidapi-key", "XxXxXxXxXxXxXxXxXxXxXxXx");
 request.AddHeader("x-rapidapi-host", "v3.football.api-sports.io");
 IRestResponse response = client.Execute(request);
 Console.WriteLine(response.Content);

 ```

 ## [section/Sample-Scripts/cURL](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/cURL) cURL

 `Curl`

 ```shell
 curl --request GET \
    --url https://v3.football.api-sports.io/leagues \
    --header 'x-rapidapi-host: v3.football.api-sports.io' \
    --header 'x-rapidapi-key: XxXxXxXxXxXxXxXxXxXxXxXx'

 ```

 ## [section/Sample-Scripts/Dart](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Dart) Dart

 `http`

 ```dart
 var headers = {
  'x-rapidapi-key': 'XxXxXxXxXxXxXxXxXxXxXxXx',
  'x-rapidapi-host': 'v3.football.api-sports.io'
 };
 var request = http.Request('GET', Uri.parse('https://v3.football.api-sports.io/leagues'));

 request.headers.addAll(headers);

 http.StreamedResponse response = await request.send();

 if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
 }
 else {
  print(response.reasonPhrase);
 }

 ```

 ## [section/Sample-Scripts/Go](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Go) Go

 `Native`

 ```go
 package main

 import (
  "fmt"
  "net/http"
  "io/ioutil"
 )

 func main() {

  url := "https://v3.football.api-sports.io/leagues"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("x-rapidapi-key", "XxXxXxXxXxXxXxXxXxXxXxXx")
  req.Header.Add("x-rapidapi-host", "v3.football.api-sports.io")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
 }

 ```

 ## [section/Sample-Scripts/Java](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Java) Java

 `OkHttp`

 ```java
 var myHeaders = new Headers();
 myHeaders.append("x-rapidapi-key", "XxXxXxXxXxXxXxXxXxXxXxXx");
 myHeaders.append("x-rapidapi-host", "v3.football.api-sports.io");

 var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
 };

 ```

 `Unirest`

 ```java
 Unirest.setTimeouts(0, 0);
 HttpResponse<String> response = Unirest.get("https://v3.football.api-sports.io/leagues")
  .header("x-rapidapi-key", "XxXxXxXxXxXxXxXxXxXxXxXx")
  .header("x-rapidapi-host", "v3.football.api-sports.io")
  .asString();

 ```

 ## [section/Sample-Scripts/Javascript](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Javascript) Javascript

 `Fetch`

 ```javascript
 var myHeaders = new Headers();
 myHeaders.append("x-rapidapi-key", "XxXxXxXxXxXxXxXxXxXxXxXx");
 myHeaders.append("x-rapidapi-host", "v3.football.api-sports.io");

 var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
 };

 fetch("https://v3.football.api-sports.io/leagues", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

 ```

 `jQuery`

 ```javascript
 var settings = {
  "url": "https://v3.football.api-sports.io/leagues",
  "method": "GET",
  "timeout": 0,
  "headers": {
    "x-rapidapi-key": "XxXxXxXxXxXxXxXxXxXxXxXx",
    "x-rapidapi-host": "v3.football.api-sports.io"
  },
 };

 $.ajax(settings).done(function (response) {
  console.log(response);
 });

 ```

 `XHR`

 ```javascript
 var xhr = new XMLHttpRequest();
 xhr.withCredentials = true;

 xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
 });

 xhr.open("GET", "https://v3.football.api-sports.io/leagues");
 xhr.setRequestHeader("x-rapidapi-key", "XxXxXxXxXxXxXxXxXxXxXxXx");
 xhr.setRequestHeader("x-rapidapi-host", "v3.football.api-sports.io");

 xhr.send();

 ```

 ## [section/Sample-Scripts/NodeJs](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/NodeJs) NodeJs

 `Axios`

 ```nodejs
 var axios = require('axios');

 var config = {
  method: 'get',
  url: 'https://v3.football.api-sports.io/leagues',
  headers: {
    'x-rapidapi-key': 'XxXxXxXxXxXxXxXxXxXxXxXx',
    'x-rapidapi-host': 'v3.football.api-sports.io'
  }
 };

 axios(config)
 .then(function (response) {
  console.log(JSON.stringify(response.data));
 })
 .catch(function (error) {
  console.log(error);
 });

 ```

 `Native`

 ```nodejs
 var https = require('follow-redirects').https;
 var fs = require('fs');

 var options = {
  'method': 'GET',
  'hostname': 'v3.football.api-sports.io',
  'path': '/leagues',
  'headers': {
    'x-rapidapi-key': 'XxXxXxXxXxXxXxXxXxXxXxXx',
    'x-rapidapi-host': 'v3.football.api-sports.io'
  },
  'maxRedirects': 20
 };

 var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
 });

 req.end();

 ```

 `Requests`

 ```nodejs
 var request = require('request');
 var options = {
  'method': 'GET',
  'url': 'https://v3.football.api-sports.io/leagues',
  'headers': {
    'x-rapidapi-key': 'XxXxXxXxXxXxXxXxXxXxXxXx',
    'x-rapidapi-host': 'v3.football.api-sports.io'
  }
 };
 request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
 });

 ```

 `Unirest`

 ```nodejs
 var unirest = require('unirest');
 var req = unirest('GET', 'https://v3.football.api-sports.io/leagues')
  .headers({
    'x-rapidapi-key': 'XxXxXxXxXxXxXxXxXxXxXxXx',
    'x-rapidapi-host': 'v3.football.api-sports.io'
  })
  .end(function (res) {
    if (res.error) throw new Error(res.error);
    console.log(res.raw_body);
  });

 ```

 ## [section/Sample-Scripts/Objective-c](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Objective-c) Objective-c

 `NSURLSession`

 ```objectivec
 #import <Foundation/Foundation.h>

 dispatch_semaphore_t sema = dispatch_semaphore_create(0);

 NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://v3.football.api-sports.io/leagues"]\
  cachePolicy:NSURLRequestUseProtocolCachePolicy\
  timeoutInterval:10.0];
 NSDictionary *headers = @{
  @"x-rapidapi-key": @"XxXxXxXxXxXxXxXxXxXxXxXx",
  @"x-rapidapi-host": @"v3.football.api-sports.io"
 };

 [request setAllHTTPHeaderFields:headers];

 [request setHTTPMethod:@"GET"];

 NSURLSession *session = [NSURLSession sharedSession];
 NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request\
 completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {\
  if (error) {\
    NSLog(@"%@", error);\
    dispatch_semaphore_signal(sema);\
  } else {\
    NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;\
    NSError *parseError = nil;\
    NSDictionary *responseDictionary = [NSJSONSerialization JSONObjectWithData:data options:0 error:&parseError];\
    NSLog(@"%@",responseDictionary);\
    dispatch_semaphore_signal(sema);\
  }\
 }];
 [dataTask resume];
 dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);

 ```

 ## [section/Sample-Scripts/OCaml](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/OCaml) OCaml

 `Cohttp`

 ```ocaml
 open Lwt
 open Cohttp
 open Cohttp_lwt_unix

 let reqBody =
  let uri = Uri.of_string "https://v3.football.api-sports.io/leagues" in
  let headers = Header.init ()
    |> fun h -> Header.add h "x-rapidapi-key" "XxXxXxXxXxXxXxXxXxXxXxXx"
    |> fun h -> Header.add h "x-rapidapi-host" "v3.football.api-sports.io"
  in
  Client.call ~headers `GET uri >>= fun (_resp, body) ->
  body |> Cohttp_lwt.Body.to_string >|= fun body -> body

 let () =
  let respBody = Lwt_main.run reqBody in
  print_endline (respBody)

 ```

 ## [section/Sample-Scripts/Php](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Php) Php

 `cURL`

 ```php
 $curl = curl_init();

 curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://v3.football.api-sports.io/leagues',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'x-rapidapi-key: XxXxXxXxXxXxXxXxXxXxXxXx',
    'x-rapidapi-host: v3.football.api-sports.io'
  ),
 ));

 $response = curl_exec($curl);

 curl_close($curl);
 echo $response;

 ```

 `Request2`

 ```php
 <?php
 require_once 'HTTP/Request2.php';
 $request = new HTTP_Request2();
 $request->setUrl('https://v3.football.api-sports.io/leagues');
 $request->setMethod(HTTP_Request2::METHOD_GET);
 $request->setConfig(array(
  'follow_redirects' => TRUE
 ));
 $request->setHeader(array(
  'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx',
  'x-rapidapi-host' => 'v3.football.api-sports.io'
 ));
 try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
 }
 catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
 }

 ```

 `Http`

 ```php
 $client = new http\Client;
 $request = new http\Client\Request;
 $request->setRequestUrl('https://v3.football.api-sports.io/leagues');
 $request->setRequestMethod('GET');
 $request->setHeaders(array(
    'x-rapidapi-host' => 'v3.football.api-sports.io',
    'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx'
 ));
 $client->enqueue($request)->send();
 $response = $client->getResponse();
 echo $response->getBody();

 ```

 ## [section/Sample-Scripts/PowerShell](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/PowerShell) PowerShell

 `RestMethod`

 ```powershell
 $headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
 $headers.Add("x-rapidapi-key", "XxXxXxXxXxXxXxXxXxXxXxXx")
 $headers.Add("x-rapidapi-host", "v3.football.api-sports.io")

 $response = Invoke-RestMethod 'https://v3.football.api-sports.io/leagues' -Method 'GET' -Headers $headers
 $response | ConvertTo-Json

 ```

 ## [section/Sample-Scripts/Python](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Python) Python

 `http.client`

 ```python
 import http.client

 conn = http.client.HTTPSConnection("v3.football.api-sports.io")

 headers = {
    'x-rapidapi-host': "v3.football.api-sports.io",
    'x-rapidapi-key': "XxXxXxXxXxXxXxXxXxXxXxXx"
    }

 conn.request("GET", "/leagues", headers=headers)

 res = conn.getresponse()
 data = res.read()

 print(data.decode("utf-8"))

 ```

 `Requests`

 ```python
 url = "https://v3.football.api-sports.io/leagues"

 payload={}
 headers = {
  'x-rapidapi-key': 'XxXxXxXxXxXxXxXxXxXxXxXx',
  'x-rapidapi-host': 'v3.football.api-sports.io'
 }

 response = requests.request("GET", url, headers=headers, data=payload)

 print(response.text)

 ```

 ## [section/Sample-Scripts/Ruby](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Ruby) Ruby

 `Net::HTTP`

 ```ruby
 require 'uri'
 require 'net/http'
 require 'openssl'

 url = URI("https://v3.football.api-sports.io/leagues")

 http = Net::HTTP.new(url.host, url.port)
 http.use_ssl = true
 http.verify_mode = OpenSSL::SSL::VERIFY_NONE

 request = Net::HTTP::Get.new(url)
 request["x-rapidapi-host"] = 'v3.football.api-sports.io'
 request["x-rapidapi-key"] = 'XxXxXxXxXxXxXxXxXxXxXxXx'

 response = http.request(request)
 puts response.read_body

 ```

 ## [section/Sample-Scripts/Shell](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Shell) Shell

 `Httpie`

 ```shell
 http --follow --timeout 3600 GET 'https://v3.football.api-sports.io/leagues' \
 x-rapidapi-key:'XxXxXxXxXxXxXxXxXxXxXxXx' \
 x-rapidapi-host:'v3.football.api-sports.io'

 ```

 `wget`

 ```shell
 wget --no-check-certificate --quiet \
  --method GET \
  --timeout=0 \
  --header 'x-rapidapi-key: XxXxXxXxXxXxXxXxXxXxXxXx' \
  --header 'x-rapidapi-host: v3.football.api-sports.io' \
   'https://v3.football.api-sports.io/leagues'

 ```

 ## [section/Sample-Scripts/Swift](https://www.api-football.com/documentation-v3\#section/Sample-Scripts/Swift) Swift

 `URLSession`

 ```swift
 import Foundation
 #if canImport(FoundationNetworking)
 import FoundationNetworking
 #endif

 var semaphore = DispatchSemaphore (value: 0)

 var request = URLRequest(url: URL(string: "https://v3.football.api-sports.io/leagues")!,timeoutInterval: Double.infinity)
 request.addValue("XxXxXxXxXxXxXxXxXxXxXxXx", forHTTPHeaderField: "x-rapidapi-key")
 request.addValue("v3.football.api-sports.io", forHTTPHeaderField: "x-rapidapi-host")

 request.httpMethod = "GET"

 let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    semaphore.signal()
    return
  }
  print(String(data: data, encoding: .utf8)!)
  semaphore.signal()
 }

 task.resume()
 semaphore.wait()

 ```

 # [section/Changelog](https://www.api-football.com/documentation-v3\#section/Changelog) Changelog

 ### 3.9.3

 - Add endpoint `players/profiles` that returns the list of all available players

 - Add endpoint `players/teams` that returns the list of teams and seasons in which the player played during his career

 - Endpoint `fixtures`

  - Add field `extra` that returns the additional time played in a half
  - Add field `standings` indicating whether the fixture's competition covers standings (True \| False)
 - Endpoint `fixtures/rounds`

  - Add the `dates` parameter that allows to retrieve the dates of each round in the response
 - Endpoint `fixtures/statistics`

  - Add the `half` parameter that allows to retrieve the halftime statistics in the response
 - Endpoint `injuries`

  - Add the `ids` parameter that allows to retrieve data from several fixtures in one call
 - Endpoint `teams/statistics`, more statistics added

  - Goals Over
  - Goals Under
 - Endpoint `sidelined`

  - Add the `players` and `coachs` parameters that allows to retrieve data from several players/coachs in one call
 - Endpoint `trophies`

  - Add the `players` and `coachs` parameters that allows to retrieve data from several players/coachs in one call

 ### 3.9.2

 - Endpoint `odds`

  - Add endpoint `odds/live`
  - Add endpoint `odds/live/bets`
 - Endpoint `teams`

  - Add parameter `code`
  - Add parameter `venue`
  - Add endpoint `teams/countries`
 - Endpoint `fixtures`

  - Add the `ids` parameter that allows to retrieve data from several fixtures including events, lineups, statistics and players in one Api call
  - Add the Possibility to add several status for the `status` parameter
  - Add parameter `venue`
 - Endpoint `fixtures/headtohead`

  - Add the Possibility to add several status for the `status` parameter
  - Add parameter `venue`

 ### 3.8.1

 - Add endpoint `injuries`
 - Add endpoint `players/squads`
 - Add endpoint `players/topassists`
 - Add endpoint `players/topyellowcards`
 - Add endpoint `players/topredcards`
 - Endpoint `fixtures/lineups`
  - Add players positions on the grid
  - Add players' jerseys colors
 - Endpoint `fixtures/events`
  - add VAR events
 - Endpoint `teams`
  - Add tri-code
 - Endpoint `teams/statistics`, more statistics added
  - Scoring minute
  - Cards per minute
  - Most played formation
  - Penalty statistics
 - Add Coaches Photos

 # [tag/CDN](https://www.api-football.com/documentation-v3\#tag/CDN) CDN

 # [tag/CDN/Optimizing-Sports-Websites-with-BunnyCDN](https://www.api-football.com/documentation-v3\#tag/CDN/Optimizing-Sports-Websites-with-BunnyCDN) Optimizing Sports Websites with BunnyCDN

 **BunnyCDN** is a Content Delivery Network _(CDN)_ that delivers a global content distribution experience. With strategically positioned servers, BunnyCDN ensures swift and reliable delivery of static content, optimizing website performance with features like intelligent image optimization, sophisticated caching, and advanced security measures.

 **Unlocking Media Delivery Excellence with BunnyCDN:**

 - **Quick Configuration:** Set up your media CDN in just 5 minutes. Define cache times, customize your domain – it's that simple.
 - **Global Accessibility:** Leverage BunnyCDN's expansive server network for swift and dependable content delivery worldwide.
 - **Customized Configuration:** Tailor caching, define cache times, and implement CORS headers to create an efficient and seamless user experience.
 - **Own Your Domain:** Personalize your media delivery with your domain, enhancing your brand's online presence.
 - **Robust Security:** BunnyCDN integrates advanced security features, guaranteeing a secure environment for delivering your content.
 - **Responsive Performance:** Experience responsive performance without the need for prior media downloads. Discover the capabilities of BunnyCDN for optimized media delivery.

 A tutorial is available [here](https://www.api-football.com/news/post/optimizing-sports-websites-bunnycdn-api-sports-image-storage-guide) on our blog to help you configure it.

 # [tag/Databases-Solutions](https://www.api-football.com/documentation-v3\#tag/Databases-Solutions) Databases Solutions

 # [tag/Databases-Solutions/Enhance-Your-Data-Management-with-Aiven](https://www.api-football.com/documentation-v3\#tag/Databases-Solutions/Enhance-Your-Data-Management-with-Aiven) Enhance Your Data Management with Aiven

 Integrating databases into your application can greatly enhance data management and storage. If you're looking for high-performing, flexible, and secure database solutions, we recommend checking out [Aiven](https://aiven.io/?utm_source=website&utm_medium=referral&utm_campaign=api_football).

 **Aiven** is a cloud platform that offers a range of managed database services, including relational databases, NoSQL databases, streaming data processing systems, and much more. Their offerings include `PostgreSQL`, `MySQL`, `Cassandra`, `Redis`, `Kafka`, and many other databases, all with simplified management, high availability, and advanced security.

 Moreover, **Aiven** provides a free tier to get started, along with testing credits to explore their offerings. This opportunity allows you to evaluate their platform and determine if it meets your needs.

 One particularly attractive feature of **Aiven** is that they work with multiple cloud providers, including `Google Cloud`, `Amazon Web Services (AWS)`, `Microsoft Azure`, `DigitalOcean`, and more. This means you have the flexibility to choose the best cloud infrastructure for your project.

 In terms of reliability, **Aiven** is committed to providing a **99.99%** Service Level Agreement (SLA), ensuring continuous and highly available service.

 - To test their services, visit [this page](https://console.aiven.io/signup?utm_source=website&utm_medium=referral&utm_campaign=api_football).
 - If you're a developer, explore their [DEV center](https://aiven.io/developer?utm_source=website&utm_medium=referral&utm_campaign=api_football) for technical information.
 - Check out [Aiven's documentation](https://docs.aiven.io/?utm_source=website&utm_medium=referral&utm_campaign=api_football) for detailed information on their services and features.

 By integrating **Aiven** with our API, you can efficiently store, manage, and analyze your data while taking advantage of their cloud database solutions' flexibility and scalability.

 # [tag/Databases-Solutions/Real-Time-Data-Management-with-Firebase](https://www.api-football.com/documentation-v3\#tag/Databases-Solutions/Real-Time-Data-Management-with-Firebase) Real-Time Data Management with Firebase

 When you're looking for a real-time data management solution for your application, [Firebase's Realtime Database](https://firebase.google.com/products/realtime-database/?utm_source=api-football) is a powerful choice. Explore how Firebase can enhance real-time data management for your application.

 [Firebase's Realtime Database](https://firebase.google.com/products/realtime-database/?utm_source=api-football) offers a cloud-based real-time database that synchronizes data in real-time across users and devices. This makes it an ideal choice for applications that require instant data updates.

 **Why Choose Firebase's Realtime Database?**

 - **Real-Time Data:** Firebase allows you to store real-time data, meaning that updates are instantly propagated to all connected users.
 - **Easy Synchronization:** Data is automatically synchronized across all devices, providing a consistent and real-time user experience.
 - **Built-In Security:** Firebase offers flexible security rules to control data access and ensure privacy.
 - **Simplified Integration:** Firebase's Realtime Database easily integrates with other Firebase services, simplifying backend management.

 **Helpful Links:**

 - [Explore Firebase's Realtime Database](https://firebase.google.com/products/realtime-database/): Discover the features and advantages of Firebase's Realtime Database for efficient real-time data management.
 - [Firebase's Realtime Database Documentation](https://firebase.google.com/docs/database/): Refer to the comprehensive documentation for Firebase's Realtime Database for a smooth integration.

 A tutorial describing each step is available on our blog [here](https://www.api-football.com/news/post/how-to-use-firebase-with-api-football-real-time-data-integration).

 # [tag/Widgets](https://www.api-football.com/documentation-v3\#tag/Widgets) Widgets

 Our widgets are completely **free** and work with all our plans including the free plan.

 To integrate the widgets to your site you just have to `copy/paste` the code provided and fill in the tags needed for the widget to work properly.
 If you integrate several widgets on the same page a single theme will be applied for all widgets. Also you will only have to integrate the **script** tag once.

 ### For all widgets the following tags are needed :

 `data-host` : **v3.football.api-sports.io** or **api-football-v1.p.rapidapi.com** depending on whether you have subscribed with us or RapidApi.

 `data-key` : Indicate your API-KEY obtained on our Dashboard or on RapidApi.

 `data-theme` : If you leave the field empty, the **default** theme will be applied, otherwise the possible values are **grey** or **dark**. It is also possible to indicate **false** which will not display any theme and lets you customize the widget with your own css.

 `data-show-errors` : By default **false**, used for debugging, with a value of **true** it allows to display the errors.

 Widgets use the requests associated with your account and therefore they will stop working if your daily limit is reached. You can track all requests made directly in the dashboard.

 ### Security :

 When using these widgets it is important to be aware that your API-KEY will be visible to the users of your site, it is possible to protect yourself from this by allowing only the desired domains in our dashboard.
 This way no one else can use your API-KEY for you. If you have already set up your widget and have not activated this option, you can reset your API-KEY and activate this option after.

 ### Debugging :

 If the widget does not display the requested information, it is possible to set the `data-show-errors` tag to **true** to display error messages directly in the widget and in the console. This can be due to several things like : _(Non-exhaustive list)_

 - You have reached your daily number of requests
 - Tags are incorrectly filled in
 - Your API-KEY is incorrect

 ### Tutorials :

 - [HOW CUSTOM API-FOOTBALL WIDGETS](https://www.api-football.com/tutorials/7/how-custom-api-football-widgets)
 - [HOW TO CHANGE WIDGET ATTRIBUTES DYNAMICALLY](https://www.api-football.com/news/post/how-to-change-widget-attributes-dynamically)
 - [HOW TO ADD TWO WIDGETS ON THE SAME PAGE](https://www.api-football.com/news/post/how-to-add-two-widgets-on-the-same-page)

 ### Changelog :

 #### 2.0.3

 - Merge of `Livescore` and `Fixtures` widgets in `Games` widget
 - Add a date selector in the `Games` widget
 - Add a status selector in the `Games` widget
 - Add a modal to display standings in `games` widget
 - Add the possibility to display or not the logos or images
 - Add widgets for other sports (Baseball, Basketball, Handball, Hockey, Rugby and Volleyball).
 - Rename `Fixture` widget in `Game` widget

 #### 1.1.8

 - Add the widget `Fixture`
 - Add the possibility to load a modal containing the details of a fixture in the widgets `Livescore` and `Fixtures`

 #### 1.0.0

 - Starting version with widgets `Livescore` `Fixtures` and `Standings`

 ### Sources :

 All the sources to make your own CSS can be downloaded here :

 - [2.0.3 files](https://www.api-football.com/public/widgets/2.0.3.zip)
 - [1.1.8 files](https://www.api-football.com/public/widgets/1.1.8.zip)

 ## [tag/Widgets/operation/get-widget-games](https://www.api-football.com/documentation-v3\#tag/Widgets/operation/get-widget-games) Games

 Display the list of matches grouped by competition according to the parameters used.

 The matches are automatically updated according to the selected frequency `data-refresh`.

 > You can find all the leagues ids on our [Dashboard](https://dashboard.api-football.com/soccer/ids).

 > Example of the widget with the default theme
 > ![image](https://www.api-football.com/public/img/demo/widgets/football/wg-games.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | data-host<br>required | string<br>Enum:"v3.football.api-sports.io""api-football-v1.p.rapidapi.com" |
 | data-key<br>required | string<br>Your Api Key |
 | data-refresh | integer >15<br>Number in seconds corresponding to the desired data update frequency. If you indicate **0** or leave this field empty the data will not be updated automatically |
 | data-date | stringYYYY-MM-DD<br>Fill in the desired date. If empty the current date is automatically applied |
 | data-league | integer<br>Fill in the desired league id |
 | data-season | integer = 4 characters YYYY<br>Fill in the desired season |
 | data-theme | string<br>If you leave the field empty, the `default` theme will be applied, otherwise the possible values are `grey` or `dark` |
 | data-show-toolbar | string<br>Enum:truefalse<br>Displays the toolbar allowing to change the view between the current, finished or upcoming fixtures and to change the date |
 | data-show-logos | string<br>Enum:truefalse<br>If `true` display teams logos |
 | data-modal-game | string<br>Enum:truefalse<br>If `true` allows to load a modal containing all the details of the game |
 | data-modal-standings | string<br>Enum:truefalse<br>If `true` allows to load a modal containing the standings |
 | data-modal-show-logos | string<br>Enum:truefalse<br>If `true` display teams logos and players images in the modal |
 | data-show-errors | string<br>Enum:truefalse<br>By default `false`, used for debugging, with a value of `true` it allows to display the errors |

 get/widgets/Games

 API-SPORTS

 https://v3.football.api-sports.io/widgets/Games

 ### Request samples

 - Html

 Copy

 ```
 <div id="wg-api-football-games"
     data-host="v3.football.api-sports.io"
     data-key="Your-Api-Key-Here"
     data-date=""
     data-league=""
     data-season=""
     data-theme=""
     data-refresh="15"
     data-show-toolbar="true"
     data-show-errors="false"
     data-show-logos="true"
     data-modal-game="true"
     data-modal-standings="true"
     data-modal-show-logos="true">
 </div>
 <script
    type="module"
    src="https://widgets.api-sports.io/2.0.3/widgets.js">
 </script>

 ```

 ## [tag/Widgets/operation/get-widget-Game](https://www.api-football.com/documentation-v3\#tag/Widgets/operation/get-widget-Game) Game

 Display a specific fixture as well as **events**, **statistics**, **lineups** and **players statistics** if they are available.

 The fixture is automatically updated according to the selected frequency `data-refresh`.

 > Example of the widget with the default theme
 > ![image](https://www.api-football.com/public/img/demo/widgets/football/wg-game.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | data-host<br>required | string<br>Enum:"v3.football.api-sports.io""api-football-v1.p.rapidapi.com" |
 | data-key<br>required | string<br>Your Api Key |
 | data-refresh | integer >15<br>Number in seconds corresponding to the desired data update frequency. If you indicate **0** or leave this field empty the data will not be updated automatically |
 | data-id | integer<br>Fill in the desired fixture id |
 | data-theme | string<br>If you leave the field empty, the `default` theme will be applied, otherwise the possible values are `grey` or `dark` |
 | data-show-errors | string<br>Enum:truefalse<br>By default `false`, used for debugging, with a value of `true` it allows to display the errors |
 | data-show-logos | string<br>Enum:truefalse<br>If `true` display teams logos and players images |

 get/widgets/game

 API-SPORTS

 https://v3.football.api-sports.io/widgets/game

 ### Request samples

 - Html

 Copy

 ```
 <div id="wg-api-football-game"
    data-host="v3.football.api-sports.io"
    data-key="Your-Api-Key-Here"
    data-id="718243"
    data-theme=""
    data-refresh="15"
    data-show-errors="false"
    data-show-logos="true">
 </div>
 <script
    type="module"
    src="https://widgets.api-sports.io/2.0.3/widgets.js">
 </script>

 ```

 ## [tag/Widgets/operation/get-widget-standings](https://www.api-football.com/documentation-v3\#tag/Widgets/operation/get-widget-standings) Standings

 Display the ranking of a competition or a team according to the parameters used.

 > You can find all the leagues and teams ids on our [Dashboard](https://dashboard.api-football.com/soccer/ids).

 > Example of the widget with the available themes
 > ![image](https://www.api-football.com/public/img/demo/widgets/football/wg-standings.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | data-host<br>required | string<br>Enum:"v3.football.api-sports.io""api-football-v1.p.rapidapi.com" |
 | data-key<br>required | string<br>Your Api Key |
 | data-league | integer<br>Fill in the desired league id |
 | data-team | integer<br>Fill in the desired team id |
 | data-season<br>required | integer = 4 characters YYYY<br>Fill in the desired season |
 | data-theme | string<br>If you leave the field empty, the `default` theme will be applied, otherwise the possible values are `grey` or `dark` |
 | data-show-errors | string<br>Enum:truefalse<br>By default `false`, used for debugging, with a value of `true` it allows to display the errors |
 | data-show-logos | string<br>Enum:truefalse<br>If `true` display teams logos |

 get/widgets/standings

 API-SPORTS

 https://v3.football.api-sports.io/widgets/standings

 ### Request samples

 - Html

 Copy

 ```
 <div id="wg-api-football-standings"
    data-host="v3.football.api-sports.io"
    data-key="Your-Api-Key-Here"
    data-league="39"
    data-team=""
    data-season="2021"
    data-theme=""
    data-show-errors="false"
    data-show-logos="true"
    class="wg_loader">
 </div>
 <script
    type="module"
    src="https://widgets.api-sports.io/2.0.3/widgets.js">
 </script>

 ```

 # [tag/Timezone](https://www.api-football.com/documentation-v3\#tag/Timezone) Timezone

 ## [tag/Timezone/operation/get-timezone](https://www.api-football.com/documentation-v3\#tag/Timezone/operation/get-timezone) Timezone

 Get the list of available timezone to be used in the fixtures endpoint.

 > This endpoint does not require any parameters.

 **Update Frequency** : This endpoint contains all the existing timezone, it is not updated.

 **Recommended Calls** : 1 call when you need.

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/timezone

 API-SPORTS

 https://v3.football.api-sports.io/timezone

 ### Request samples

 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 $client = new http\Client;
 $request = new http\Client\Request;

 $request->setRequestUrl('https://v3.football.api-sports.io/timezone');
 $request->setRequestMethod('GET');
 $request->setHeaders(array(
 	'x-rapidapi-host' => 'v3.football.api-sports.io',
 	'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx'
 ));

 $client->enqueue($request)->send();
 $response = $client->getResponse();

 echo $response->getBody();

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "timezone",
 "parameters": [ ],
 "errors": [ ],
 "results": 425,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 "Africa/Abidjan",\
 "Africa/Accra",\
 "Africa/Addis_Ababa",\
 "Africa/Algiers",\
 "Africa/Asmara"]}`

 # [tag/Countries](https://www.api-football.com/documentation-v3\#tag/Countries) Countries

 ## [tag/Countries/operation/get-countries](https://www.api-football.com/documentation-v3\#tag/Countries/operation/get-countries) Countries

 Get the list of available countries for the `leagues` endpoint.

 The `name` and `code` fields can be used in other endpoints as filters.

 To get the flag of a country you have to call the following url: `https://media.api-sports.io/flags/{country_code}.svg`

 > Examples available in Request samples "Use Cases".

 All the parameters of this endpoint can be used together.

 **Update Frequency** : This endpoint is updated each time a new league from a country not covered by the API is added.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | name | string<br>The name of the country |
 | code | string \[ 2 .. 6 \] characters FR, GB-ENG, IT… <br>The Alpha code of the country |
 | search | string = 3 characters <br>The name of the country |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/countries

 API-SPORTS

 https://v3.football.api-sports.io/countries

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available countries across all {seasons} and competitions
 get("https://v3.football.api-sports.io/countries");

 // Get all available countries from one country {name}
 get("https://v3.football.api-sports.io/countries?name=england");

 // Get all available countries from one country {code}
 get("https://v3.football.api-sports.io/countries?code=fr");

 // Allows you to search for a countries in relation to a country {name}
 get("https://v3.football.api-sports.io/countries?search=engl");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "countries",
 "parameters": {
 "name": "england"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "name": "England",\
 "code": "GB",\
 "flag": "https://media.api-sports.io/flags/gb.svg"}]}`

 # [tag/Leagues](https://www.api-football.com/documentation-v3\#tag/Leagues) Leagues

 ## [tag/Leagues/operation/get-leagues](https://www.api-football.com/documentation-v3\#tag/Leagues/operation/get-leagues) Leagues

 Get the list of available leagues and cups.

 The league `id` are **unique** in the API and leagues keep it across all `seasons`

 To get the logo of a competition you have to call the following url: `https://media.api-sports.io/football/leagues/{league_id}.png`

 This endpoint also returns the `coverage` of each competition, which makes it possible to know what is available for that league or cup.

 The values returned by the coverage indicate the **data available at the moment** you call the API, so for a competition that has not yet started, it is normal to have all the features set to `False`. This will be updated once the competition has started.

 > You can find all the leagues ids on our [Dashboard](https://dashboard.api-football.com/soccer/ids).

 **Example :**

 ```
 "coverage": {
  "fixtures": {
      "events": true,
      "lineups": true,
      "statistics_fixtures": false,
      "statistics_players": false
  },
  "standings": true,
  "players": true,
  "top_scorers": true,
  "top_assists": true,
  "top_cards": true,
  "injuries": true,
  "predictions": true,
  "odds": false
 }

 ```

 In this example we can deduce that the competition does not have the following features: `statistics_fixtures`, `statistics_players`, `odds` because it is set to `False`.

 The coverage of a competition can vary from season to season and values set to `True` do not guarantee 100% data availability.

 Some competitions, such as the `friendlies`, are exceptions to the coverage indicated in the `leagues` endpoint, and the data available may differ depending on the match, including livescore, events, lineups, statistics and players.

 Competitions are automatically renewed by the API when a new season is available. There may be a delay between the announcement of the official calendar and the availability of data in the API.

 For `Cup` competitions, fixtures are automatically added when the two participating teams are known. For example if the current phase is the 8th final, the quarter final will be added once the teams playing this phase are known.

 > Examples available in Request samples "Use Cases".

 > Most of the parameters of this endpoint can be used together.

 **Update Frequency** : This endpoint is updated several times a day.

 **Recommended Calls** : 1 call per hour.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | integer<br>The id of the league |
 | name | string<br>The name of the league |
 | country | string<br>The country name of the league |
 | code | string \[ 2 .. 6 \] characters FR, GB-ENG, IT… <br>The Alpha code of the country |
 | season | integer = 4 characters YYYY<br>The season of the league |
 | team | integer<br>The id of the team |
 | type | string<br>Enum:"league""cup"<br>The type of the league |
 | current | string Return the list of active seasons or the las...Show pattern<br>Enum:"true""false"<br>The state of the league |
 | search | string >= 3 characters <br>The name or the country of the league |
 | last | integer <= 2 characters <br>The X last leagues/cups added in the API |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/leagues

 API-SPORTS

 https://v3.football.api-sports.io/leagues

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Allows to retrieve all the seasons available for a league/cup
 get("https://v3.football.api-sports.io/leagues?id=39");

 // Get all leagues from one league {name}
 get("https://v3.football.api-sports.io/leagues?name=premier league");

 // Get all leagues from one {country}
 // You can find the available {country} by using the endpoint country
 get("https://v3.football.api-sports.io/leagues?country=england");

 // Get all leagues from one country {code} (GB, FR, IT etc..)
 // You can find the available country {code} by using the endpoint country
 get("https://v3.football.api-sports.io/leagues?code=gb");

 // Get all leagues from one {season}
 // You can find the available {season} by using the endpoint seasons
 get("https://v3.football.api-sports.io/leagues?season=2019");

 // Get one league from one league {id} & {season}
 get("https://v3.football.api-sports.io/leagues?season=2019&id=39");

 // Get all leagues in which the {team} has played at least one match
 get("https://v3.football.api-sports.io/leagues?team=33");

 // Allows you to search for a league in relation to a league {name} or {country}
 get("https://v3.football.api-sports.io/leagues?search=premier league");
 get("https://v3.football.api-sports.io/leagues?search=England");

 // Get all leagues from one {type}
 get("https://v3.football.api-sports.io/leagues?type=league");

 // Get all leagues where the season is in progress or not
 get("https://v3.football.api-sports.io/leagues?current=true");

 // Get the last 99 leagues or cups added to the API
 get("https://v3.football.api-sports.io/leagues?last=99");

 // It’s possible to make requests by mixing the available parameters
 get("https://v3.football.api-sports.io/leagues?season=2019&country=england&type=league");
 get("https://v3.football.api-sports.io/leagues?team=85&season=2019");
 get("https://v3.football.api-sports.io/leagues?id=61¤t=true&type=league");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "leagues",
 "parameters": {
 "id": "39"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "league": {\
 "id": 39,\
 "name": "Premier League",\
 "type": "League",\
 "logo": "https://media.api-sports.io/football/leagues/2.png"},\
 "country": {\
 "name": "England",\
 "code": "GB",\
 "flag": "https://media.api-sports.io/flags/gb.svg"},\
 "seasons": [\
 {\
 "year": 2010,\
 "start": "2010-08-14",\
 "end": "2011-05-17",\
 "current": false,\
 "coverage": {\
 "fixtures": {\
 "events": true,\
 "lineups": true,\
 "statistics_fixtures": false,\
 "statistics_players": false},\
 "standings": true,\
 "players": true,\
 "top_scorers": true,\
 "top_assists": true,\
 "top_cards": true,\
 "injuries": true,\
 "predictions": true,\
 "odds": false}},\
 {\
 "year": 2011,\
 "start": "2011-08-13",\
 "end": "2012-05-13",\
 "current": false,\
 "coverage": {\
 "fixtures": {\
 "events": true,\
 "lineups": true,\
 "statistics_fixtures": false,\
 "statistics_players": false},\
 "standings": true,\
 "players": true,\
 "top_scorers": true,\
 "top_assists": true,\
 "top_cards": true,\
 "injuries": true,\
 "predictions": true,\
 "odds": false}}]}]}`

 ## [tag/Leagues/operation/get-seasons](https://www.api-football.com/documentation-v3\#tag/Leagues/operation/get-seasons) Seasons

 Get the list of available seasons.

 All seasons are only **4-digit keys**, so for a league whose season is `2018-2019` like the English Premier League (EPL), the `2018-2019` season in the API will be `2018`.

 All `seasons` can be used in other endpoints as filters.

 > This endpoint does not require any parameters.

 **Update Frequency** : This endpoint is updated each time a new league is added.

 **Recommended Calls** : 1 call per day.

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/leagues/seasons

 API-SPORTS

 https://v3.football.api-sports.io/leagues/seasons

 ### Request samples

 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 $client = new http\Client;
 $request = new http\Client\Request;

 $request->setRequestUrl('https://v3.football.api-sports.io/leagues/seasons');
 $request->setRequestMethod('GET');
 $request->setHeaders(array(
 	'x-rapidapi-host' => 'v3.football.api-sports.io',
 	'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx'
 ));

 $client->enqueue($request)->send();
 $response = $client->getResponse();

 echo $response->getBody();

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "leagues/seasons",
 "parameters": [ ],
 "errors": [ ],
 "results": 12,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 2008,\
 2010,\
 2011,\
 2012,\
 2013,\
 2014,\
 2015,\
 2016,\
 2017,\
 2018,\
 2019,\
 2020]}`

 # [tag/Teams](https://www.api-football.com/documentation-v3\#tag/Teams) Teams

 ## [tag/Teams/operation/get-teams](https://www.api-football.com/documentation-v3\#tag/Teams/operation/get-teams) Teams information

 Get the list of available teams.

 The team `id` are **unique** in the API and teams keep it among all the leagues/cups in which they participate.

 To get the logo of a team you have to call the following url: `https://media.api-sports.io/football/teams/{team_id}.png`

 > You can find all the teams ids on our [Dashboard](https://dashboard.api-football.com/soccer/ids/teams).

 > Examples available in Request samples "Use Cases".

 > All the parameters of this endpoint can be used together.

 **This endpoint requires at least one parameter.**

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 **Tutorials** :

 - [HOW TO GET ALL TEAMS AND PLAYERS FROM A LEAGUE ID](https://www.api-football.com/tutorials/4/how-to-get-all-teams-and-players-from-a-league-id)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | integer<br>The id of the team |
 | name | string<br>The name of the team |
 | league | integer<br>The id of the league |
 | season | integer = 4 characters YYYY<br>The season of the league |
 | country | string<br>The country name of the team |
 | code | string = 3 characters <br>The code of the team |
 | venue | integer<br>The id of the venue |
 | search | string >= 3 characters <br>The name or the country name of the team |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/teams

 API-SPORTS

 https://v3.football.api-sports.io/teams

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get one team from one team {id}
 get("https://v3.football.api-sports.io/teams?id=33");

 // Get one team from one team {name}
 get("https://v3.football.api-sports.io/teams?name=manchester united");

 // Get all teams from one {league} & {season}
 get("https://v3.football.api-sports.io/teams?league=39&season=2019");

 // Get teams from one team {country}
 get("https://v3.football.api-sports.io/teams?country=england");

 // Get teams from one team {code}
 get("https://v3.football.api-sports.io/teams?code=FRA");

 // Get teams from one venue {id}
 get("https://v3.football.api-sports.io/teams?venue=789");

 // Allows you to search for a team in relation to a team {name} or {country}
 get("https://v3.football.api-sports.io/teams?search=manches");
 get("https://v3.football.api-sports.io/teams?search=England");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "teams",
 "parameters": {
 "id": "33"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "team": {\
 "id": 33,\
 "name": "Manchester United",\
 "code": "MUN",\
 "country": "England",\
 "founded": 1878,\
 "national": false,\
 "logo": "https://media.api-sports.io/football/teams/33.png"},\
 "venue": {\
 "id": 556,\
 "name": "Old Trafford",\
 "address": "Sir Matt Busby Way",\
 "city": "Manchester",\
 "capacity": 76212,\
 "surface": "grass",\
 "image": "https://media.api-sports.io/football/venues/556.png"}}]}`

 ## [tag/Teams/operation/get-teams-statistics](https://www.api-football.com/documentation-v3\#tag/Teams/operation/get-teams-statistics) Teams statistics

 Returns the statistics of a team in relation to a given competition and season.

 It is possible to add the `date` parameter to calculate statistics from the beginning of the season to the given date. By default the API returns the statistics of all games played by the team for the competition and the season.

 **Update Frequency** : This endpoint is updated twice a day.

 **Recommended Calls** : 1 call per day for the teams who have at least one fixture during the day otherwise 1 call per week.

 > Here is an example of what can be achieved

 ![demo-teams-statistics](https://www.api-football.com/public/img/demo/demo-teams-statistics.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | league<br>required | integer<br>The id of the league |
 | season<br>required | integer = 4 characters YYYY<br>The season of the league |
 | team<br>required | integer<br>The id of the team |
 | date | stringYYYY-MM-DD<br>The limit date |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/teams/statistics

 API-SPORTS

 https://v3.football.api-sports.io/teams/statistics

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all statistics for a {team} in a {league} & {season}
 get("https://v3.football.api-sports.io/teams/statistics?league=39&team=33&season=2019");

 //Get all statistics for a {team} in a {league} & {season} with a end {date}
 get("https://v3.football.api-sports.io/teams/statistics?league=39&team=33&season=2019&date=2019-10-08");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "teams/statistics",
 "parameters": {
 "league": "39",
 "season": "2019",
 "team": "33"},
 "errors": [ ],
 "results": 11,
 "paging": {
 "current": 1,
 "total": 1},
 "response": {
 "league": {
 "id": 39,
 "name": "Premier League",
 "country": "England",
 "logo": "https://media.api-sports.io/football/leagues/39.png",
 "flag": "https://media.api-sports.io/flags/gb-eng.svg",
 "season": 2019},
 "team": {
 "id": 33,
 "name": "Manchester United",
 "logo": "https://media.api-sports.io/football/teams/33.png"},
 "form": "WDLDWLDLDWLWDDWWDLWWLWLLDWWDWDWWWWDWDW",
 "fixtures": {
 "played": {
 "home": 19,
 "away": 19,
 "total": 38},
 "wins": {
 "home": 10,
 "away": 8,
 "total": 18},
 "draws": {
 "home": 7,
 "away": 5,
 "total": 12},
 "loses": {
 "home": 2,
 "away": 6,
 "total": 8}},
 "goals": {
 "for": {
 "total": {
 "home": 40,
 "away": 26,
 "total": 66},
 "average": {
 "home": "2.1",
 "away": "1.4",
 "total": "1.7"},
 "minute": {
 "0-15": {
 "total": 4,
 "percentage": "6.06%"},
 "16-30": {
 "total": 17,
 "percentage": "25.76%"},
 "31-45": {
 "total": 11,
 "percentage": "16.67%"},
 "46-60": {
 "total": 13,
 "percentage": "19.70%"},
 "61-75": {
 "total": 10,
 "percentage": "15.15%"},
 "76-90": {
 "total": 8,
 "percentage": "12.12%"},
 "91-105": {
 "total": 3,
 "percentage": "4.55%"},
 "106-120": {
 "total": null,
 "percentage": null}},
 "under_over": {
 "0.5": {
 "over": 30,
 "under": 8},
 "1.5": {
 "over": 20,
 "under": 18},
 "2.5": {
 "over": 11,
 "under": 27},
 "3.5": {
 "over": 4,
 "under": 34},
 "4.5": {
 "over": 1,
 "under": 37}}},
 "against": {
 "total": {
 "home": 17,
 "away": 19,
 "total": 36},
 "average": {
 "home": "0.9",
 "away": "1.0",
 "total": "0.9"},
 "minute": {
 "0-15": {
 "total": 6,
 "percentage": "16.67%"},
 "16-30": {
 "total": 3,
 "percentage": "8.33%"},
 "31-45": {
 "total": 7,
 "percentage": "19.44%"},
 "46-60": {
 "total": 9,
 "percentage": "25.00%"},
 "61-75": {
 "total": 3,
 "percentage": "8.33%"},
 "76-90": {
 "total": 5,
 "percentage": "13.89%"},
 "91-105": {
 "total": 3,
 "percentage": "8.33%"},
 "106-120": {
 "total": null,
 "percentage": null}},
 "under_over": {
 "0.5": {
 "over": 25,
 "under": 13},
 "1.5": {
 "over": 10,
 "under": 28},
 "2.5": {
 "over": 1,
 "under": 37},
 "3.5": {
 "over": 0,
 "under": 38},
 "4.5": {
 "over": 0,
 "under": 38}}}},
 "biggest": {
 "streak": {
 "wins": 4,
 "draws": 2,
 "loses": 2},
 "wins": {
 "home": "4-0",
 "away": "0-3"},
 "loses": {
 "home": "0-2",
 "away": "2-0"},
 "goals": {
 "for": {
 "home": 5,
 "away": 3},
 "against": {
 "home": 2,
 "away": 3}}},
 "clean_sheet": {
 "home": 7,
 "away": 6,
 "total": 13},
 "failed_to_score": {
 "home": 2,
 "away": 6,
 "total": 8},
 "penalty": {
 "scored": {
 "total": 10,
 "percentage": "100.00%"},
 "missed": {
 "total": 0,
 "percentage": "0%"},
 "total": 10},
 "lineups": [\
 {\
 "formation": "4-2-3-1",\
 "played": 32},\
 {\
 "formation": "3-4-1-2",\
 "played": 4},\
 {\
 "formation": "3-4-2-1",\
 "played": 1},\
 {\
 "formation": "4-3-1-2",\
 "played": 1}],
 "cards": {
 "yellow": {
 "0-15": {
 "total": 5,
 "percentage": "6.85%"},
 "16-30": {
 "total": 5,
 "percentage": "6.85%"},
 "31-45": {
 "total": 16,
 "percentage": "21.92%"},
 "46-60": {
 "total": 12,
 "percentage": "16.44%"},
 "61-75": {
 "total": 14,
 "percentage": "19.18%"},
 "76-90": {
 "total": 21,
 "percentage": "28.77%"},
 "91-105": {
 "total": null,
 "percentage": null},
 "106-120": {
 "total": null,
 "percentage": null}},
 "red": {
 "0-15": {
 "total": null,
 "percentage": null},
 "16-30": {
 "total": null,
 "percentage": null},
 "31-45": {
 "total": null,
 "percentage": null},
 "46-60": {
 "total": null,
 "percentage": null},
 "61-75": {
 "total": null,
 "percentage": null},
 "76-90": {
 "total": null,
 "percentage": null},
 "91-105": {
 "total": null,
 "percentage": null},
 "106-120": {
 "total": null,
 "percentage": null}}}}}`

 ## [tag/Teams/operation/get-teams-seasons](https://www.api-football.com/documentation-v3\#tag/Teams/operation/get-teams-seasons) Teams seasons

 Get the list of seasons available for a team.

 > Examples available in Request samples "Use Cases".

 **This endpoint requires at least one parameter.**

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | team<br>required | integer<br>The id of the team |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/teams/seasons

 API-SPORTS

 https://v3.football.api-sports.io/teams/seasons

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all seasons available for a team from one team {id}
 get("https://v3.football.api-sports.io/teams/seasons?team=33");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "teams/seasons",
 "parameters": {
 "team": "33"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 2010,\
 2011,\
 2012,\
 2013,\
 2014,\
 2015,\
 2016,\
 2017,\
 2018,\
 2019,\
 2020,\
 2021]}`

 ## [tag/Teams/operation/get-teams-countries](https://www.api-football.com/documentation-v3\#tag/Teams/operation/get-teams-countries) Teams countries

 Get the list of countries available for the `teams` endpoint.

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/teams/countries

 API-SPORTS

 https://v3.football.api-sports.io/teams/countries

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all countries available for the teams endpoints
 get("https://v3.football.api-sports.io/teams/countries");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "teams/countries",
 "parameters": [ ],
 "errors": [ ],
 "results": 258,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "name": "England",\
 "code": "GB",\
 "flag": "https://media.api-sports.io/flags/gb.svg"}]}`

 # [tag/Venues](https://www.api-football.com/documentation-v3\#tag/Venues) Venues

 ## [tag/Venues/operation/get-venues](https://www.api-football.com/documentation-v3\#tag/Venues/operation/get-venues) Venues

 Get the list of available venues.

 The venue `id` are **unique** in the API.

 To get the image of a venue you have to call the following url: `https://media.api-sports.io/football/venues/{venue_id}.png`

 > Examples available in Request samples "Use Cases".

 > All the parameters of this endpoint can be used together.

 **This endpoint requires at least one parameter.**

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | integer<br>The id of the venue |
 | name | string<br>The name of the venue |
 | city | string<br>The city of the venue |
 | country | string<br>The country name of the venue |
 | search | string >= 3 characters <br>The name, city or the country of the venue |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/venues

 API-SPORTS

 https://v3.football.api-sports.io/venues

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get one venue from venue {id}
 get("https://v3.football.api-sports.io/venues?id=556");

 // Get one venue from venue {name}
 get("https://v3.football.api-sports.io/venues?name=Old Trafford");

 // Get all venues from {city}
 get("https://v3.football.api-sports.io/venues?city=manchester");

 // Get venues from {country}
 get("https://v3.football.api-sports.io/venues?country=england");

 // Allows you to search for a venues in relation to a venue {name}, {city} or {country}
 get("https://v3.football.api-sports.io/venues?search=trafford");
 get("https://v3.football.api-sports.io/venues?search=manches");
 get("https://v3.football.api-sports.io/venues?search=England");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "venues",
 "parameters": {
 "id": "556"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "id": 556,\
 "name": "Old Trafford",\
 "address": "Sir Matt Busby Way",\
 "city": "Manchester",\
 "country": "England",\
 "capacity": 76212,\
 "surface": "grass",\
 "image": "https://media.api-sports.io/football/venues/556.png"}]}`

 # [tag/Standings](https://www.api-football.com/documentation-v3\#tag/Standings) Standings

 ## [tag/Standings/operation/get-standings](https://www.api-football.com/documentation-v3\#tag/Standings/operation/get-standings) Standings

 Get the standings for a league or a team.

 Return a table of one or more rankings according to the league / cup.

 Some competitions have several rankings in a year, group phase, opening ranking, closing ranking etc…

 > Examples available in Request samples "Use Cases".

 > Most of the parameters of this endpoint can be used together.

 **Update Frequency** : This endpoint is updated every hour.

 **Recommended Calls** : 1 call per hour for the leagues or teams who have at least one fixture in progress otherwise 1 call per day.

 **Tutorials** :

 - [HOW TO GET STANDINGS FOR ALL CURRENT SEASONS](https://www.api-football.com/tutorials/6/how-to-get-standings-for-all-current-seasons)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | league | integer<br>The id of the league |
 | season<br>required | integer = 4 characters YYYY<br>The season of the league |
 | team | integer<br>The id of the team |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/standings

 API-SPORTS

 https://v3.football.api-sports.io/standings

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all Standings from one {league} & {season}
 get("https://v3.football.api-sports.io/standings?league=39&season=2019");

 // Get all Standings from one {league} & {season} & {team}
 get("https://v3.football.api-sports.io/standings?league=39&team=33&season=2019");

 // Get all Standings from one {team} & {season}
 get("https://v3.football.api-sports.io/standings?team=33&season=2019");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "standings",
 "parameters": {
 "league": "39",
 "season": "2019"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "league": {\
 "id": 39,\
 "name": "Premier League",\
 "country": "England",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": "https://media.api-sports.io/flags/gb.svg",\
 "season": 2019,\
 "standings": [\
 [\
 {\
 "rank": 1,\
 "team": {\
 "id": 40,\
 "name": "Liverpool",\
 "logo": "https://media.api-sports.io/football/teams/40.png"},\
 "points": 70,\
 "goalsDiff": 41,\
 "group": "Premier League",\
 "form": "WWWWW",\
 "status": "same",\
 "description": "Promotion - Champions League (Group Stage)",\
 "all": {\
 "played": 24,\
 "win": 23,\
 "draw": 1,\
 "lose": 0,\
 "goals": {\
 "for": 56,\
 "against": 15}},\
 "home": {\
 "played": 12,\
 "win": 12,\
 "draw": 0,\
 "lose": 0,\
 "goals": {\
 "for": 31,\
 "against": 9}},\
 "away": {\
 "played": 12,\
 "win": 11,\
 "draw": 1,\
 "lose": 0,\
 "goals": {\
 "for": 25,\
 "against": 6}},\
 "update": "2020-01-29T00:00:00+00:00"}]]}}]}`

 # [tag/Fixtures](https://www.api-football.com/documentation-v3\#tag/Fixtures) Fixtures

 ## [tag/Fixtures/operation/get-fixtures-rounds](https://www.api-football.com/documentation-v3\#tag/Fixtures/operation/get-fixtures-rounds) Rounds

 Get the rounds for a league or a cup.

 The `round` can be used in endpoint fixtures as filters

 > Examples available in Request samples "Use Cases".

 **Update Frequency** : This endpoint is updated every day.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | league<br>required | integer<br>The id of the league |
 | season<br>required | integer = 4 characters YYYY<br>The season of the league |
 | current | boolean<br>Enum:"true""false"<br>The current round only |
 | dates | boolean<br>Default: false<br>Enum:"true""false"<br>Add the dates of each round in the response |
 | timezone | string<br>A valid timezone from the endpoint `Timezone` |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/fixtures/rounds

 API-SPORTS

 https://v3.football.api-sports.io/fixtures/rounds

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available rounds from one {league} & {season}
 get("https://v3.football.api-sports.io/fixtures/rounds?league=39&season=2019");

 // Get all available rounds from one {league} & {season} With the dates of each round
 get("https://v3.football.api-sports.io/fixtures/rounds?league=39&season=2019&dates=true");

 // Get current round from one {league} & {season}
 get("https://v3.football.api-sports.io/fixtures/rounds?league=39&season=2019&current=true");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Example

 DefaultWith dates parameterDefault

 Copy
 Expand all  Collapse all

 `{
 "get": "fixtures/rounds",
 "parameters": {
 "league": "39",
 "season": "2019"},
 "errors": [ ],
 "results": 38,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 "Regular Season - 1",\
 "Regular Season - 2",\
 "Regular Season - 3",\
 "Regular Season - 4",\
 "Regular Season - 5",\
 "Regular Season - 6",\
 "Regular Season - 7",\
 "Regular Season - 8",\
 "Regular Season - 9",\
 "Regular Season - 10",\
 "Regular Season - 11",\
 "Regular Season - 12",\
 "Regular Season - 13",\
 "Regular Season - 14",\
 "Regular Season - 15",\
 "Regular Season - 16",\
 "Regular Season - 17",\
 "Regular Season - 18",\
 "Regular Season - 18",\
 "Regular Season - 19",\
 "Regular Season - 20",\
 "Regular Season - 21",\
 "Regular Season - 22",\
 "Regular Season - 23",\
 "Regular Season - 24",\
 "Regular Season - 25",\
 "Regular Season - 26",\
 "Regular Season - 27",\
 "Regular Season - 28",\
 "Regular Season - 29",\
 "Regular Season - 30",\
 "Regular Season - 31",\
 "Regular Season - 32",\
 "Regular Season - 33",\
 "Regular Season - 34",\
 "Regular Season - 35",\
 "Regular Season - 36",\
 "Regular Season - 37",\
 "Regular Season - 38"]}`

 ## [tag/Fixtures/operation/get-fixtures](https://www.api-football.com/documentation-v3\#tag/Fixtures/operation/get-fixtures) Fixtures

 For all requests to fixtures you can add the query parameter `timezone` to your request in order to retrieve the list of matches in the time zone of your choice like _“Europe/London“_

 To know the list of available time zones you have to use the endpoint timezone.

 **Available fixtures status**

 | SHORT | LONG | TYPE | DESCRIPTION |
 | --- | --- | --- | --- |
 | TBD | Time To Be Defined | Scheduled | Scheduled but date and time are not known |
 | NS | Not Started | Scheduled |  |
 | 1H | First Half, Kick Off | In Play | First half in play |
 | HT | Halftime | In Play | Finished in the regular time |
 | 2H | Second Half, 2nd Half Started | In Play | Second half in play |
 | ET | Extra Time | In Play | Extra time in play |
 | BT | Break Time | In Play | Break during extra time |
 | P | Penalty In Progress | In Play | Penaly played after extra time |
 | SUSP | Match Suspended | In Play | Suspended by referee's decision, may be rescheduled another day |
 | INT | Match Interrupted | In Play | Interrupted by referee's decision, should resume in a few minutes |
 | FT | Match Finished | Finished | Finished in the regular time |
 | AET | Match Finished | Finished | Finished after extra time without going to the penalty shootout |
 | PEN | Match Finished | Finished | Finished after the penalty shootout |
 | PST | Match Postponed | Postponed | Postponed to another day, once the new date and time is known the status will change to Not Started |
 | CANC | Match Cancelled | Cancelled | Cancelled, match will not be played |
 | ABD | Match Abandoned | Abandoned | Abandoned for various reasons (Bad Weather, Safety, Floodlights, Playing Staff Or Referees), Can be rescheduled or not, it depends on the competition |
 | AWD | Technical Loss | Not Played |  |
 | WO | WalkOver | Not Played | Victory by forfeit or absence of competitor |
 | LIVE | In Progress | In Play | Used in very rare cases. It indicates a fixture in progress but the data indicating the half-time or elapsed time are not available |

 Fixtures with the status `TBD` may indicate an incorrect fixture date or time because the fixture date or time is not yet known or final. Fixtures with this status are checked and updated daily. The same applies to fixtures with the status `PST`, `CANC`.

 The fixtures ids are unique and specific to each fixture. In no case an `ID` will change.

 Not all competitions have livescore available and only have `final result`. In this case, the status remains in `NS` and will be updated in the minutes/hours following the match (this can take up to 48 hours, depending on the competition).

 > Although the data is updated every 15 seconds, depending on the competition there may be a delay between reality and the availability of data in the API.

 **Update Frequency** : This endpoint is updated every 15 seconds.

 **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day.

 > Here are several examples of what can be achieved

 ![demo-fixtures](https://www.api-football.com/public/img/demo/demo-fixtures.jpg)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | integer<br>Value:"id"<br>The id of the fixture |
 | ids | stringMaximum of 20 fixtures ids<br>Value:"id-id-id"<br>One or more fixture ids |
 | live | string<br>Enum:"all""id-id"<br>All or several leagues ids |
 | date | stringYYYY-MM-DD<br>A valid date |
 | league | integer<br>The id of the league |
 | season | integer = 4 characters YYYY<br>The season of the league |
 | team | integer<br>The id of the team |
 | last | integer <= 2 characters <br>For the X last fixtures |
 | next | integer <= 2 characters <br>For the X next fixtures |
 | from | stringYYYY-MM-DD<br>A valid date |
 | to | stringYYYY-MM-DD<br>A valid date |
 | round | string<br>The round of the fixture |
 | status | string<br>Enum:"NS""NS-PST-FT"<br>One or more fixture status short |
 | venue | integer<br>The venue id of the fixture |
 | timezone | string<br>A valid timezone from the endpoint `Timezone` |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/fixtures

 API-SPORTS

 https://v3.football.api-sports.io/fixtures

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get fixture from one fixture {id}
 // In this request events, lineups, statistics fixture and players fixture are returned in the response
 get("https://v3.football.api-sports.io/fixtures?id=215662");

 // Get fixture from severals fixtures {ids}
 // In this request events, lineups, statistics fixture and players fixture are returned in the response
 get("https://v3.football.api-sports.io/fixtures?ids=215662-215663-215664-215665-215666-215667");

 // Get all available fixtures in play
 // In this request events are returned in the response
 get("https://v3.football.api-sports.io/fixtures?live=all");

 // Get all available fixtures in play filter by several {league}
 // In this request events are returned in the response
 get("https://v3.football.api-sports.io/fixtures?live=39-61-48");

 // Get all available fixtures from one {league} & {season}
 get("https://v3.football.api-sports.io/fixtures?league=39&season=2019");

 // Get all available fixtures from one {date}
 get("https://v3.football.api-sports.io/fixtures?date=2019-10-22");

 // Get next X available fixtures
 get("https://v3.football.api-sports.io/fixtures?next=15");

 // Get last X available fixtures
 get("https://v3.football.api-sports.io/fixtures?last=15");

 // It’s possible to make requests by mixing the available parameters
 get("https://v3.football.api-sports.io/fixtures?date=2020-01-30&league=61&season=2019");
 get("https://v3.football.api-sports.io/fixtures?league=61&next=10");
 get("https://v3.football.api-sports.io/fixtures?venue=358&next=10");
 get("https://v3.football.api-sports.io/fixtures?league=61&last=10&status=ft");
 get("https://v3.football.api-sports.io/fixtures?team=85&last=10&timezone=Europe/london");
 get("https://v3.football.api-sports.io/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31");
 get("https://v3.football.api-sports.io/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london");
 get("https://v3.football.api-sports.io/fixtures?league=61&season=2019&round=Regular Season - 1");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "fixtures",
 "parameters": {
 "live": "all"},
 "errors": [ ],
 "results": 4,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "fixture": {\
 "id": 239625,\
 "referee": null,\
 "timezone": "UTC",\
 "date": "2020-02-06T14:00:00+00:00",\
 "timestamp": 1580997600,\
 "periods": {\
 "first": 1580997600,\
 "second": null},\
 "venue": {\
 "id": 1887,\
 "name": "Stade Municipal",\
 "city": "Oued Zem"},\
 "status": {\
 "long": "Halftime",\
 "short": "HT",\
 "elapsed": 45,\
 "extra": null}},\
 "league": {\
 "id": 200,\
 "name": "Botola Pro",\
 "country": "Morocco",\
 "logo": "https://media.api-sports.io/football/leagues/115.png",\
 "flag": "https://media.api-sports.io/flags/ma.svg",\
 "season": 2019,\
 "round": "Regular Season - 14"},\
 "teams": {\
 "home": {\
 "id": 967,\
 "name": "Rapide Oued ZEM",\
 "logo": "https://media.api-sports.io/football/teams/967.png",\
 "winner": false},\
 "away": {\
 "id": 968,\
 "name": "Wydad AC",\
 "logo": "https://media.api-sports.io/football/teams/968.png",\
 "winner": true}},\
 "goals": {\
 "home": 0,\
 "away": 1},\
 "score": {\
 "halftime": {\
 "home": 0,\
 "away": 1},\
 "fulltime": {\
 "home": null,\
 "away": null},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}}]}`

 ## [tag/Fixtures/operation/get-fixtures-headtohead](https://www.api-football.com/documentation-v3\#tag/Fixtures/operation/get-fixtures-headtohead) Head To Head

 Get heads to heads between two teams.

 **Update Frequency** : This endpoint is updated every 15 seconds.

 **Recommended Calls** : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day.

 > Here is an example of what can be achieved

 ![demo-h2h](https://www.api-football.com/public/img/demo/demo-h2h.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | h2h<br>required | stringID-ID<br>The ids of the teams |
 | date | stringYYYY-MM-DD |
 | league | integer<br>The id of the league |
 | season | integer = 4 characters YYYY<br>The season of the league |
 | last | integer<br>For the X last fixtures |
 | next | integer<br>For the X next fixtures |
 | from | stringYYYY-MM-DD |
 | to | stringYYYY-MM-DD |
 | status | string<br>Enum:"NS""NS-PST-FT"<br>One or more fixture status short |
 | venue | integer<br>The venue id of the fixture |
 | timezone | string<br>A valid timezone from the endpoint `Timezone` |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/fixtures/headtohead

 API-SPORTS

 https://v3.football.api-sports.io/fixtures/headtohead

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all head to head between two {team}
 get("https://v3.football.api-sports.io/fixtures/headtohead?h2h=33-34");

 // It’s possible to make requests by mixing the available parameters
 get("https://v3.football.api-sports.io/fixtures/headtohead?h2h=33-34");
 get("https://v3.football.api-sports.io/fixtures/headtohead?h2h=33-34&status=ns");
 get("https://v3.football.api-sports.io/fixtures/headtohead?h2h=33-34&from=2019-10-01&to=2019-10-31");
 get("https://v3.football.api-sports.io/fixtures/headtohead?date=2019-10-22&h2h=33-34");
 get("https://v3.football.api-sports.io/fixtures/headtohead?league=39&season=2019&h2h=33-34&last=5");
 get("https://v3.football.api-sports.io/fixtures/headtohead?league=39&season=2019&h2h=33-34&next=10&from=2019-10-01&to=2019-10-31");
 get("https://v3.football.api-sports.io/fixtures/headtohead?league=39&season=2019&h2h=33-34&last=5&timezone=Europe/London");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "fixtures/headtohead",
 "parameters": {
 "h2h": "33-34",
 "last": "1"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "fixture": {\
 "id": 157201,\
 "referee": "Kevin Friend, England",\
 "timezone": "UTC",\
 "date": "2019-12-26T17:30:00+00:00",\
 "timestamp": 1577381400,\
 "periods": {\
 "first": 1577381400,\
 "second": 1577385000},\
 "venue": {\
 "id": 556,\
 "name": "Old Trafford",\
 "city": "Manchester"},\
 "status": {\
 "long": "Match Finished",\
 "short": "FT",\
 "elapsed": 90,\
 "extra": null}},\
 "league": {\
 "id": 39,\
 "name": "Premier League",\
 "country": "England",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": "https://media.api-sports.io/flags/gb.svg",\
 "season": 2019,\
 "round": "Regular Season - 19"},\
 "teams": {\
 "home": {\
 "id": 33,\
 "name": "Manchester United",\
 "logo": "https://media.api-sports.io/football/teams/33.png",\
 "winner": true},\
 "away": {\
 "id": 34,\
 "name": "Newcastle",\
 "logo": "https://media.api-sports.io/football/teams/34.png",\
 "winner": false}},\
 "goals": {\
 "home": 4,\
 "away": 1},\
 "score": {\
 "halftime": {\
 "home": 3,\
 "away": 1},\
 "fulltime": {\
 "home": 4,\
 "away": 1},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}}]}`

 ## [tag/Fixtures/operation/get-fixtures-statistics](https://www.api-football.com/documentation-v3\#tag/Fixtures/operation/get-fixtures-statistics) Statistics

 Get the statistics for one fixture.

 **Available statistics**

 - Shots on Goal
 - Shots off Goal
 - Shots insidebox
 - Shots outsidebox
 - Total Shots
 - Blocked Shots
 - Fouls
 - Corner Kicks
 - Offsides
 - Ball Possession
 - Yellow Cards
 - Red Cards
 - Goalkeeper Saves
 - Total passes
 - Passes accurate
 - Passes %

 **Update Frequency** : This endpoint is updated every minute.

 **Recommended Calls** : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day.

 > Here is an example of what can be achieved

 ![demo-statistics](https://www.api-football.com/public/img/demo/demo-statistics.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | fixture<br>required | integer<br>The id of the fixture |
 | team | integer<br>The id of the team |
 | type | string<br>The type of statistics |
 | half | boolean<br>Default: false<br>Enum:"true""false"<br>Add the halftime statistics in the response `Data start from 2024 season for half parameter` |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/fixtures/statistics

 API-SPORTS

 https://v3.football.api-sports.io/fixtures/statistics

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available statistics from one {fixture}
 get("https://v3.football.api-sports.io/fixtures/statistics?fixture=215662");

 // Get all available statistics from one {fixture} with Fulltime, First & Second Half data
 get("https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&half=true");

 // Get all available statistics from one {fixture} & {type}
 get("https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots");

 // Get all available statistics from one {fixture} & {team}
 get("https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Example

 DefaultWith half parameterDefault

 Copy
 Expand all  Collapse all

 `{
 "get": "fixtures/statistics",
 "parameters": {
 "team": "463",
 "fixture": "215662"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "statistics": [\
 {\
 "type": "Shots on Goal",\
 "value": 3},\
 {\
 "type": "Shots off Goal",\
 "value": 2},\
 {\
 "type": "Total Shots",\
 "value": 9},\
 {\
 "type": "Blocked Shots",\
 "value": 4},\
 {\
 "type": "Shots insidebox",\
 "value": 4},\
 {\
 "type": "Shots outsidebox",\
 "value": 5},\
 {\
 "type": "Fouls",\
 "value": 22},\
 {\
 "type": "Corner Kicks",\
 "value": 3},\
 {\
 "type": "Offsides",\
 "value": 1},\
 {\
 "type": "Ball Possession",\
 "value": "32%"},\
 {\
 "type": "Yellow Cards",\
 "value": 5},\
 {\
 "type": "Red Cards",\
 "value": 1},\
 {\
 "type": "Goalkeeper Saves",\
 "value": null},\
 {\
 "type": "Total passes",\
 "value": 242},\
 {\
 "type": "Passes accurate",\
 "value": 121},\
 {\
 "type": "Passes %",\
 "value": null}]}]}`

 ## [tag/Fixtures/operation/get-fixtures-events](https://www.api-football.com/documentation-v3\#tag/Fixtures/operation/get-fixtures-events) Events

 Get the events from a fixture.

 **Available events**

 | TYPE |  |  |  |  |
 | --- | --- | --- | --- | --- |
 | Goal | Normal Goal | Own Goal | Penalty | Missed Penalty |
 | Card | Yellow Card | Red card |  |  |
 | Subst | Substitution \[1, 2, 3...\] |  |  |  |
 | Var | Goal cancelled | Penalty confirmed |  |  |

 - _VAR events are available from the 2020-2021 season._

 **Update Frequency** : This endpoint is updated every 15 seconds.

 **Recommended Calls** : 1 call per minute for the fixtures in progress otherwise 1 call per day.

 You can also retrieve all the events of the fixtures in progress with to the endpoint `fixtures?live=all`

 > Here is an example of what can be achieved

 ![demo-events](https://www.api-football.com/public/img/demo/demo-events.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | fixture<br>required | integer<br>The id of the fixture |
 | team | integer<br>The id of the team |
 | player | integer<br>The id of the player |
 | type | string<br>The type |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/fixtures/events

 API-SPORTS

 https://v3.football.api-sports.io/fixtures/events

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available events from one {fixture}
 get("https://v3.football.api-sports.io/fixtures/events?fixture=215662");

 // Get all available events from one {fixture} & {team}
 get("https://v3.football.api-sports.io/fixtures/events?fixture=215662&team=463");

 // Get all available events from one {fixture} & {player}
 get("https://v3.football.api-sports.io/fixtures/events?fixture=215662&player=35845");

 // Get all available events from one {fixture} & {type}
 get("https://v3.football.api-sports.io/fixtures/events?fixture=215662&type=card");

 // It’s possible to make requests by mixing the available parameters
 get("https://v3.football.api-sports.io/fixtures/events?fixture=215662&player=35845&type=card");
 get("https://v3.football.api-sports.io/fixtures/events?fixture=215662&team=463&type=goal&player=35845");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "fixtures/events",
 "parameters": {
 "fixture": "215662"},
 "errors": [ ],
 "results": 18,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "time": {\
 "elapsed": 25,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 6126,\
 "name": "F. Andrada"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Goal",\
 "detail": "Normal Goal",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 33,\
 "extra": null},\
 "team": {\
 "id": 442,\
 "name": "Defensa Y Justicia",\
 "logo": "https://media.api-sports.io/football/teams/442.png"},\
 "player": {\
 "id": 5936,\
 "name": "Julio González"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 33,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 6126,\
 "name": "Federico Andrada"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 36,\
 "extra": null},\
 "team": {\
 "id": 442,\
 "name": "Defensa Y Justicia",\
 "logo": "https://media.api-sports.io/football/teams/442.png"},\
 "player": {\
 "id": 5931,\
 "name": "Diego Rodríguez"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 39,\
 "extra": null},\
 "team": {\
 "id": 442,\
 "name": "Defensa Y Justicia",\
 "logo": "https://media.api-sports.io/football/teams/442.png"},\
 "player": {\
 "id": 5954,\
 "name": "Fernando Márquez"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 44,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 6262,\
 "name": "Emanuel Iñiguez"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 46,\
 "extra": null},\
 "team": {\
 "id": 442,\
 "name": "Defensa Y Justicia",\
 "logo": "https://media.api-sports.io/football/teams/442.png"},\
 "player": {\
 "id": 35695,\
 "name": "D. Rodríguez"},\
 "assist": {\
 "id": 5947,\
 "name": "B. Merlini"},\
 "type": "subst",\
 "detail": "Substitution 1",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 62,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 6093,\
 "name": "Gonzalo Verón"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 73,\
 "extra": null},\
 "team": {\
 "id": 442,\
 "name": "Defensa Y Justicia",\
 "logo": "https://media.api-sports.io/football/teams/442.png"},\
 "player": {\
 "id": 5942,\
 "name": "A. Castro"},\
 "assist": {\
 "id": 6059,\
 "name": "G. Mainero"},\
 "type": "subst",\
 "detail": "Substitution 2",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 74,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 6561,\
 "name": "N. Solís"},\
 "assist": {\
 "id": 35845,\
 "name": "H. Burbano"},\
 "type": "subst",\
 "detail": "Substitution 1",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 75,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 6093,\
 "name": "G. Verón"},\
 "assist": {\
 "id": 6396,\
 "name": "N. Bazzana"},\
 "type": "subst",\
 "detail": "Substitution 2",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 79,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 6474,\
 "name": "G. Gil"},\
 "assist": {\
 "id": 6550,\
 "name": "F. Grahl"},\
 "type": "subst",\
 "detail": "Substitution 3",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 79,\
 "extra": null},\
 "team": {\
 "id": 442,\
 "name": "Defensa Y Justicia",\
 "logo": "https://media.api-sports.io/football/teams/442.png"},\
 "player": {\
 "id": 5936,\
 "name": "J. González"},\
 "assist": {\
 "id": 70767,\
 "name": "B. Ojeda"},\
 "type": "subst",\
 "detail": "Substitution 3",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 84,\
 "extra": null},\
 "team": {\
 "id": 442,\
 "name": "Defensa Y Justicia",\
 "logo": "https://media.api-sports.io/football/teams/442.png"},\
 "player": {\
 "id": 6540,\
 "name": "Juan Rodriguez"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 85,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 35845,\
 "name": "Hernán Burbano"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 90,\
 "extra": null},\
 "team": {\
 "id": 442,\
 "name": "Defensa Y Justicia",\
 "logo": "https://media.api-sports.io/football/teams/442.png"},\
 "player": {\
 "id": 5912,\
 "name": "Neri Cardozo"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 90,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 35845,\
 "name": "Hernán Burbano"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Red Card",\
 "comments": null},\
 {\
 "time": {\
 "elapsed": 90,\
 "extra": null},\
 "team": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"},\
 "player": {\
 "id": 35845,\
 "name": "Hernán Burbano"},\
 "assist": {\
 "id": null,\
 "name": null},\
 "type": "Card",\
 "detail": "Yellow Card",\
 "comments": null}]}`

 ## [tag/Fixtures/operation/get-fixtures-lineups](https://www.api-football.com/documentation-v3\#tag/Fixtures/operation/get-fixtures-lineups) Lineups

 Get the lineups for a fixture.

 Lineups are available between 20 and 40 minutes before the fixture when the competition covers this feature. You can check this with the endpoint `leagues` and the `coverage` field.

 > It's possible that for some competitions the lineups are not available before the fixture, this can be the case for minor competitions

 **Available datas**

 - Formation
 - Coach
 - Start XI
 - Substitutes

 **Players' positions on the grid `*`**

 **X** = row and **Y** = column (X:Y)

 Line 1 **X** being the one of the goal and then for each line this number is incremented. The column **Y** will go from left to right, and incremented for each player of the line.

 `* As a new feature, some irregularities may occur, do not hesitate to report them on our public Roadmap`

 **Update Frequency** : This endpoint is updated every 15 minutes.

 **Recommended Calls** : 1 call every 15 minutes for the fixtures in progress otherwise 1 call per day.

 > Here are several examples of what can be done

 ![demo-lineups](https://www.api-football.com/public/img/demo/demo-lineups-1.jpg)

 ![demo-lineups](https://www.api-football.com/public/img/demo/demo-lineups.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | fixture<br>required | integer<br>The id of the fixture |
 | team | integer<br>The id of the team |
 | player | integer<br>The id of the player |
 | type | string<br>The type |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/fixtures/lineups

 API-SPORTS

 https://v3.football.api-sports.io/fixtures/lineups

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available lineups from one {fixture}
 get("https://v3.football.api-sports.io/fixtures/lineups?fixture=592872");

 // Get all available lineups from one {fixture} & {team}
 get("https://v3.football.api-sports.io/fixtures/lineups?fixture=592872&team=50");

 // Get all available lineups from one {fixture} & {player}
 get("https://v3.football.api-sports.io/fixtures/lineups?fixture=215662&player=35845");

 // Get all available lineups from one {fixture} & {type}
 get("https://v3.football.api-sports.io/fixtures/lineups?fixture=215662&type=startXI");

 // It’s possible to make requests by mixing the available parameters
 get("https://v3.football.api-sports.io/fixtures/lineups?fixture=215662&player=35845&type=startXI");
 get("https://v3.football.api-sports.io/fixtures/lineups?fixture=215662&team=463&type=startXI&player=35845");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "fixtures/lineups",
 "parameters": {
 "fixture": "592872"},
 "errors": [ ],
 "results": 2,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "team": {\
 "id": 50,\
 "name": "Manchester City",\
 "logo": "https://media.api-sports.io/football/teams/50.png",\
 "colors": {\
 "player": {\
 "primary": "5badff",\
 "number": "ffffff",\
 "border": "99ff99"},\
 "goalkeeper": {\
 "primary": "99ff99",\
 "number": "000000",\
 "border": "99ff99"}}},\
 "formation": "4-3-3",\
 "startXI": [\
 {\
 "player": {\
 "id": 617,\
 "name": "Ederson",\
 "number": 31,\
 "pos": "G",\
 "grid": "1:1"}},\
 {\
 "player": {\
 "id": 627,\
 "name": "Kyle Walker",\
 "number": 2,\
 "pos": "D",\
 "grid": "2:4"}},\
 {\
 "player": {\
 "id": 626,\
 "name": "John Stones",\
 "number": 5,\
 "pos": "D",\
 "grid": "2:3"}},\
 {\
 "player": {\
 "id": 567,\
 "name": "Rúben Dias",\
 "number": 3,\
 "pos": "D",\
 "grid": "2:2"}},\
 {\
 "player": {\
 "id": 641,\
 "name": "Oleksandr Zinchenko",\
 "number": 11,\
 "pos": "D",\
 "grid": "2:1"}},\
 {\
 "player": {\
 "id": 629,\
 "name": "Kevin De Bruyne",\
 "number": 17,\
 "pos": "M",\
 "grid": "3:3"}},\
 {\
 "player": {\
 "id": 640,\
 "name": "Fernandinho",\
 "number": 25,\
 "pos": "M",\
 "grid": "3:2"}},\
 {\
 "player": {\
 "id": 631,\
 "name": "Phil Foden",\
 "number": 47,\
 "pos": "M",\
 "grid": "3:1"}},\
 {\
 "player": {\
 "id": 635,\
 "name": "Riyad Mahrez",\
 "number": 26,\
 "pos": "F",\
 "grid": "4:3"}},\
 {\
 "player": {\
 "id": 643,\
 "name": "Gabriel Jesus",\
 "number": 9,\
 "pos": "F",\
 "grid": "4:2"}},\
 {\
 "player": {\
 "id": 645,\
 "name": "Raheem Sterling",\
 "number": 7,\
 "pos": "F",\
 "grid": "4:1"}}],\
 "substitutes": [\
 {\
 "player": {\
 "id": 50828,\
 "name": "Zack Steffen",\
 "number": 13,\
 "pos": "G",\
 "grid": null}},\
 {\
 "player": {\
 "id": 623,\
 "name": "Benjamin Mendy",\
 "number": 22,\
 "pos": "D",\
 "grid": null}},\
 {\
 "player": {\
 "id": 18861,\
 "name": "Nathan Aké",\
 "number": 6,\
 "pos": "D",\
 "grid": null}},\
 {\
 "player": {\
 "id": 622,\
 "name": "Aymeric Laporte",\
 "number": 14,\
 "pos": "D",\
 "grid": null}},\
 {\
 "player": {\
 "id": 633,\
 "name": "İlkay Gündoğan",\
 "number": 8,\
 "pos": "M",\
 "grid": null}},\
 {\
 "player": {\
 "id": 44,\
 "name": "Rodri",\
 "number": 16,\
 "pos": "M",\
 "grid": null}},\
 {\
 "player": {\
 "id": 931,\
 "name": "Ferrán Torres",\
 "number": 21,\
 "pos": "F",\
 "grid": null}},\
 {\
 "player": {\
 "id": 636,\
 "name": "Bernardo Silva",\
 "number": 20,\
 "pos": "M",\
 "grid": null}},\
 {\
 "player": {\
 "id": 642,\
 "name": "Sergio Agüero",\
 "number": 10,\
 "pos": "F",\
 "grid": null}}],\
 "coach": {\
 "id": 4,\
 "name": "Guardiola",\
 "photo": "https://media.api-sports.io/football/coachs/4.png"}},\
 {\
 "team": {\
 "id": 45,\
 "name": "Everton",\
 "logo": "https://media.api-sports.io/football/teams/45.png",\
 "colors": {\
 "player": {\
 "primary": "070707",\
 "number": "ffffff",\
 "border": "66ff00"},\
 "goalkeeper": {\
 "primary": "66ff00",\
 "number": "000000",\
 "border": "66ff00"}}},\
 "formation": "4-3-1-2",\
 "startXI": [\
 {\
 "player": {\
 "id": 2932,\
 "name": "Jordan Pickford",\
 "number": 1,\
 "pos": "G",\
 "grid": "1:1"}},\
 {\
 "player": {\
 "id": 19150,\
 "name": "Mason Holgate",\
 "number": 4,\
 "pos": "D",\
 "grid": "2:4"}},\
 {\
 "player": {\
 "id": 2934,\
 "name": "Michael Keane",\
 "number": 5,\
 "pos": "D",\
 "grid": "2:3"}},\
 {\
 "player": {\
 "id": 19073,\
 "name": "Ben Godfrey",\
 "number": 22,\
 "pos": "D",\
 "grid": "2:2"}},\
 {\
 "player": {\
 "id": 2724,\
 "name": "Lucas Digne",\
 "number": 12,\
 "pos": "D",\
 "grid": "2:1"}},\
 {\
 "player": {\
 "id": 18805,\
 "name": "Abdoulaye Doucouré",\
 "number": 16,\
 "pos": "M",\
 "grid": "3:3"}},\
 {\
 "player": {\
 "id": 326,\
 "name": "Allan",\
 "number": 6,\
 "pos": "M",\
 "grid": "3:2"}},\
 {\
 "player": {\
 "id": 18762,\
 "name": "Tom Davies",\
 "number": 26,\
 "pos": "M",\
 "grid": "3:1"}},\
 {\
 "player": {\
 "id": 2795,\
 "name": "Gylfi Sigurðsson",\
 "number": 10,\
 "pos": "M",\
 "grid": "4:1"}},\
 {\
 "player": {\
 "id": 18766,\
 "name": "Dominic Calvert-Lewin",\
 "number": 9,\
 "pos": "F",\
 "grid": "5:2"}},\
 {\
 "player": {\
 "id": 2413,\
 "name": "Richarlison",\
 "number": 7,\
 "pos": "F",\
 "grid": "5:1"}}],\
 "substitutes": [\
 {\
 "player": {\
 "id": 18755,\
 "name": "João Virgínia",\
 "number": 31,\
 "pos": "G",\
 "grid": null}},\
 {\
 "player": {\
 "id": 766,\
 "name": "Robin Olsen",\
 "number": 33,\
 "pos": "G",\
 "grid": null}},\
 {\
 "player": {\
 "id": 156490,\
 "name": "Niels Nkounkou",\
 "number": 18,\
 "pos": "D",\
 "grid": null}},\
 {\
 "player": {\
 "id": 18758,\
 "name": "Séamus Coleman",\
 "number": 23,\
 "pos": "D",\
 "grid": null}},\
 {\
 "player": {\
 "id": 138849,\
 "name": "Kyle John",\
 "number": 48,\
 "pos": "D",\
 "grid": null}},\
 {\
 "player": {\
 "id": 18765,\
 "name": "André Gomes",\
 "number": 21,\
 "pos": "M",\
 "grid": null}},\
 {\
 "player": {\
 "id": 1455,\
 "name": "Alex Iwobi",\
 "number": 17,\
 "pos": "F",\
 "grid": null}},\
 {\
 "player": {\
 "id": 18761,\
 "name": "Bernard",\
 "number": 20,\
 "pos": "F",\
 "grid": null}}],\
 "coach": {\
 "id": 2407,\
 "name": "C. Ancelotti",\
 "photo": "https://media.api-sports.io/football/coachs/2407.png"}}]}`

 ## [tag/Fixtures/operation/get-fixtures-players](https://www.api-football.com/documentation-v3\#tag/Fixtures/operation/get-fixtures-players) Players statistics

 Get the players statistics from one fixture.

 **Update Frequency** : This endpoint is updated every minute.

 **Recommended Calls** : 1 call every minute for the fixtures in progress otherwise 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | fixture<br>required | integer<br>The id of the fixture |
 | team | integer<br>The id of the team |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/fixtures/players

 API-SPORTS

 https://v3.football.api-sports.io/fixtures/players

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available players statistics from one {fixture}
 get("https://v3.football.api-sports.io/fixtures/players?fixture=169080");

 // Get all available players statistics from one {fixture} & {team}
 get("https://v3.football.api-sports.io/fixtures/players?fixture=169080&team=2284");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "fixtures/players",
 "parameters": {
 "fixture": "169080"},
 "errors": [ ],
 "results": 2,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "team": {\
 "id": 2284,\
 "name": "Monarcas",\
 "logo": "https://media.api-sports.io/football/teams/2284.png",\
 "update": "2020-01-13T16:12:12+00:00"},\
 "players": [\
 {\
 "player": {\
 "id": 35931,\
 "name": "Sebastián Sosa",\
 "photo": "https://media.api-sports.io/football/players/35931.png"},\
 "statistics": [\
 {\
 "games": {\
 "minutes": 90,\
 "number": 13,\
 "position": "G",\
 "rating": "6.3",\
 "captain": false,\
 "substitute": false},\
 "offsides": null,\
 "shots": {\
 "total": 0,\
 "on": 0},\
 "goals": {\
 "total": null,\
 "conceded": 1,\
 "assists": null,\
 "saves": 0},\
 "passes": {\
 "total": 17,\
 "key": 0,\
 "accuracy": "68%"},\
 "tackles": {\
 "total": null,\
 "blocks": 0,\
 "interceptions": 0},\
 "duels": {\
 "total": null,\
 "won": null},\
 "dribbles": {\
 "attempts": 0,\
 "success": 0,\
 "past": null},\
 "fouls": {\
 "drawn": 0,\
 "committed": 0},\
 "cards": {\
 "yellow": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": 0}}]}]}]}`

 # [tag/Injuries](https://www.api-football.com/documentation-v3\#tag/Injuries) Injuries

 ## [tag/Injuries/operation/get-injuries](https://www.api-football.com/documentation-v3\#tag/Injuries/operation/get-injuries) Injuries

 Get the list of players not participating in the fixtures for various reasons such as `suspended`, `injured` for example.

 Being a new endpoint, the data is only available from April 2021.

 **There are two types:**

 - `Missing Fixture` : The player will not play the fixture.
 - `Questionable` : The information is not yet 100% sure, the player may eventually play the fixture.

 > Examples available in Request samples "Use Cases".

 > All the parameters of this endpoint can be used together.

 **This endpoint requires at least one parameter.**

 **Update Frequency** : This endpoint is updated every 4 hours.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | league | integer<br>The id of the league |
 | season | integer = 4 characters YYYY<br>The season of the league, **required** with `league`, `team` and `player` parameters |
 | fixture | integer<br>The id of the fixture |
 | team | integer<br>The id of the team |
 | player | integer<br>The id of the player |
 | date | stringYYYY-MM-DD<br>A valid date |
 | ids | stringMaximum of 20 fixtures ids<br>Value:"id-id-id"<br>One or more fixture ids |
 | timezone | string<br>A valid timezone from the endpoint `Timezone` |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/injuries

 API-SPORTS

 https://v3.football.api-sports.io/injuries

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available injuries from one {league} & {season}
 get("https://v3.football.api-sports.io/injuries?league=2&season=2020");

 // Get all available injuries from one {fixture}
 get("https://v3.football.api-sports.io/injuries?fixture=686314");

 // Get all available injuries from severals fixtures {ids}
 get("https://v3.football.api-sports.io/injuries?ids=686314-686315-686316-686317-686318-686319-686320");

 // Get all available injuries from one {team} & {season}
 get("https://v3.football.api-sports.io/injuries?team=85&season=2020");

 // Get all available injuries from one {player} & {season}
 get("https://v3.football.api-sports.io/injuries?player=865&season=2020");

 // Get all available injuries from one {date}
 get("https://v3.football.api-sports.io/injuries?date=2021-04-07");

 // It’s possible to make requests by mixing the available parameters
 get("https://v3.football.api-sports.io/injuries?league=2&season=2020&team=85");
 get("https://v3.football.api-sports.io/injuries?league=2&season=2020&player=865");
 get("https://v3.football.api-sports.io/injuries?date=2021-04-07&timezone=Europe/London&team=85");
 get("https://v3.football.api-sports.io/injuries?date=2021-04-07&league=61");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "injuries",
 "parameters": {
 "fixture": "686314"},
 "errors": [ ],
 "results": 13,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "player": {\
 "id": 865,\
 "name": "D. Costa",\
 "photo": "https://media.api-sports.io/football/players/865.png",\
 "type": "Missing Fixture",\
 "reason": "Broken ankle"},\
 "team": {\
 "id": 157,\
 "name": "Bayern Munich",\
 "logo": "https://media.api-sports.io/football/teams/157.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 510,\
 "name": "S. Gnabry",\
 "photo": "https://media.api-sports.io/football/players/510.png",\
 "type": "Missing Fixture",\
 "reason": "Illness"},\
 "team": {\
 "id": 157,\
 "name": "Bayern Munich",\
 "logo": "https://media.api-sports.io/football/teams/157.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 496,\
 "name": "R. Hoffmann",\
 "photo": "https://media.api-sports.io/football/players/496.png",\
 "type": "Missing Fixture",\
 "reason": "Knee Injury"},\
 "team": {\
 "id": 157,\
 "name": "Bayern Munich",\
 "logo": "https://media.api-sports.io/football/teams/157.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 521,\
 "name": "R. Lewandowski",\
 "photo": "https://media.api-sports.io/football/players/521.png",\
 "type": "Missing Fixture",\
 "reason": "Knee Injury"},\
 "team": {\
 "id": 157,\
 "name": "Bayern Munich",\
 "logo": "https://media.api-sports.io/football/teams/157.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 514,\
 "name": "J. Martinez",\
 "photo": "https://media.api-sports.io/football/players/514.png",\
 "type": "Missing Fixture",\
 "reason": "Knock"},\
 "team": {\
 "id": 157,\
 "name": "Bayern Munich",\
 "logo": "https://media.api-sports.io/football/teams/157.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 162037,\
 "name": "M. Tillman",\
 "photo": "https://media.api-sports.io/football/players/162037.png",\
 "type": "Missing Fixture",\
 "reason": "Knee Injury"},\
 "team": {\
 "id": 157,\
 "name": "Bayern Munich",\
 "logo": "https://media.api-sports.io/football/teams/157.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 519,\
 "name": "C. Tolisso",\
 "photo": "https://media.api-sports.io/football/players/519.png",\
 "type": "Missing Fixture",\
 "reason": "Tendon Injury"},\
 "team": {\
 "id": 157,\
 "name": "Bayern Munich",\
 "logo": "https://media.api-sports.io/football/teams/157.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 258,\
 "name": "J. Bernat",\
 "photo": "https://media.api-sports.io/football/players/258.png",\
 "type": "Missing Fixture",\
 "reason": "Knee Injury"},\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 769,\
 "name": "A. Florenzi",\
 "photo": "https://media.api-sports.io/football/players/769.png",\
 "type": "Missing Fixture",\
 "reason": "Illness"},\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 216,\
 "name": "M. Icardi",\
 "photo": "https://media.api-sports.io/football/players/216.png",\
 "type": "Missing Fixture",\
 "reason": "Muscle Injury"},\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 263,\
 "name": "L. Kurzawa",\
 "photo": "https://media.api-sports.io/football/players/263.png",\
 "type": "Missing Fixture",\
 "reason": "Calf Injury"},\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 271,\
 "name": "L. Paredes",\
 "photo": "https://media.api-sports.io/football/players/271.png",\
 "type": "Missing Fixture",\
 "reason": "Suspended"},\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}},\
 {\
 "player": {\
 "id": 273,\
 "name": "M. Verratti",\
 "photo": "https://media.api-sports.io/football/players/273.png",\
 "type": "Missing Fixture",\
 "reason": "Illness"},\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "fixture": {\
 "id": 686314,\
 "timezone": "UTC",\
 "date": "2021-04-07T19:00:00+00:00",\
 "timestamp": 1617822000},\
 "league": {\
 "id": 2,\
 "season": 2020,\
 "name": "UEFA Champions League",\
 "country": "World",\
 "logo": "https://media.api-sports.io/football/leagues/2.png",\
 "flag": null}}]}`

 # [tag/Predictions](https://www.api-football.com/documentation-v3\#tag/Predictions) Predictions

 ## [tag/Predictions/operation/get-predictions](https://www.api-football.com/documentation-v3\#tag/Predictions/operation/get-predictions) Predictions

 Get predictions about a fixture.

 The predictions are made using several algorithms including the poisson distribution, comparison of team statistics, last matches, players etc…

 Bookmakers odds are not used to make these predictions

 Also provides some comparative statistics between teams

 **Available Predictions**

 - Match winner : Id of the team that can potentially win the fixture
 - Win or Draw : If `True` indicates that the designated team can win or draw
 - Under / Over : -1.5 / -2.5 / -3.5 / -4.5 / +1.5 / +2.5 / +3.5 / +4.5 `*`
 - Goals Home : -1.5 / -2.5 / -3.5 / -4.5 `*`
 - Goals Away -1.5 / -2.5 / -3.5 / -4.5 `*`
 - Advice _(Ex : Deportivo Santani or draws and -3.5 goals)_

 `*` **-1.5** means that there will be a maximum of **1.5** goals in the fixture, i.e : **1** goal

 **Update Frequency** : This endpoint is updated every hour.

 **Recommended Calls** : 1 call per hour for the fixtures in progress otherwise 1 call per day.

 > Here is an example of what can be achieved

 ![demo-prediction](https://www.api-football.com/public/img/demo/demo-prediction.png)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | fixture<br>required | integer<br>The id of the fixture |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/predictions

 API-SPORTS

 https://v3.football.api-sports.io/predictions

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available predictions from one {fixture}
 get("https://v3.football.api-sports.io/predictions?fixture=198772");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "predictions",
 "parameters": {
 "fixture": "198772"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "predictions": {\
 "winner": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "comment": "Win or draw"},\
 "win_or_draw": true,\
 "under_over": "-3.5",\
 "goals": {\
 "home": "-2.5",\
 "away": "-1.5"},\
 "advice": "Combo Double chance : Deportivo Santani or draw and -3.5 goals",\
 "percent": {\
 "home": "45%",\
 "draw": "45%",\
 "away": "10%"}},\
 "league": {\
 "id": 252,\
 "name": "Primera Division - Clausura",\
 "country": "Paraguay",\
 "logo": "https://media.api-sports.io/football/leagues/252.png",\
 "flag": "https://media.api-sports.io/flags/py.svg",\
 "season": 2019},\
 "teams": {\
 "home": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "logo": "https://media.api-sports.io/football/teams/1189.png",\
 "last_5": {\
 "form": "60%",\
 "att": "60%",\
 "def": "0%",\
 "goals": {\
 "for": {\
 "total": 3,\
 "average": 0.6},\
 "against": {\
 "total": 5,\
 "average": 1}}},\
 "league": {\
 "form": "LDLDLDLWLWWLW",\
 "fixtures": {\
 "played": {\
 "home": 6,\
 "away": 7,\
 "total": 13},\
 "wins": {\
 "home": 2,\
 "away": 2,\
 "total": 4},\
 "draws": {\
 "home": 3,\
 "away": 0,\
 "total": 3},\
 "loses": {\
 "home": 1,\
 "away": 5,\
 "total": 6}},\
 "goals": {\
 "for": {\
 "total": {\
 "home": 7,\
 "away": 4,\
 "total": 11},\
 "average": {\
 "home": "1.2",\
 "away": "0.6",\
 "total": "0.8"}},\
 "against": {\
 "total": {\
 "home": 6,\
 "away": 14,\
 "total": 20},\
 "average": {\
 "home": "1.0",\
 "away": "2.0",\
 "total": "1.5"}}},\
 "biggest": {\
 "streak": {\
 "wins": 2,\
 "draws": 1,\
 "loses": 1},\
 "wins": {\
 "home": "3-1",\
 "away": "0-1"},\
 "loses": {\
 "home": "0-2",\
 "away": "4-0"},\
 "goals": {\
 "for": {\
 "home": 3,\
 "away": 1},\
 "against": {\
 "home": 2,\
 "away": 4}}},\
 "clean_sheet": {\
 "home": 1,\
 "away": 2,\
 "total": 3},\
 "failed_to_score": {\
 "home": 1,\
 "away": 3,\
 "total": 4}}},\
 "away": {\
 "id": 1180,\
 "name": "Deportivo Capiata",\
 "logo": "https://media.api-sports.io/football/teams/1180.png",\
 "last_5": {\
 "form": "40%",\
 "att": "80%",\
 "def": "0%",\
 "goals": {\
 "for": {\
 "total": 4,\
 "average": 0.8},\
 "against": {\
 "total": 8,\
 "average": 1.6}}},\
 "league": {\
 "form": "WLWLDLDLLLLWW",\
 "fixtures": {\
 "played": {\
 "home": 7,\
 "away": 6,\
 "total": 13},\
 "wins": {\
 "home": 3,\
 "away": 1,\
 "total": 4},\
 "draws": {\
 "home": 0,\
 "away": 2,\
 "total": 2},\
 "loses": {\
 "home": 4,\
 "away": 3,\
 "total": 7}},\
 "goals": {\
 "for": {\
 "total": {\
 "home": 8,\
 "away": 3,\
 "total": 11},\
 "average": {\
 "home": "1.1",\
 "away": "0.5",\
 "total": "0.8"}},\
 "against": {\
 "total": {\
 "home": 14,\
 "away": 10,\
 "total": 24},\
 "average": {\
 "home": "2.0",\
 "away": "1.7",\
 "total": "1.8"}}},\
 "biggest": {\
 "streak": {\
 "wins": 1,\
 "draws": 1,\
 "loses": 4},\
 "wins": {\
 "home": "3-1",\
 "away": "0-1"},\
 "loses": {\
 "home": "0-6",\
 "away": "3-0"},\
 "goals": {\
 "for": {\
 "home": 3,\
 "away": 1},\
 "against": {\
 "home": 6,\
 "away": 3}}},\
 "clean_sheet": {\
 "home": 1,\
 "away": 1,\
 "total": 2},\
 "failed_to_score": {\
 "home": 3,\
 "away": 3,\
 "total": 6}}}},\
 "comparison": {\
 "form": {\
 "home": "60%",\
 "away": "40%"},\
 "att": {\
 "home": "43%",\
 "away": "57%"},\
 "def": {\
 "home": "62%",\
 "away": "38%"},\
 "poisson_distribution": {\
 "home": "75%",\
 "away": "25%"},\
 "h2h": {\
 "home": "29%",\
 "away": "71%"},\
 "goals": {\
 "home": "40%",\
 "away": "60%"},\
 "total": {\
 "home": "51.5%",\
 "away": "48.5%"}},\
 "h2h": [\
 {\
 "fixture": {\
 "id": 198706,\
 "referee": "J. Méndez",\
 "timezone": "UTC",\
 "date": "2019-07-27T19:30:00+00:00",\
 "timestamp": 1564255800,\
 "periods": {\
 "first": 1564255800,\
 "second": 1564259400},\
 "venue": {\
 "id": null,\
 "name": "Estadio Lic. Erico Galeano Segovia (Capiatá)",\
 "city": null},\
 "status": {\
 "long": "Match Finished",\
 "short": "FT",\
 "elapsed": 90,\
 "extra": null}},\
 "league": {\
 "id": 252,\
 "name": "Primera Division - Clausura",\
 "country": "Paraguay",\
 "logo": "https://media.api-sports.io/football/leagues/252.png",\
 "flag": "https://media.api-sports.io/flags/py.svg",\
 "season": 2019,\
 "round": "Clausura - 3"},\
 "teams": {\
 "home": {\
 "id": 1180,\
 "name": "Deportivo Capiata",\
 "logo": "https://media.api-sports.io/football/teams/1180.png",\
 "winner": true},\
 "away": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "logo": "https://media.api-sports.io/football/teams/1189.png",\
 "winner": false}},\
 "goals": {\
 "home": 3,\
 "away": 1},\
 "score": {\
 "halftime": {\
 "home": 1,\
 "away": 1},\
 "fulltime": {\
 "home": 3,\
 "away": 1},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}},\
 {\
 "fixture": {\
 "id": 144182,\
 "referee": null,\
 "timezone": "UTC",\
 "date": "2019-03-25T23:15:00+00:00",\
 "timestamp": 1553555700,\
 "periods": {\
 "first": 1553555700,\
 "second": 1553559300},\
 "venue": {\
 "id": null,\
 "name": "Estadio Lic. Erico Galeano Segovia (Capiatá)",\
 "city": null},\
 "status": {\
 "long": "Match Finished",\
 "short": "FT",\
 "elapsed": 90,\
 "extra": null}},\
 "league": {\
 "id": 250,\
 "name": "Primera Division - Apertura",\
 "country": "Paraguay",\
 "logo": "https://media.api-sports.io/football/leagues/250.png",\
 "flag": "https://media.api-sports.io/flags/py.svg",\
 "season": 2019,\
 "round": "Regular Season - 12"},\
 "teams": {\
 "home": {\
 "id": 1180,\
 "name": "Deportivo Capiata",\
 "logo": "https://media.api-sports.io/football/teams/1180.png",\
 "winner": true},\
 "away": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "logo": "https://media.api-sports.io/football/teams/1189.png",\
 "winner": false}},\
 "goals": {\
 "home": 2,\
 "away": 1},\
 "score": {\
 "halftime": {\
 "home": 2,\
 "away": 1},\
 "fulltime": {\
 "home": 2,\
 "away": 1},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}},\
 {\
 "fixture": {\
 "id": 144113,\
 "referee": null,\
 "timezone": "UTC",\
 "date": "2019-01-23T21:00:00+00:00",\
 "timestamp": 1548277200,\
 "periods": {\
 "first": 1548277200,\
 "second": 1548280800},\
 "venue": {\
 "id": null,\
 "name": "Estadio Juan José Vázquez (San Estanislao)",\
 "city": null},\
 "status": {\
 "long": "Match Finished",\
 "short": "FT",\
 "elapsed": 90,\
 "extra": null}},\
 "league": {\
 "id": 250,\
 "name": "Primera Division - Apertura",\
 "country": "Paraguay",\
 "logo": "https://media.api-sports.io/football/leagues/250.png",\
 "flag": "https://media.api-sports.io/flags/py.svg",\
 "season": 2019,\
 "round": "Regular Season - 1"},\
 "teams": {\
 "home": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "logo": "https://media.api-sports.io/football/teams/1189.png",\
 "winner": null},\
 "away": {\
 "id": 1180,\
 "name": "Deportivo Capiata",\
 "logo": "https://media.api-sports.io/football/teams/1180.png",\
 "winner": null}},\
 "goals": {\
 "home": 0,\
 "away": 0},\
 "score": {\
 "halftime": {\
 "home": 0,\
 "away": 0},\
 "fulltime": {\
 "home": 0,\
 "away": 0},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}},\
 {\
 "fixture": {\
 "id": 144745,\
 "referee": null,\
 "timezone": "UTC",\
 "date": "2018-11-12T20:45:00+00:00",\
 "timestamp": 1542055500,\
 "periods": {\
 "first": 1542055500,\
 "second": 1542059100},\
 "venue": {\
 "id": null,\
 "name": "Estadio Lic. Erico Galeano Segovia (Capiatá)",\
 "city": null},\
 "status": {\
 "long": "Match Finished",\
 "short": "FT",\
 "elapsed": 90,\
 "extra": null}},\
 "league": {\
 "id": 252,\
 "name": "Primera Division - Clausura",\
 "country": "Paraguay",\
 "logo": "https://media.api-sports.io/football/leagues/252.png",\
 "flag": "https://media.api-sports.io/flags/py.svg",\
 "season": 2018,\
 "round": "Regular Season - 18"},\
 "teams": {\
 "home": {\
 "id": 1180,\
 "name": "Deportivo Capiata",\
 "logo": "https://media.api-sports.io/football/teams/1180.png",\
 "winner": false},\
 "away": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "logo": "https://media.api-sports.io/football/teams/1189.png",\
 "winner": true}},\
 "goals": {\
 "home": 0,\
 "away": 2},\
 "score": {\
 "halftime": {\
 "home": 0,\
 "away": 1},\
 "fulltime": {\
 "home": 0,\
 "away": 2},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}},\
 {\
 "fixture": {\
 "id": 144679,\
 "referee": null,\
 "timezone": "UTC",\
 "date": "2018-08-26T19:30:00+00:00",\
 "timestamp": 1535311800,\
 "periods": {\
 "first": 1535311800,\
 "second": 1535315400},\
 "venue": {\
 "id": null,\
 "name": "Estadio Juan José Vázquez (San Estanislao)",\
 "city": null},\
 "status": {\
 "long": "Match Finished",\
 "short": "FT",\
 "elapsed": 90,\
 "extra": null}},\
 "league": {\
 "id": 252,\
 "name": "Primera Division - Clausura",\
 "country": "Paraguay",\
 "logo": "https://media.api-sports.io/football/leagues/252.png",\
 "flag": "https://media.api-sports.io/flags/py.svg",\
 "season": 2018,\
 "round": "Regular Season - 7"},\
 "teams": {\
 "home": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "logo": "https://media.api-sports.io/football/teams/1189.png",\
 "winner": false},\
 "away": {\
 "id": 1180,\
 "name": "Deportivo Capiata",\
 "logo": "https://media.api-sports.io/football/teams/1180.png",\
 "winner": true}},\
 "goals": {\
 "home": 0,\
 "away": 1},\
 "score": {\
 "halftime": {\
 "home": 0,\
 "away": 1},\
 "fulltime": {\
 "home": 0,\
 "away": 1},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}},\
 {\
 "fixture": {\
 "id": 144330,\
 "referee": null,\
 "timezone": "UTC",\
 "date": "2018-05-05T21:30:00+00:00",\
 "timestamp": 1525555800,\
 "periods": {\
 "first": 1525555800,\
 "second": 1525559400},\
 "venue": {\
 "id": null,\
 "name": "Estadio Juan José Vázquez (San Estanislao)",\
 "city": null},\
 "status": {\
 "long": "Match Finished",\
 "short": "FT",\
 "elapsed": 90,\
 "extra": null}},\
 "league": {\
 "id": 250,\
 "name": "Primera Division - Apertura",\
 "country": "Paraguay",\
 "logo": "https://media.api-sports.io/football/leagues/250.png",\
 "flag": "https://media.api-sports.io/flags/py.svg",\
 "season": 2018,\
 "round": "Regular Season - 15"},\
 "teams": {\
 "home": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "logo": "https://media.api-sports.io/football/teams/1189.png",\
 "winner": null},\
 "away": {\
 "id": 1180,\
 "name": "Deportivo Capiata",\
 "logo": "https://media.api-sports.io/football/teams/1180.png",\
 "winner": null}},\
 "goals": {\
 "home": 3,\
 "away": 3},\
 "score": {\
 "halftime": {\
 "home": 2,\
 "away": 1},\
 "fulltime": {\
 "home": 3,\
 "away": 3},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}},\
 {\
 "fixture": {\
 "id": 144264,\
 "referee": null,\
 "timezone": "UTC",\
 "date": "2018-02-25T20:45:00+00:00",\
 "timestamp": 1519591500,\
 "periods": {\
 "first": 1519591500,\
 "second": 1519595100},\
 "venue": {\
 "id": null,\
 "name": "Estadio Lic. Erico Galeano Segovia (Capiatá)",\
 "city": null},\
 "status": {\
 "long": "Match Finished",\
 "short": "FT",\
 "elapsed": 90,\
 "extra": null}},\
 "league": {\
 "id": 250,\
 "name": "Primera Division - Apertura",\
 "country": "Paraguay",\
 "logo": "https://media.api-sports.io/football/leagues/250.png",\
 "flag": "https://media.api-sports.io/flags/py.svg",\
 "season": 2018,\
 "round": "Regular Season - 4"},\
 "teams": {\
 "home": {\
 "id": 1180,\
 "name": "Deportivo Capiata",\
 "logo": "https://media.api-sports.io/football/teams/1180.png",\
 "winner": true},\
 "away": {\
 "id": 1189,\
 "name": "Deportivo Santani",\
 "logo": "https://media.api-sports.io/football/teams/1189.png",\
 "winner": false}},\
 "goals": {\
 "home": 2,\
 "away": 1},\
 "score": {\
 "halftime": {\
 "home": 1,\
 "away": 1},\
 "fulltime": {\
 "home": 2,\
 "away": 1},\
 "extratime": {\
 "home": null,\
 "away": null},\
 "penalty": {\
 "home": null,\
 "away": null}}}]}]}`

 # [tag/Coachs](https://www.api-football.com/documentation-v3\#tag/Coachs) Coachs

 ## [tag/Coachs/operation/get-coachs](https://www.api-football.com/documentation-v3\#tag/Coachs/operation/get-coachs) Coachs

 Get all the information about the coachs and their careers.

 To get the photo of a coach you have to call the following url: `https://media.api-sports.io/football/coachs/{coach_id}.png`

 **Update Frequency** : This endpoint is updated every day.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | integer<br>The id of the coach |
 | team | integer<br>The id of the team |
 | search | string >= 3 characters <br>The name of the coach |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/coachs

 API-SPORTS

 https://v3.football.api-sports.io/coachs

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get coachs from one coach {id}
 get("https://v3.football.api-sports.io/coachs?id=1");

 // Get coachs from one {team}
 get("https://v3.football.api-sports.io/coachs?team=33");

 // Allows you to search for a coach in relation to a coach {name}
 get("https://v3.football.api-sports.io/coachs?search=Klopp");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "coachs",
 "parameters": {
 "team": "85"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "id": 40,\
 "name": "T. Tuchel",\
 "firstname": "Thomas",\
 "lastname": "Tuchel",\
 "age": 47,\
 "birth": {\
 "date": "1973-08-29",\
 "place": "Krumbach",\
 "country": "Germany"},\
 "nationality": "Germany",\
 "height": "192 cm",\
 "weight": "85 kg",\
 "photo": "https://media.api-sports.io/football/coachs/40.png",\
 "team": {\
 "id": 85,\
 "name": "PSG",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "career": [\
 {\
 "team": {\
 "id": 85,\
 "name": "PSG",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "start": "2018-07-01",\
 "end": null},\
 {\
 "team": {\
 "id": 165,\
 "name": "Borussia Dortmund",\
 "logo": "https://media.api-sports.io/football/teams/165.png"},\
 "start": "2015-07-01",\
 "end": "2017-05-01"},\
 {\
 "team": {\
 "id": 164,\
 "name": "Mainz 05",\
 "logo": "https://media.api-sports.io/football/teams/164.png"},\
 "start": "2009-08-01",\
 "end": "2014-05-01"}]}]}`

 # [tag/Players](https://www.api-football.com/documentation-v3\#tag/Players) Players

 ## [tag/Players/operation/get-players-seasons](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players-seasons) Seasons

 Get all available seasons for players statistics.

 **Update Frequency** : This endpoint is updated every day.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | player | integer<br>The id of the player |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players/seasons

 API-SPORTS

 https://v3.football.api-sports.io/players/seasons

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all seasons available for players endpoint
 get("https://v3.football.api-sports.io/players/seasons");

 // Get all seasons available for a player {id}
 get("https://v3.football.api-sports.io/players/seasons?player=276");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players/seasons",
 "parameters": [ ],
 "errors": [ ],
 "results": 35,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 1966,\
 1982,\
 1986,\
 1990,\
 1991,\
 1992,\
 1993,\
 1994,\
 1995,\
 1996,\
 1997,\
 1998,\
 1999,\
 2000,\
 2001,\
 2002,\
 2003,\
 2004,\
 2005,\
 2006,\
 2007,\
 2008,\
 2009,\
 2010,\
 2011,\
 2012,\
 2013,\
 2014,\
 2015,\
 2016,\
 2017,\
 2018,\
 2019,\
 2020,\
 2022]}`

 ## [tag/Players/operation/get-players-profiles](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players-profiles) Profiles

 Returns the list of all available players.

 It is possible to call this endpoint without parameters, but you will need to use the **pagination** to get all available players.

 To get the photo of a player you have to call the following url: `https://media.api-sports.io/football/players/{player_id}.png`

 This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter.

 > **Pagination** : 250 results per page.

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per week.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | player | integer<br>The id of the player |
 | search | string >= 3 characters <br>The lastname of the player |
 | page | integer<br>Default: 1<br>Use for the pagination |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players/profiles

 API-SPORTS

 https://v3.football.api-sports.io/players/profiles

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get data from one {player}
 get("https://v3.football.api-sports.io/players/profiles?player=276");

 // Allows you to search for a player in relation to a player {lastname}
 get("https://v3.football.api-sports.io/players/profiles?search=ney");

 // Get all available Players (limited to 250 results, use the pagination for next ones)
 get("https://v3.football.api-sports.io/players/profiles");
 get("https://v3.football.api-sports.io/players/profiles?page=2");
 get("https://v3.football.api-sports.io/players/profiles?page=3");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players/profiles",
 "parameters": {
 "player": "276"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "player": {\
 "id": 276,\
 "name": "Neymar",\
 "firstname": "Neymar",\
 "lastname": "da Silva Santos Júnior",\
 "age": 32,\
 "birth": {\
 "date": "1992-02-05",\
 "place": "Mogi das Cruzes",\
 "country": "Brazil"},\
 "nationality": "Brazil",\
 "height": "175 cm",\
 "weight": "68 kg",\
 "number": 10,\
 "position": "Attacker",\
 "photo": "https://media.api-sports.io/football/players/276.png"}}]}`

 ## [tag/Players/operation/get-players](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players) Statistics

 Get players statistics.

 This endpoint returns the players for whom the `profile` and `statistics` data are available. Note that it is possible that a player has statistics for 2 teams in the same season in case of transfers.

 The statistics are calculated according to the team `id`, league `id` and `season`.

 You can find the available `seasons` by using the endpoint `players/seasons`.

 > To get the squads of the teams it is better to use the endpoint `players/squads`.

 The players `id` are unique in the API and players keep it among all the teams they have been in.

 In this endpoint you have the `rating` field, which is the rating of the player according to a match or a season. This data is calculated according to the performance of the player in relation to the other players of the game or the season who occupy the same position _(Attacker, defender, goal...)_. There are different algorithms that take into account the position of the player and assign points according to his performance.

 To get the photo of a player you have to call the following url: `https://media.api-sports.io/football/players/{player_id}.png`

 This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter.

 > **Pagination** : 20 results per page.

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 **Tutorials** :

 - [HOW TO GET ALL TEAMS AND PLAYERS FROM A LEAGUE ID](https://www.api-football.com/tutorials/4/how-to-get-all-teams-and-players-from-a-league-id)

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | integer<br>The id of the player |
 | team | integer<br>The id of the team |
 | league | integer<br>The id of the league |
 | season | integer = 4 characters YYYY \| Requires the fields Id, League or Team...<br>The season of the league |
 | search | string >= 4 characters Requires the fields League or Team<br>The name of the player |
 | page | integer<br>Default: 1<br>Use for the pagination |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players

 API-SPORTS

 https://v3.football.api-sports.io/players

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all players statistics from one player {id} & {season}
 get("https://v3.football.api-sports.io/players?id=19088&season=2018");

 // Get all players statistics from one {team} & {season}
 get("https://v3.football.api-sports.io/players?season=2018&team=33");
 get("https://v3.football.api-sports.io/players?season=2018&team=33&page=2");

 // Get all players statistics from one {league} & {season}
 get("https://v3.football.api-sports.io/players?season=2018&league=61");
 get("https://v3.football.api-sports.io/players?season=2018&league=61&page=4");

 // Get all players statistics from one {league}, {team} & {season}
 get("https://v3.football.api-sports.io/players?season=2018&league=61&team=33");
 get("https://v3.football.api-sports.io/players?season=2018&league=61&team=33&page=5");

 // Allows you to search for a player in relation to a player {name}
 get("https://v3.football.api-sports.io/players?team=85&search=cavani");
 get("https://v3.football.api-sports.io/players?league=61&search=cavani");
 get("https://v3.football.api-sports.io/players?team=85&search=cavani&season=2018");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players",
 "parameters": {
 "id": "276",
 "season": "2019"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "player": {\
 "id": 276,\
 "name": "Neymar",\
 "firstname": "Neymar",\
 "lastname": "da Silva Santos Júnior",\
 "age": 28,\
 "birth": {\
 "date": "1992-02-05",\
 "place": "Mogi das Cruzes",\
 "country": "Brazil"},\
 "nationality": "Brazil",\
 "height": "175 cm",\
 "weight": "68 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/276.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2019},\
 "games": {\
 "appearences": 15,\
 "lineups": 15,\
 "minutes": 1322,\
 "number": null,\
 "position": "Attacker",\
 "rating": "8.053333",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 3,\
 "bench": 0},\
 "shots": {\
 "total": 70,\
 "on": 36},\
 "goals": {\
 "total": 13,\
 "conceded": null,\
 "assists": 6,\
 "saves": 0},\
 "passes": {\
 "total": 704,\
 "key": 39,\
 "accuracy": 79},\
 "tackles": {\
 "total": 13,\
 "blocks": 0,\
 "interceptions": 4},\
 "duels": {\
 "total": null,\
 "won": null},\
 "dribbles": {\
 "attempts": 143,\
 "success": 88,\
 "past": null},\
 "fouls": {\
 "drawn": 62,\
 "committed": 14},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 1,\
 "red": 0},\
 "penalty": {\
 "won": 1,\
 "commited": null,\
 "scored": 4,\
 "missed": 1,\
 "saved": null}}]}]}`

 ## [tag/Players/operation/get-players-squads](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players-squads) Squads

 Return the current squad of a team when the `team` parameter is used. When the `player` parameter is used the endpoint returns the set of teams associated with the player.

 > The response format is the same regardless of the parameter sent.

 **This endpoint requires at least one parameter.**

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per week.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | team | integer<br>The id of the team |
 | player | integer<br>The id of the player |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players/squads

 API-SPORTS

 https://v3.football.api-sports.io/players/squads

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all players from one {team}
 get("https://v3.football.api-sports.io/players/squads?team=33");

 // Get all teams from one {player}
 get("https://v3.football.api-sports.io/players/squads?player=276");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players/squads",
 "parameters": {
 "team": "33"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "team": {\
 "id": 33,\
 "name": "Manchester United",\
 "logo": "https://media.api-sports.io/football/teams/33.png"},\
 "players": [\
 {\
 "id": 20319,\
 "name": "N. Bishop",\
 "age": 22,\
 "number": 30,\
 "position": "Goalkeeper",\
 "photo": "https://media.api-sports.io/football/players/20319.png"},\
 {\
 "id": 882,\
 "name": "David de Gea",\
 "age": 31,\
 "number": 1,\
 "position": "Goalkeeper",\
 "photo": "https://media.api-sports.io/football/players/882.png"},\
 {\
 "id": 883,\
 "name": "L. Grant",\
 "age": 38,\
 "number": 13,\
 "position": "Goalkeeper",\
 "photo": "https://media.api-sports.io/football/players/883.png"},\
 {\
 "id": 2931,\
 "name": "T. Heaton",\
 "age": 35,\
 "number": null,\
 "position": "Goalkeeper",\
 "photo": "https://media.api-sports.io/football/players/2931.png"},\
 {\
 "id": 19088,\
 "name": "D. Henderson",\
 "age": 24,\
 "number": 26,\
 "position": "Goalkeeper",\
 "photo": "https://media.api-sports.io/football/players/19088.png"},\
 {\
 "id": 885,\
 "name": "E. Bailly",\
 "age": 27,\
 "number": 3,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/885.png"},\
 {\
 "id": 886,\
 "name": "Diogo Dalot",\
 "age": 22,\
 "number": 20,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/886.png"},\
 {\
 "id": 153434,\
 "name": "W. Fish",\
 "age": 18,\
 "number": 48,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/153434.png"},\
 {\
 "id": 888,\
 "name": "P. Jones",\
 "age": 29,\
 "number": 4,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/888.png"},\
 {\
 "id": 138775,\
 "name": "E. Laird",\
 "age": 20,\
 "number": null,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/138775.png"},\
 {\
 "id": 2935,\
 "name": "H. Maguire",\
 "age": 28,\
 "number": 5,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/2935.png"},\
 {\
 "id": 889,\
 "name": "V. Lindelöf",\
 "age": 27,\
 "number": 2,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/889.png"},\
 {\
 "id": 891,\
 "name": "L. Shaw",\
 "age": 26,\
 "number": 23,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/891.png"},\
 {\
 "id": 378,\
 "name": "Alex Telles",\
 "age": 29,\
 "number": 27,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/378.png"},\
 {\
 "id": 19182,\
 "name": "A. Tuanzebe",\
 "age": 24,\
 "number": 38,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/19182.png"},\
 {\
 "id": 18846,\
 "name": "A. Wan-Bissaka",\
 "age": 24,\
 "number": 29,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/18846.png"},\
 {\
 "id": 138806,\
 "name": "B. Williams",\
 "age": 21,\
 "number": 33,\
 "position": "Defender",\
 "photo": "https://media.api-sports.io/football/players/138806.png"},\
 {\
 "id": 1485,\
 "name": "Bruno Fernandes",\
 "age": 27,\
 "number": 18,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/1485.png"},\
 {\
 "id": 906,\
 "name": "T. Chong",\
 "age": 22,\
 "number": 44,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/906.png"},\
 {\
 "id": 895,\
 "name": "J. Garner",\
 "age": 20,\
 "number": null,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/895.png"},\
 {\
 "id": 899,\
 "name": "Andreas Pereira",\
 "age": 25,\
 "number": 15,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/899.png"},\
 {\
 "id": 900,\
 "name": "J. Lingard",\
 "age": 29,\
 "number": 14,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/900.png"},\
 {\
 "id": 901,\
 "name": "Mata",\
 "age": 33,\
 "number": 8,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/901.png"},\
 {\
 "id": 902,\
 "name": "N. Matić",\
 "age": 33,\
 "number": 31,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/902.png"},\
 {\
 "id": 903,\
 "name": "S. McTominay",\
 "age": 25,\
 "number": 39,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/903.png"},\
 {\
 "id": 180560,\
 "name": "H. Mejbri",\
 "age": 18,\
 "number": 46,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/180560.png"},\
 {\
 "id": 904,\
 "name": "P. Pogba",\
 "age": 28,\
 "number": 6,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/904.png"},\
 {\
 "id": 905,\
 "name": "Fred",\
 "age": 28,\
 "number": 17,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/905.png"},\
 {\
 "id": 163054,\
 "name": "S. Shoretire",\
 "age": 17,\
 "number": 74,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/163054.png"},\
 {\
 "id": 547,\
 "name": "D. van de Beek",\
 "age": 24,\
 "number": 34,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/547.png"},\
 {\
 "id": 138814,\
 "name": "E. Galbraith",\
 "age": 20,\
 "number": null,\
 "position": "Midfielder",\
 "photo": "https://media.api-sports.io/football/players/138814.png"},\
 {\
 "id": 274,\
 "name": "E. Cavani",\
 "age": 34,\
 "number": 7,\
 "position": "Attacker",\
 "photo": "https://media.api-sports.io/football/players/274.png"},\
 {\
 "id": 153430,\
 "name": "A. Elanga",\
 "age": 19,\
 "number": 56,\
 "position": "Attacker",\
 "photo": "https://media.api-sports.io/football/players/153430.png"},\
 {\
 "id": 897,\
 "name": "M. Greenwood",\
 "age": 20,\
 "number": 11,\
 "position": "Attacker",\
 "photo": "https://media.api-sports.io/football/players/897.png"},\
 {\
 "id": 19329,\
 "name": "D. James",\
 "age": 24,\
 "number": 21,\
 "position": "Attacker",\
 "photo": "https://media.api-sports.io/football/players/19329.png"},\
 {\
 "id": 908,\
 "name": "A. Martial",\
 "age": 26,\
 "number": 9,\
 "position": "Attacker",\
 "photo": "https://media.api-sports.io/football/players/908.png"},\
 {\
 "id": 909,\
 "name": "M. Rashford",\
 "age": 24,\
 "number": 10,\
 "position": "Attacker",\
 "photo": "https://media.api-sports.io/football/players/909.png"},\
 {\
 "id": 157997,\
 "name": "A. Diallo",\
 "age": 19,\
 "number": 19,\
 "position": "Attacker",\
 "photo": "https://media.api-sports.io/football/players/157997.png"}]}]}`

 ## [tag/Players/operation/get-players-teams](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players-teams) Teams

 Returns the list of teams and seasons in which the player played during his career.

 **This endpoint requires at least one parameter.**

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per week.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | player<br>required | integer<br>The id of the player |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players/teams

 API-SPORTS

 https://v3.football.api-sports.io/players/teams

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all teams from one {player}
 get("https://v3.football.api-sports.io/players/teams?player=276");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players/teams",
 "parameters": {
 "player": "276"},
 "errors": [ ],
 "results": 8,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "team": {\
 "id": 6,\
 "name": "Brazil",\
 "logo": "https://media.api-sports.io/football/teams/6.png"},\
 "seasons": [\
 2026,\
 2023,\
 2022,\
 2021,\
 2019,\
 2018,\
 2017,\
 2016,\
 2015,\
 2014,\
 2013,\
 2012,\
 2011,\
 2010]},\
 {\
 "team": {\
 "id": 2932,\
 "name": "Al-Hilal Saudi FC",\
 "logo": "https://media.api-sports.io/football/teams/2932.png"},\
 "seasons": [\
 2024,\
 2023]},\
 {\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "seasons": [\
 2022,\
 2021,\
 2020,\
 2019,\
 2018,\
 2017]},\
 {\
 "team": {\
 "id": 529,\
 "name": "Barcelona",\
 "logo": "https://media.api-sports.io/football/teams/529.png"},\
 "seasons": [\
 2016,\
 2015,\
 2014,\
 2013]},\
 {\
 "team": {\
 "id": 10171,\
 "name": "Brazil  U23",\
 "logo": "https://media.api-sports.io/football/teams/10171.png"},\
 "seasons": [\
 2016,\
 2012]},\
 {\
 "team": {\
 "id": 128,\
 "name": "Santos",\
 "logo": "https://media.api-sports.io/football/teams/128.png"},\
 "seasons": [\
 2012,\
 2011,\
 2010,\
 2009]},\
 {\
 "team": {\
 "id": 16200,\
 "name": "Brazil U20",\
 "logo": "https://media.api-sports.io/football/teams/16200.png"},\
 "seasons": [\
 2011]},\
 {\
 "team": {\
 "id": 12502,\
 "name": "Brazil U17",\
 "logo": "https://media.api-sports.io/football/teams/12502.png"},\
 "seasons": [\
 2009]}]}`

 ## [tag/Players/operation/get-players-topscorers](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players-topscorers) Top Scorers

 Get the 20 best players for a league or cup.

 **How it is calculated:**

 - 1 : The player that has scored the higher number of goals
 - 2 : The player that has scored the fewer number of penalties
 - 3 : The player that has delivered the higher number of goal assists
 - 4 : The player that scored their goals in the higher number of matches
 - 5 : The player that played the fewer minutes
 - 6 : The player that plays for the team placed higher on the table
 - 7 : The player that received the fewer number of red cards
 - 8 : The player that received the fewer number of yellow cards

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | league<br>required | integer<br>The id of the league |
 | season<br>required | integer = 4 characters YYYY<br>The season of the league |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players/topscorers

 API-SPORTS

 https://v3.football.api-sports.io/players/topscorers

 ### Request samples

 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 $client = new http\Client;
 $request = new http\Client\Request;

 $request->setRequestUrl('https://v3.football.api-sports.io/players/topscorers');
 $request->setRequestMethod('GET');
 $request->setQuery(new http\QueryString(array(
 	'season' => '2018',
 	'league' => '61'
 )));

 $request->setHeaders(array(
 	'x-rapidapi-host' => 'v3.football.api-sports.io',
 	'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx'
 ));

 $client->enqueue($request)->send();
 $response = $client->getResponse();

 echo $response->getBody();

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players/topscorers",
 "parameters": {
 "league": "61",
 "season": "2018"},
 "errors": [ ],
 "results": 20,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "player": {\
 "id": 278,\
 "name": "K. Mbappé",\
 "firstname": "Kylian",\
 "lastname": "Mbappé Lottin",\
 "age": 22,\
 "birth": {\
 "date": "1998-12-20",\
 "place": "Paris",\
 "country": "France"},\
 "nationality": "France",\
 "height": "178 cm",\
 "weight": "73 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/278.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2018},\
 "games": {\
 "appearences": 29,\
 "lineups": 24,\
 "minutes": 2340,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.871428",\
 "captain": false},\
 "substitutes": {\
 "in": 5,\
 "out": 1,\
 "bench": 5},\
 "shots": {\
 "total": 122,\
 "on": 68},\
 "goals": {\
 "total": 33,\
 "conceded": null,\
 "assists": 7,\
 "saves": 0},\
 "passes": {\
 "total": 591,\
 "key": 48,\
 "accuracy": 78},\
 "tackles": {\
 "total": 4,\
 "blocks": 0,\
 "interceptions": 4},\
 "duels": {\
 "total": 232,\
 "won": 112},\
 "dribbles": {\
 "attempts": 115,\
 "success": 64,\
 "past": null},\
 "fouls": {\
 "drawn": 39,\
 "committed": 19},\
 "cards": {\
 "yellow": 5,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": 3,\
 "commited": null,\
 "scored": 1,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 3246,\
 "name": "N. Pépé",\
 "firstname": "Nicolas",\
 "lastname": "Pépé",\
 "age": 25,\
 "birth": {\
 "date": "1995-05-29",\
 "place": "Mantes-la-Jolie",\
 "country": "France"},\
 "nationality": "Côte d'Ivoire",\
 "height": "178 cm",\
 "weight": "68 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/3246.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 79,\
 "name": "Lille",\
 "logo": "https://media.api-sports.io/football/teams/79.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2018},\
 "games": {\
 "appearences": 38,\
 "lineups": 37,\
 "minutes": 3332,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.281578",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 9,\
 "bench": 1},\
 "shots": {\
 "total": 118,\
 "on": 61},\
 "goals": {\
 "total": 22,\
 "conceded": null,\
 "assists": 11,\
 "saves": 0},\
 "passes": {\
 "total": 946,\
 "key": 70,\
 "accuracy": 78},\
 "tackles": {\
 "total": 9,\
 "blocks": 0,\
 "interceptions": 12},\
 "duels": {\
 "total": 556,\
 "won": 279},\
 "dribbles": {\
 "attempts": 182,\
 "success": 102,\
 "past": null},\
 "fouls": {\
 "drawn": 108,\
 "committed": 24},\
 "cards": {\
 "yellow": 1,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": 5,\
 "commited": null,\
 "scored": 9,\
 "missed": 1,\
 "saved": null}}]}]}`

 ## [tag/Players/operation/get-players-topassists](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players-topassists) Top Assists

 Get the 20 best players assists for a league or cup.

 **How it is calculated:**

 - 1 : The player that has delivered the higher number of goal assists
 - 2 : The player that has scored the higher number of goals
 - 3 : The player that has scored the fewer number of penalties
 - 4 : The player that assists in the higher number of matches
 - 5 : The player that played the fewer minutes
 - 6 : The player that received the fewer number of red cards
 - 7 : The player that received the fewer number of yellow cards

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | league<br>required | integer<br>The id of the league |
 | season<br>required | integer = 4 characters YYYY<br>The season of the league |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players/topassists

 API-SPORTS

 https://v3.football.api-sports.io/players/topassists

 ### Request samples

 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 $client = new http\Client;
 $request = new http\Client\Request;

 $request->setRequestUrl('https://v3.football.api-sports.io/players/topassists');
 $request->setRequestMethod('GET');
 $request->setQuery(new http\QueryString(array(
 	'season' => '2020',
 	'league' => '61'
 )));

 $request->setHeaders(array(
 	'x-rapidapi-host' => 'v3.football.api-sports.io',
 	'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx'
 ));

 $client->enqueue($request)->send();
 $response = $client->getResponse();

 echo $response->getBody();

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players/topassists",
 "parameters": {
 "season": "2020",
 "league": "61"},
 "errors": [ ],
 "results": 20,
 "paging": {
 "current": 0,
 "total": 1},
 "response": [\
 {\
 "player": {\
 "id": 667,\
 "name": "M. Depay",\
 "firstname": "Memphis",\
 "lastname": "Depay",\
 "age": 27,\
 "birth": {\
 "date": "1994-02-13",\
 "place": "Moordrecht",\
 "country": "Netherlands"},\
 "nationality": "Netherlands",\
 "height": "176 cm",\
 "weight": "78 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/667.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 80,\
 "name": "Lyon",\
 "logo": "https://media.api-sports.io/football/teams/80.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 30,\
 "lineups": 26,\
 "minutes": 2313,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.496666",\
 "captain": false},\
 "substitutes": {\
 "in": 4,\
 "out": 12,\
 "bench": 4},\
 "shots": {\
 "total": 72,\
 "on": 39},\
 "goals": {\
 "total": 14,\
 "conceded": 0,\
 "assists": 9,\
 "saves": null},\
 "passes": {\
 "total": 808,\
 "key": 79,\
 "accuracy": 22},\
 "tackles": {\
 "total": 4,\
 "blocks": 1,\
 "interceptions": 4},\
 "duels": {\
 "total": 282,\
 "won": 108},\
 "dribbles": {\
 "attempts": 119,\
 "success": 56,\
 "past": null},\
 "fouls": {\
 "drawn": 38,\
 "committed": 27},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 7,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 22235,\
 "name": "J. Bamba",\
 "firstname": "Jonathan",\
 "lastname": "Bamba",\
 "age": 25,\
 "birth": {\
 "date": "1996-03-26",\
 "place": "Alfortville",\
 "country": "France"},\
 "nationality": "France",\
 "height": "175 cm",\
 "weight": "72 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/22235.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 79,\
 "name": "Lille",\
 "logo": "https://media.api-sports.io/football/teams/79.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 29,\
 "lineups": 27,\
 "minutes": 2379,\
 "number": null,\
 "position": "Attacker",\
 "rating": "6.965517",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 9,\
 "bench": 2},\
 "shots": {\
 "total": 32,\
 "on": 14},\
 "goals": {\
 "total": 6,\
 "conceded": 0,\
 "assists": 8,\
 "saves": null},\
 "passes": {\
 "total": 1186,\
 "key": 52,\
 "accuracy": 37},\
 "tackles": {\
 "total": 35,\
 "blocks": 1,\
 "interceptions": 21},\
 "duels": {\
 "total": 354,\
 "won": 147},\
 "dribbles": {\
 "attempts": 106,\
 "success": 48,\
 "past": null},\
 "fouls": {\
 "drawn": 51,\
 "committed": 23},\
 "cards": {\
 "yellow": 1,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 266,\
 "name": "Á. Di María",\
 "firstname": "Ángel Fabián",\
 "lastname": "Di María Hernández",\
 "age": 33,\
 "birth": {\
 "date": "1988-02-14",\
 "place": "Rosario",\
 "country": "Argentina"},\
 "nationality": "Argentina",\
 "height": "180 cm",\
 "weight": "75 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/266.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 21,\
 "lineups": 19,\
 "minutes": 1507,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "7.547619",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 13,\
 "bench": 2},\
 "shots": {\
 "total": 36,\
 "on": 15},\
 "goals": {\
 "total": 4,\
 "conceded": 0,\
 "assists": 8,\
 "saves": null},\
 "passes": {\
 "total": 781,\
 "key": 54,\
 "accuracy": 30},\
 "tackles": {\
 "total": 21,\
 "blocks": 1,\
 "interceptions": 6},\
 "duels": {\
 "total": 156,\
 "won": 73},\
 "dribbles": {\
 "attempts": 64,\
 "success": 29,\
 "past": null},\
 "fouls": {\
 "drawn": 23,\
 "committed": 9},\
 "cards": {\
 "yellow": 1,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 989,\
 "name": "K. Volland",\
 "firstname": "Kevin",\
 "lastname": "Volland",\
 "age": 29,\
 "birth": {\
 "date": "1992-07-30",\
 "place": "Marktoberdorf",\
 "country": "Germany"},\
 "nationality": "Germany",\
 "height": "178 cm",\
 "weight": "85 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/989.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 91,\
 "name": "Monaco",\
 "logo": "https://media.api-sports.io/football/teams/91.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 28,\
 "lineups": 27,\
 "minutes": 2173,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.082142",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 17,\
 "bench": 1},\
 "shots": {\
 "total": 33,\
 "on": 26},\
 "goals": {\
 "total": 13,\
 "conceded": 0,\
 "assists": 7,\
 "saves": null},\
 "passes": {\
 "total": 592,\
 "key": 27,\
 "accuracy": 14},\
 "tackles": {\
 "total": 26,\
 "blocks": null,\
 "interceptions": 3},\
 "duels": {\
 "total": 282,\
 "won": 120},\
 "dribbles": {\
 "attempts": 35,\
 "success": 15,\
 "past": null},\
 "fouls": {\
 "drawn": 30,\
 "committed": 42},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21592,\
 "name": "G. Laborde",\
 "firstname": "Gaëtan",\
 "lastname": "Laborde",\
 "age": 27,\
 "birth": {\
 "date": "1994-05-03",\
 "place": "Mont-de-Marsan",\
 "country": "France"},\
 "nationality": "France",\
 "height": "182 cm",\
 "weight": "81 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21592.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 82,\
 "name": "Montpellier",\
 "logo": "https://media.api-sports.io/football/teams/82.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 30,\
 "lineups": 30,\
 "minutes": 2597,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.080000",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 11,\
 "bench": 0},\
 "shots": {\
 "total": 63,\
 "on": 32},\
 "goals": {\
 "total": 10,\
 "conceded": 0,\
 "assists": 7,\
 "saves": null},\
 "passes": {\
 "total": 661,\
 "key": 32,\
 "accuracy": 16},\
 "tackles": {\
 "total": 28,\
 "blocks": 3,\
 "interceptions": 12},\
 "duels": {\
 "total": 417,\
 "won": 185},\
 "dribbles": {\
 "attempts": 60,\
 "success": 28,\
 "past": null},\
 "fouls": {\
 "drawn": 24,\
 "committed": 49},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21591,\
 "name": "A. Delort",\
 "firstname": "Andy",\
 "lastname": "Delort",\
 "age": 30,\
 "birth": {\
 "date": "1991-10-09",\
 "place": "Sete",\
 "country": "France"},\
 "nationality": "Algeria",\
 "height": "182 cm",\
 "weight": "82 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21591.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 82,\
 "name": "Montpellier",\
 "logo": "https://media.api-sports.io/football/teams/82.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 21,\
 "lineups": 21,\
 "minutes": 1700,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.495238",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 10,\
 "bench": 0},\
 "shots": {\
 "total": 47,\
 "on": 27},\
 "goals": {\
 "total": 10,\
 "conceded": 0,\
 "assists": 7,\
 "saves": null},\
 "passes": {\
 "total": 511,\
 "key": 40,\
 "accuracy": 16},\
 "tackles": {\
 "total": 8,\
 "blocks": null,\
 "interceptions": 3},\
 "duels": {\
 "total": 284,\
 "won": 139},\
 "dribbles": {\
 "attempts": 41,\
 "success": 19,\
 "past": null},\
 "fouls": {\
 "drawn": 33,\
 "committed": 42},\
 "cards": {\
 "yellow": 4,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 1922,\
 "name": "F. Thauvin",\
 "firstname": "Florian",\
 "lastname": "Thauvin",\
 "age": 28,\
 "birth": {\
 "date": "1993-01-26",\
 "place": "Orleans",\
 "country": "France"},\
 "nationality": "France",\
 "height": "179 cm",\
 "weight": "70 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/1922.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 81,\
 "name": "Marseille",\
 "logo": "https://media.api-sports.io/football/teams/81.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 29,\
 "lineups": 26,\
 "minutes": 2132,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "7.220689",\
 "captain": false},\
 "substitutes": {\
 "in": 3,\
 "out": 17,\
 "bench": 3},\
 "shots": {\
 "total": 39,\
 "on": 15},\
 "goals": {\
 "total": 8,\
 "conceded": 0,\
 "assists": 7,\
 "saves": null},\
 "passes": {\
 "total": 887,\
 "key": 43,\
 "accuracy": 26},\
 "tackles": {\
 "total": 31,\
 "blocks": 0,\
 "interceptions": 11},\
 "duels": {\
 "total": 259,\
 "won": 130},\
 "dribbles": {\
 "attempts": 84,\
 "success": 47,\
 "past": null},\
 "fouls": {\
 "drawn": 42,\
 "committed": 21},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 2,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 109,\
 "name": "A. Golovin",\
 "firstname": "Aleksandr",\
 "lastname": "Golovin",\
 "age": 25,\
 "birth": {\
 "date": "1996-05-30",\
 "place": "Kaltan",\
 "country": "Russia"},\
 "nationality": "Russia",\
 "height": "180 cm",\
 "weight": "69 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/109.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 91,\
 "name": "Monaco",\
 "logo": "https://media.api-sports.io/football/teams/91.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 14,\
 "lineups": 6,\
 "minutes": 609,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "7.400000",\
 "captain": false},\
 "substitutes": {\
 "in": 8,\
 "out": 6,\
 "bench": 8},\
 "shots": {\
 "total": 14,\
 "on": 7},\
 "goals": {\
 "total": 4,\
 "conceded": 0,\
 "assists": 7,\
 "saves": null},\
 "passes": {\
 "total": 244,\
 "key": 27,\
 "accuracy": 22},\
 "tackles": {\
 "total": 17,\
 "blocks": 0,\
 "interceptions": 6},\
 "duels": {\
 "total": 94,\
 "won": 43},\
 "dribbles": {\
 "attempts": 22,\
 "success": 11,\
 "past": null},\
 "fouls": {\
 "drawn": 9,\
 "committed": 9},\
 "cards": {\
 "yellow": 1,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 278,\
 "name": "K. Mbappé",\
 "firstname": "Kylian",\
 "lastname": "Mbappé Lottin",\
 "age": 23,\
 "birth": {\
 "date": "1998-12-20",\
 "place": "Paris",\
 "country": "France"},\
 "nationality": "France",\
 "height": "178 cm",\
 "weight": "73 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/278.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 25,\
 "lineups": 21,\
 "minutes": 1866,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.328000",\
 "captain": false},\
 "substitutes": {\
 "in": 4,\
 "out": 8,\
 "bench": 4},\
 "shots": {\
 "total": 64,\
 "on": 40},\
 "goals": {\
 "total": 20,\
 "conceded": 0,\
 "assists": 6,\
 "saves": null},\
 "passes": {\
 "total": 761,\
 "key": 27,\
 "accuracy": 24},\
 "tackles": {\
 "total": 3,\
 "blocks": 1,\
 "interceptions": 1},\
 "duels": {\
 "total": 259,\
 "won": 113},\
 "dribbles": {\
 "attempts": 143,\
 "success": 72,\
 "past": null},\
 "fouls": {\
 "drawn": 33,\
 "committed": 17},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 5,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 85041,\
 "name": "A. Gouiri",\
 "firstname": "Amine",\
 "lastname": "Gouiri",\
 "age": 21,\
 "birth": {\
 "date": "2000-02-16",\
 "place": "Bourgoin-Jallieu",\
 "country": "France"},\
 "nationality": "France",\
 "height": "180 cm",\
 "weight": "72 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/85041.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 84,\
 "name": "Nice",\
 "logo": "https://media.api-sports.io/football/teams/84.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 29,\
 "lineups": 27,\
 "minutes": 2429,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.227586",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 7,\
 "bench": 2},\
 "shots": {\
 "total": 61,\
 "on": 34},\
 "goals": {\
 "total": 12,\
 "conceded": 0,\
 "assists": 6,\
 "saves": null},\
 "passes": {\
 "total": 905,\
 "key": 44,\
 "accuracy": 28},\
 "tackles": {\
 "total": 24,\
 "blocks": 6,\
 "interceptions": 14},\
 "duels": {\
 "total": 306,\
 "won": 119},\
 "dribbles": {\
 "attempts": 81,\
 "success": 45,\
 "past": null},\
 "fouls": {\
 "drawn": 31,\
 "committed": 42},\
 "cards": {\
 "yellow": 5,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 4,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 663,\
 "name": "M. Terrier",\
 "firstname": "Martin",\
 "lastname": "Terrier",\
 "age": 24,\
 "birth": {\
 "date": "1997-03-04",\
 "place": "Armentières",\
 "country": "France"},\
 "nationality": "France",\
 "height": "184 cm",\
 "weight": "71 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/663.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 94,\
 "name": "Rennes",\
 "logo": "https://media.api-sports.io/football/teams/94.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 22,\
 "minutes": 1821,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.048000",\
 "captain": false},\
 "substitutes": {\
 "in": 4,\
 "out": 15,\
 "bench": 4},\
 "shots": {\
 "total": 27,\
 "on": 10},\
 "goals": {\
 "total": 5,\
 "conceded": 0,\
 "assists": 6,\
 "saves": null},\
 "passes": {\
 "total": 599,\
 "key": 28,\
 "accuracy": 23},\
 "tackles": {\
 "total": 29,\
 "blocks": 0,\
 "interceptions": 15},\
 "duels": {\
 "total": 251,\
 "won": 124},\
 "dribbles": {\
 "attempts": 40,\
 "success": 25,\
 "past": null},\
 "fouls": {\
 "drawn": 30,\
 "committed": 27},\
 "cards": {\
 "yellow": 2,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 1,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 3175,\
 "name": "Z. Ferhat",\
 "firstname": "Zinedine",\
 "lastname": "Ferhat",\
 "age": 28,\
 "birth": {\
 "date": "1993-03-01",\
 "place": "Bordj Menaïel",\
 "country": "Algeria"},\
 "nationality": "Algeria",\
 "height": "183 cm",\
 "weight": "77 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/3175.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 92,\
 "name": "Nimes",\
 "logo": "https://media.api-sports.io/football/teams/92.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 25,\
 "lineups": 25,\
 "minutes": 2244,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "7.076000",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 1,\
 "bench": 0},\
 "shots": {\
 "total": 37,\
 "on": 18},\
 "goals": {\
 "total": 4,\
 "conceded": 0,\
 "assists": 6,\
 "saves": null},\
 "passes": {\
 "total": 809,\
 "key": 39,\
 "accuracy": 27},\
 "tackles": {\
 "total": 28,\
 "blocks": 0,\
 "interceptions": 25},\
 "duels": {\
 "total": 350,\
 "won": 186},\
 "dribbles": {\
 "attempts": 95,\
 "success": 48,\
 "past": null},\
 "fouls": {\
 "drawn": 52,\
 "committed": 18},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 1709,\
 "name": "K. Toko Ekambi",\
 "firstname": "Karl Brillant",\
 "lastname": "Toko Ekambi",\
 "age": 29,\
 "birth": {\
 "date": "1992-09-14",\
 "place": "Paris",\
 "country": "France"},\
 "nationality": "Cameroon",\
 "height": "185 cm",\
 "weight": "74 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/1709.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 80,\
 "name": "Lyon",\
 "logo": "https://media.api-sports.io/football/teams/80.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 27,\
 "lineups": 26,\
 "minutes": 2142,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.259259",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 15,\
 "bench": 1},\
 "shots": {\
 "total": 56,\
 "on": 32},\
 "goals": {\
 "total": 12,\
 "conceded": 0,\
 "assists": 5,\
 "saves": null},\
 "passes": {\
 "total": 663,\
 "key": 40,\
 "accuracy": 22},\
 "tackles": {\
 "total": 12,\
 "blocks": 0,\
 "interceptions": 20},\
 "duels": {\
 "total": 224,\
 "won": 98},\
 "dribbles": {\
 "attempts": 85,\
 "success": 50,\
 "past": null},\
 "fouls": {\
 "drawn": 15,\
 "committed": 20},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 20526,\
 "name": "F. Boulaya",\
 "firstname": "Farid",\
 "lastname": "Boulaya",\
 "age": 28,\
 "birth": {\
 "date": "1993-02-25",\
 "place": "Vitrolles",\
 "country": "France"},\
 "nationality": "Algeria",\
 "height": "179 cm",\
 "weight": "70 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/20526.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 112,\
 "name": "Metz",\
 "logo": "https://media.api-sports.io/football/teams/112.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 26,\
 "minutes": 2309,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "7.496153",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 6,\
 "bench": 1},\
 "shots": {\
 "total": 48,\
 "on": 24},\
 "goals": {\
 "total": 5,\
 "conceded": 0,\
 "assists": 5,\
 "saves": null},\
 "passes": {\
 "total": 1092,\
 "key": 61,\
 "accuracy": 33},\
 "tackles": {\
 "total": 19,\
 "blocks": 2,\
 "interceptions": 9},\
 "duels": {\
 "total": 286,\
 "won": 141},\
 "dribbles": {\
 "attempts": 74,\
 "success": 48,\
 "past": null},\
 "fouls": {\
 "drawn": 51,\
 "committed": 18},\
 "cards": {\
 "yellow": 5,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 1,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 20600,\
 "name": "R. Perraud",\
 "firstname": "Romain",\
 "lastname": "Perraud",\
 "age": 24,\
 "birth": {\
 "date": "1997-09-22",\
 "place": "Toulouse",\
 "country": "France"},\
 "nationality": "France",\
 "height": "173 cm",\
 "weight": "68 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/20600.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 106,\
 "name": "Stade Brestois 29",\
 "logo": "https://media.api-sports.io/football/teams/106.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 27,\
 "lineups": 26,\
 "minutes": 2331,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.970370",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 1,\
 "bench": 1},\
 "shots": {\
 "total": 28,\
 "on": 11},\
 "goals": {\
 "total": 3,\
 "conceded": 0,\
 "assists": 5,\
 "saves": null},\
 "passes": {\
 "total": 1109,\
 "key": 27,\
 "accuracy": 34},\
 "tackles": {\
 "total": 49,\
 "blocks": 3,\
 "interceptions": 34},\
 "duels": {\
 "total": 237,\
 "won": 132},\
 "dribbles": {\
 "attempts": 32,\
 "success": 22,\
 "past": null},\
 "fouls": {\
 "drawn": 42,\
 "committed": 37},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 665,\
 "name": "M. Cornet",\
 "firstname": "Gnaly Maxwel",\
 "lastname": "Cornet",\
 "age": 25,\
 "birth": {\
 "date": "1996-09-27",\
 "place": "Bregbo",\
 "country": "Côte d'Ivoire"},\
 "nationality": "Côte d'Ivoire",\
 "height": "179 cm",\
 "weight": "69 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/665.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 80,\
 "name": "Lyon",\
 "logo": "https://media.api-sports.io/football/teams/80.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 28,\
 "lineups": 22,\
 "minutes": 1867,\
 "number": null,\
 "position": "Attacker",\
 "rating": "6.996428",\
 "captain": false},\
 "substitutes": {\
 "in": 6,\
 "out": 15,\
 "bench": 6},\
 "shots": {\
 "total": 13,\
 "on": 8},\
 "goals": {\
 "total": 2,\
 "conceded": 0,\
 "assists": 5,\
 "saves": null},\
 "passes": {\
 "total": 1044,\
 "key": 23,\
 "accuracy": 32},\
 "tackles": {\
 "total": 56,\
 "blocks": 3,\
 "interceptions": 32},\
 "duels": {\
 "total": 222,\
 "won": 126},\
 "dribbles": {\
 "attempts": 29,\
 "success": 18,\
 "past": null},\
 "fouls": {\
 "drawn": 26,\
 "committed": 26},\
 "cards": {\
 "yellow": 5,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": 1,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 1265,\
 "name": "Y. Adli",\
 "firstname": "Yacine",\
 "lastname": "Adli",\
 "age": 21,\
 "birth": {\
 "date": "2000-07-29",\
 "place": "Vitry-sur-Seine",\
 "country": "France"},\
 "nationality": "France",\
 "height": "186 cm",\
 "weight": "73 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/1265.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 78,\
 "name": "Bordeaux",\
 "logo": "https://media.api-sports.io/football/teams/78.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 16,\
 "minutes": 1622,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.996153",\
 "captain": false},\
 "substitutes": {\
 "in": 10,\
 "out": 8,\
 "bench": 10},\
 "shots": {\
 "total": 10,\
 "on": 5},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": 5,\
 "saves": null},\
 "passes": {\
 "total": 1077,\
 "key": 38,\
 "accuracy": 35},\
 "tackles": {\
 "total": 58,\
 "blocks": 2,\
 "interceptions": 30},\
 "duels": {\
 "total": 265,\
 "won": 137},\
 "dribbles": {\
 "attempts": 56,\
 "success": 36,\
 "past": null},\
 "fouls": {\
 "drawn": 25,\
 "committed": 24},\
 "cards": {\
 "yellow": 6,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21585,\
 "name": "S. Sambia",\
 "firstname": "Salomon Junior",\
 "lastname": "Sambia",\
 "age": 25,\
 "birth": {\
 "date": "1996-09-07",\
 "place": "Lyon",\
 "country": "France"},\
 "nationality": "France",\
 "height": "181 cm",\
 "weight": "68 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21585.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 82,\
 "name": "Montpellier",\
 "logo": "https://media.api-sports.io/football/teams/82.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 28,\
 "lineups": 19,\
 "minutes": 1819,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.818518",\
 "captain": false},\
 "substitutes": {\
 "in": 9,\
 "out": 4,\
 "bench": 10},\
 "shots": {\
 "total": 13,\
 "on": 4},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 5,\
 "saves": null},\
 "passes": {\
 "total": 808,\
 "key": 24,\
 "accuracy": 26},\
 "tackles": {\
 "total": 37,\
 "blocks": 6,\
 "interceptions": 29},\
 "duels": {\
 "total": 228,\
 "won": 126},\
 "dribbles": {\
 "attempts": 53,\
 "success": 26,\
 "past": null},\
 "fouls": {\
 "drawn": 30,\
 "committed": 18},\
 "cards": {\
 "yellow": 1,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 19334,\
 "name": "B. Celina",\
 "firstname": "Bersant",\
 "lastname": "Celina",\
 "age": 25,\
 "birth": {\
 "date": "1996-09-09",\
 "place": "Prizren",\
 "country": "Kosovo"},\
 "nationality": "Kosovo",\
 "height": "181 cm",\
 "weight": null,\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/19334.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 89,\
 "name": "Dijon",\
 "logo": "https://media.api-sports.io/football/teams/89.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 19,\
 "minutes": 1819,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.792307",\
 "captain": false},\
 "substitutes": {\
 "in": 7,\
 "out": 6,\
 "bench": 7},\
 "shots": {\
 "total": 17,\
 "on": 5},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 5,\
 "saves": null},\
 "passes": {\
 "total": 751,\
 "key": 44,\
 "accuracy": 23},\
 "tackles": {\
 "total": 9,\
 "blocks": 1,\
 "interceptions": 4},\
 "duels": {\
 "total": 129,\
 "won": 41},\
 "dribbles": {\
 "attempts": 34,\
 "success": 19,\
 "past": null},\
 "fouls": {\
 "drawn": 12,\
 "committed": 13},\
 "cards": {\
 "yellow": 4,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 2059,\
 "name": "W. Ben Yedder",\
 "firstname": "Wissam",\
 "lastname": "Ben Yedder",\
 "age": 31,\
 "birth": {\
 "date": "1990-08-12",\
 "place": "Sarcelles",\
 "country": "France"},\
 "nationality": "France",\
 "height": "170 cm",\
 "weight": "68 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/2059.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 91,\
 "name": "Monaco",\
 "logo": "https://media.api-sports.io/football/teams/91.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 29,\
 "lineups": 27,\
 "minutes": 2073,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.024137",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 20,\
 "bench": 2},\
 "shots": {\
 "total": 45,\
 "on": 25},\
 "goals": {\
 "total": 13,\
 "conceded": 0,\
 "assists": 4,\
 "saves": null},\
 "passes": {\
 "total": 661,\
 "key": 30,\
 "accuracy": 20},\
 "tackles": {\
 "total": 17,\
 "blocks": 0,\
 "interceptions": 11},\
 "duels": {\
 "total": 224,\
 "won": 97},\
 "dribbles": {\
 "attempts": 49,\
 "success": 23,\
 "past": null},\
 "fouls": {\
 "drawn": 27,\
 "committed": 7},\
 "cards": {\
 "yellow": 2,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 7,\
 "missed": 1,\
 "saved": null}}]}]}`

 ## [tag/Players/operation/get-players-topyellowcards](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players-topyellowcards) Top Yellow Cards

 Get the 20 players with the most yellow cards for a league or cup.

 **How it is calculated:**

 - 1 : The player that received the higher number of yellow cards
 - 2 : The player that received the higher number of red cards
 - 3 : The player that assists in the higher number of matches
 - 4 : The player that played the fewer minutes

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | league<br>required | integer<br>The id of the league |
 | season<br>required | integer = 4 characters YYYY<br>The season of the league |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players/topyellowcards

 API-SPORTS

 https://v3.football.api-sports.io/players/topyellowcards

 ### Request samples

 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 $client = new http\Client;
 $request = new http\Client\Request;

 $request->setRequestUrl('https://v3.football.api-sports.io/players/topyellowcards');
 $request->setRequestMethod('GET');
 $request->setQuery(new http\QueryString(array(
 	'season' => '2020',
 	'league' => '61'
 )));

 $request->setHeaders(array(
 	'x-rapidapi-host' => 'v3.football.api-sports.io',
 	'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx'
 ));

 $client->enqueue($request)->send();
 $response = $client->getResponse();

 echo $response->getBody();

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players/topyellowcards",
 "parameters": {
 "season": "2020",
 "league": "61"},
 "errors": [ ],
 "results": 20,
 "paging": {
 "current": 0,
 "total": 1},
 "response": [\
 {\
 "player": {\
 "id": 8694,\
 "name": "W. Faes",\
 "firstname": "Wout",\
 "lastname": "Faes",\
 "age": 23,\
 "birth": {\
 "date": "1998-04-03",\
 "place": null,\
 "country": "Belgium"},\
 "nationality": "Belgium",\
 "height": "187 cm",\
 "weight": "84 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/8694.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 93,\
 "name": "Reims",\
 "logo": "https://media.api-sports.io/football/teams/93.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 26,\
 "minutes": 2292,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.907692",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 0,\
 "bench": 0},\
 "shots": {\
 "total": 5,\
 "on": 1},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 1228,\
 "key": 0,\
 "accuracy": 43},\
 "tackles": {\
 "total": 25,\
 "blocks": 24,\
 "interceptions": 55},\
 "duels": {\
 "total": 164,\
 "won": 95},\
 "dribbles": {\
 "attempts": 12,\
 "success": 10,\
 "past": null},\
 "fouls": {\
 "drawn": 12,\
 "committed": 16},\
 "cards": {\
 "yellow": 10,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 1689,\
 "name": "Álvaro González",\
 "firstname": "Álvaro",\
 "lastname": "González Soberón",\
 "age": 31,\
 "birth": {\
 "date": "1990-01-08",\
 "place": "Potes",\
 "country": "Spain"},\
 "nationality": "Spain",\
 "height": "182 cm",\
 "weight": "75 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/1689.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 81,\
 "name": "Marseille",\
 "logo": "https://media.api-sports.io/football/teams/81.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 25,\
 "lineups": 25,\
 "minutes": 2204,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.912000",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 3,\
 "bench": 0},\
 "shots": {\
 "total": 9,\
 "on": 2},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": 3,\
 "saves": null},\
 "passes": {\
 "total": 1367,\
 "key": 4,\
 "accuracy": 47},\
 "tackles": {\
 "total": 25,\
 "blocks": 12,\
 "interceptions": 26},\
 "duels": {\
 "total": 160,\
 "won": 91},\
 "dribbles": {\
 "attempts": 3,\
 "success": 3,\
 "past": null},\
 "fouls": {\
 "drawn": 23,\
 "committed": 26},\
 "cards": {\
 "yellow": 10,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 6231,\
 "name": "F. Medina",\
 "firstname": "Facundo Axel",\
 "lastname": "Medina",\
 "age": 22,\
 "birth": {\
 "date": "1999-05-28",\
 "place": "Buenos Aires",\
 "country": "Argentina"},\
 "nationality": "Argentina",\
 "height": "180 cm",\
 "weight": "78 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/6231.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 116,\
 "name": "Lens",\
 "logo": "https://media.api-sports.io/football/teams/116.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 21,\
 "lineups": 20,\
 "minutes": 1769,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.761904",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 1,\
 "bench": 5},\
 "shots": {\
 "total": 7,\
 "on": 4},\
 "goals": {\
 "total": 2,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 1396,\
 "key": 8,\
 "accuracy": 58},\
 "tackles": {\
 "total": 34,\
 "blocks": 7,\
 "interceptions": 34},\
 "duels": {\
 "total": 154,\
 "won": 71},\
 "dribbles": {\
 "attempts": 10,\
 "success": 6,\
 "past": null},\
 "fouls": {\
 "drawn": 7,\
 "committed": 28},\
 "cards": {\
 "yellow": 9,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21635,\
 "name": "J. Gradit",\
 "firstname": "Jonathan",\
 "lastname": "Gradit",\
 "age": 29,\
 "birth": {\
 "date": "1992-11-24",\
 "place": "Talence",\
 "country": "France"},\
 "nationality": "France",\
 "height": "180 cm",\
 "weight": "75 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21635.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 116,\
 "name": "Lens",\
 "logo": "https://media.api-sports.io/football/teams/116.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 26,\
 "minutes": 2198,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.904000",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 5,\
 "bench": 1},\
 "shots": {\
 "total": 1,\
 "on": 0},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 1303,\
 "key": 4,\
 "accuracy": 47},\
 "tackles": {\
 "total": 50,\
 "blocks": 12,\
 "interceptions": 41},\
 "duels": {\
 "total": 271,\
 "won": 162},\
 "dribbles": {\
 "attempts": 35,\
 "success": 24,\
 "past": null},\
 "fouls": {\
 "drawn": 46,\
 "committed": 41},\
 "cards": {\
 "yellow": 8,\
 "yellowred": 1,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 20696,\
 "name": "P. Gueye",\
 "firstname": "Pape Alassane",\
 "lastname": "Gueye",\
 "age": 22,\
 "birth": {\
 "date": "1999-01-24",\
 "place": "Montreuil",\
 "country": "France"},\
 "nationality": "France",\
 "height": "187 cm",\
 "weight": "65 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/20696.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 81,\
 "name": "Marseille",\
 "logo": "https://media.api-sports.io/football/teams/81.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 25,\
 "lineups": 16,\
 "minutes": 1485,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.684000",\
 "captain": false},\
 "substitutes": {\
 "in": 9,\
 "out": 6,\
 "bench": 11},\
 "shots": {\
 "total": 6,\
 "on": 2},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 924,\
 "key": 5,\
 "accuracy": 30},\
 "tackles": {\
 "total": 39,\
 "blocks": 5,\
 "interceptions": 36},\
 "duels": {\
 "total": 216,\
 "won": 106},\
 "dribbles": {\
 "attempts": 9,\
 "success": 4,\
 "past": null},\
 "fouls": {\
 "drawn": 30,\
 "committed": 36},\
 "cards": {\
 "yellow": 8,\
 "yellowred": 1,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 22004,\
 "name": "Moreto Cassamã",\
 "firstname": "Moreto Moro",\
 "lastname": "Cassamã",\
 "age": 23,\
 "birth": {\
 "date": "1998-02-16",\
 "place": "Bissau",\
 "country": "Portugal"},\
 "nationality": "Guinea-Bissau",\
 "height": "165 cm",\
 "weight": "63 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/22004.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 93,\
 "name": "Reims",\
 "logo": "https://media.api-sports.io/football/teams/93.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 23,\
 "lineups": 20,\
 "minutes": 1550,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.760869",\
 "captain": false},\
 "substitutes": {\
 "in": 3,\
 "out": 10,\
 "bench": 5},\
 "shots": {\
 "total": 7,\
 "on": 2},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 1005,\
 "key": 10,\
 "accuracy": 43},\
 "tackles": {\
 "total": 31,\
 "blocks": 5,\
 "interceptions": 33},\
 "duels": {\
 "total": 131,\
 "won": 74},\
 "dribbles": {\
 "attempts": 24,\
 "success": 22,\
 "past": null},\
 "fouls": {\
 "drawn": 18,\
 "committed": 22},\
 "cards": {\
 "yellow": 8,\
 "yellowred": 0,\
 "red": 2},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 1902,\
 "name": "D. Ćaleta-Car",\
 "firstname": "Duje",\
 "lastname": "Ćaleta-Car",\
 "age": 25,\
 "birth": {\
 "date": "1996-09-17",\
 "place": "Šibenik",\
 "country": "Croatia"},\
 "nationality": "Croatia",\
 "height": "192 cm",\
 "weight": "89 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/1902.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 81,\
 "name": "Marseille",\
 "logo": "https://media.api-sports.io/football/teams/81.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 28,\
 "lineups": 27,\
 "minutes": 2423,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.985185",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 2,\
 "bench": 1},\
 "shots": {\
 "total": 9,\
 "on": 3},\
 "goals": {\
 "total": 2,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 1558,\
 "key": 4,\
 "accuracy": 51},\
 "tackles": {\
 "total": 25,\
 "blocks": 20,\
 "interceptions": 39},\
 "duels": {\
 "total": 176,\
 "won": 108},\
 "dribbles": {\
 "attempts": 2,\
 "success": 2,\
 "past": null},\
 "fouls": {\
 "drawn": 14,\
 "committed": 26},\
 "cards": {\
 "yellow": 8,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21504,\
 "name": "D. Ndong",\
 "firstname": "Didier",\
 "lastname": "Ndong Ibrahim",\
 "age": 27,\
 "birth": {\
 "date": "1994-06-17",\
 "place": "Lambaréné",\
 "country": "Gabon"},\
 "nationality": "Gabon",\
 "height": "179 cm",\
 "weight": "75 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21504.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 89,\
 "name": "Dijon",\
 "logo": "https://media.api-sports.io/football/teams/89.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 28,\
 "lineups": 28,\
 "minutes": 2520,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.767857",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 0,\
 "bench": 1},\
 "shots": {\
 "total": 6,\
 "on": 1},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 1370,\
 "key": 10,\
 "accuracy": 46},\
 "tackles": {\
 "total": 52,\
 "blocks": 7,\
 "interceptions": 35},\
 "duels": {\
 "total": 247,\
 "won": 114},\
 "dribbles": {\
 "attempts": 27,\
 "success": 20,\
 "past": null},\
 "fouls": {\
 "drawn": 17,\
 "committed": 38},\
 "cards": {\
 "yellow": 8,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 20531,\
 "name": "H. Maïga",\
 "firstname": "Digbo G'nampa Habib",\
 "lastname": "Maïga",\
 "age": 25,\
 "birth": {\
 "date": "1996-01-01",\
 "place": "Gagnoa",\
 "country": "Côte d'Ivoire"},\
 "nationality": "Côte d'Ivoire",\
 "height": "181 cm",\
 "weight": "80 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/20531.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 112,\
 "name": "Metz",\
 "logo": "https://media.api-sports.io/football/teams/112.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 23,\
 "lineups": 23,\
 "minutes": 2006,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.978260",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 3,\
 "bench": 0},\
 "shots": {\
 "total": 16,\
 "on": 4},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": 3,\
 "saves": null},\
 "passes": {\
 "total": 969,\
 "key": 24,\
 "accuracy": 36},\
 "tackles": {\
 "total": 65,\
 "blocks": 4,\
 "interceptions": 43},\
 "duels": {\
 "total": 290,\
 "won": 155},\
 "dribbles": {\
 "attempts": 40,\
 "success": 29,\
 "past": null},\
 "fouls": {\
 "drawn": 30,\
 "committed": 45},\
 "cards": {\
 "yellow": 8,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 22143,\
 "name": "Y. Cahuzac",\
 "firstname": "Yannick",\
 "lastname": "Cahuzac",\
 "age": 36,\
 "birth": {\
 "date": "1985-01-18",\
 "place": "Ajaccio",\
 "country": "France"},\
 "nationality": "France",\
 "height": "178 cm",\
 "weight": "72 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/22143.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 116,\
 "name": "Lens",\
 "logo": "https://media.api-sports.io/football/teams/116.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 22,\
 "lineups": 18,\
 "minutes": 1561,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.720000",\
 "captain": false},\
 "substitutes": {\
 "in": 4,\
 "out": 6,\
 "bench": 9},\
 "shots": {\
 "total": 3,\
 "on": 1},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 627,\
 "key": 9,\
 "accuracy": 26},\
 "tackles": {\
 "total": 18,\
 "blocks": 4,\
 "interceptions": 24},\
 "duels": {\
 "total": 118,\
 "won": 60},\
 "dribbles": {\
 "attempts": 4,\
 "success": 3,\
 "past": null},\
 "fouls": {\
 "drawn": 15,\
 "committed": 22},\
 "cards": {\
 "yellow": 8,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 1271,\
 "name": "A. Tchouaméni",\
 "firstname": "Aurélien",\
 "lastname": "Tchouaméni",\
 "age": 21,\
 "birth": {\
 "date": "2000-01-27",\
 "place": "Rouen",\
 "country": "France"},\
 "nationality": "France",\
 "height": "185 cm",\
 "weight": "80 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/1271.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 91,\
 "name": "Monaco",\
 "logo": "https://media.api-sports.io/football/teams/91.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 29,\
 "lineups": 29,\
 "minutes": 2450,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "7.175862",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 8,\
 "bench": 0},\
 "shots": {\
 "total": 29,\
 "on": 10},\
 "goals": {\
 "total": 2,\
 "conceded": 0,\
 "assists": 2,\
 "saves": null},\
 "passes": {\
 "total": 1420,\
 "key": 15,\
 "accuracy": 44},\
 "tackles": {\
 "total": 102,\
 "blocks": 10,\
 "interceptions": 50},\
 "duels": {\
 "total": 380,\
 "won": 231},\
 "dribbles": {\
 "attempts": 30,\
 "success": 19,\
 "past": null},\
 "fouls": {\
 "drawn": 46,\
 "committed": 49},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 1,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 22254,\
 "name": "Y. Fofana",\
 "firstname": "Youssouf",\
 "lastname": "Fofana",\
 "age": 22,\
 "birth": {\
 "date": "1999-01-10",\
 "place": null,\
 "country": "France"},\
 "nationality": "France",\
 "height": "178 cm",\
 "weight": null,\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/22254.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 91,\
 "name": "Monaco",\
 "logo": "https://media.api-sports.io/football/teams/91.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 27,\
 "lineups": 27,\
 "minutes": 2204,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.833333",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 7,\
 "bench": 1},\
 "shots": {\
 "total": 16,\
 "on": 3},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 1253,\
 "key": 22,\
 "accuracy": 43},\
 "tackles": {\
 "total": 78,\
 "blocks": 3,\
 "interceptions": 29},\
 "duels": {\
 "total": 265,\
 "won": 137},\
 "dribbles": {\
 "attempts": 44,\
 "success": 22,\
 "past": null},\
 "fouls": {\
 "drawn": 26,\
 "committed": 39},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 1,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 18764,\
 "name": "M. Schneiderlin",\
 "firstname": "Morgan",\
 "lastname": "Schneiderlin",\
 "age": 32,\
 "birth": {\
 "date": "1989-11-08",\
 "place": "Zellwiller",\
 "country": "France"},\
 "nationality": "France",\
 "height": "181 cm",\
 "weight": "75 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/18764.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 84,\
 "name": "Nice",\
 "logo": "https://media.api-sports.io/football/teams/84.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 22,\
 "lineups": 19,\
 "minutes": 1756,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.890909",\
 "captain": false},\
 "substitutes": {\
 "in": 3,\
 "out": 1,\
 "bench": 5},\
 "shots": {\
 "total": 8,\
 "on": 3},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 1250,\
 "key": 10,\
 "accuracy": 53},\
 "tackles": {\
 "total": 40,\
 "blocks": 11,\
 "interceptions": 44},\
 "duels": {\
 "total": 189,\
 "won": 87},\
 "dribbles": {\
 "attempts": 16,\
 "success": 12,\
 "past": null},\
 "fouls": {\
 "drawn": 6,\
 "committed": 37},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 1,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 20654,\
 "name": "F. Centonze",\
 "firstname": "Fabien",\
 "lastname": "Centonze",\
 "age": 25,\
 "birth": {\
 "date": "1996-01-16",\
 "place": "Voiron",\
 "country": "France"},\
 "nationality": "France",\
 "height": "182 cm",\
 "weight": "75 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/20654.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 112,\
 "name": "Metz",\
 "logo": "https://media.api-sports.io/football/teams/112.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 28,\
 "lineups": 28,\
 "minutes": 2502,\
 "number": null,\
 "position": "Defender",\
 "rating": "7.121428",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 1,\
 "bench": 0},\
 "shots": {\
 "total": 13,\
 "on": 4},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 971,\
 "key": 19,\
 "accuracy": 28},\
 "tackles": {\
 "total": 83,\
 "blocks": 15,\
 "interceptions": 90},\
 "duels": {\
 "total": 363,\
 "won": 214},\
 "dribbles": {\
 "attempts": 80,\
 "success": 44,\
 "past": null},\
 "fouls": {\
 "drawn": 43,\
 "committed": 32},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 3339,\
 "name": "C. Doucouré",\
 "firstname": "Cheick Oumar",\
 "lastname": "Doucouré",\
 "age": 21,\
 "birth": {\
 "date": "2000-01-08",\
 "place": "Bamako",\
 "country": "Mali"},\
 "nationality": "Mali",\
 "height": "180 cm",\
 "weight": "73 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/3339.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 116,\
 "name": "Lens",\
 "logo": "https://media.api-sports.io/football/teams/116.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 23,\
 "minutes": 2032,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "7.080000",\
 "captain": false},\
 "substitutes": {\
 "in": 3,\
 "out": 6,\
 "bench": 5},\
 "shots": {\
 "total": 18,\
 "on": 5},\
 "goals": {\
 "total": 2,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 1093,\
 "key": 22,\
 "accuracy": 40},\
 "tackles": {\
 "total": 67,\
 "blocks": 3,\
 "interceptions": 38},\
 "duels": {\
 "total": 227,\
 "won": 129},\
 "dribbles": {\
 "attempts": 37,\
 "success": 31,\
 "past": null},\
 "fouls": {\
 "drawn": 9,\
 "committed": 36},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 179843,\
 "name": "L. Gourna-Douath",\
 "firstname": "Lucas",\
 "lastname": "Gourna-Douath",\
 "age": 18,\
 "birth": {\
 "date": "2003-08-05",\
 "place": null,\
 "country": "France"},\
 "nationality": "France",\
 "height": null,\
 "weight": null,\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/179843.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 1063,\
 "name": "Saint Etienne",\
 "logo": "https://media.api-sports.io/football/teams/1063.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 24,\
 "lineups": 10,\
 "minutes": 1031,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.547619",\
 "captain": false},\
 "substitutes": {\
 "in": 14,\
 "out": 5,\
 "bench": 19},\
 "shots": {\
 "total": 3,\
 "on": null},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 475,\
 "key": 2,\
 "accuracy": 18},\
 "tackles": {\
 "total": 27,\
 "blocks": null,\
 "interceptions": 21},\
 "duels": {\
 "total": 131,\
 "won": 65},\
 "dribbles": {\
 "attempts": 8,\
 "success": 4,\
 "past": null},\
 "fouls": {\
 "drawn": 24,\
 "committed": 27},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 2198,\
 "name": "S. Doumbia",\
 "firstname": "Souleyman",\
 "lastname": "Doumbia",\
 "age": 25,\
 "birth": {\
 "date": "1996-09-24",\
 "place": "Paris",\
 "country": "France"},\
 "nationality": "Côte d'Ivoire",\
 "height": "177 cm",\
 "weight": "73 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/2198.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 77,\
 "name": "Angers",\
 "logo": "https://media.api-sports.io/football/teams/77.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 23,\
 "lineups": 21,\
 "minutes": 1918,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.669565",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 2,\
 "bench": 3},\
 "shots": {\
 "total": 7,\
 "on": 3},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 780,\
 "key": 12,\
 "accuracy": 32},\
 "tackles": {\
 "total": 43,\
 "blocks": 4,\
 "interceptions": 39},\
 "duels": {\
 "total": 175,\
 "won": 94},\
 "dribbles": {\
 "attempts": 32,\
 "success": 20,\
 "past": null},\
 "fouls": {\
 "drawn": 13,\
 "committed": 26},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 22005,\
 "name": "X. Chavalerin",\
 "firstname": "Xavier",\
 "lastname": "Chavalerin",\
 "age": 30,\
 "birth": {\
 "date": "1991-03-07",\
 "place": "Villeurbanne",\
 "country": "France"},\
 "nationality": "France",\
 "height": "178 cm",\
 "weight": "66 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/22005.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 93,\
 "name": "Reims",\
 "logo": "https://media.api-sports.io/football/teams/93.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 22,\
 "lineups": 21,\
 "minutes": 1743,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.966666",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 3,\
 "bench": 1},\
 "shots": {\
 "total": 13,\
 "on": 5},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 2,\
 "saves": null},\
 "passes": {\
 "total": 626,\
 "key": 15,\
 "accuracy": 30},\
 "tackles": {\
 "total": 66,\
 "blocks": 6,\
 "interceptions": 25},\
 "duels": {\
 "total": 185,\
 "won": 98},\
 "dribbles": {\
 "attempts": 19,\
 "success": 13,\
 "past": null},\
 "fouls": {\
 "drawn": 6,\
 "committed": 31},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 103,\
 "name": "J. Aholou",\
 "firstname": "Jean Eudès",\
 "lastname": "Aholou",\
 "age": 27,\
 "birth": {\
 "date": "1994-03-20",\
 "place": "Yopougnon",\
 "country": "Côte d'Ivoire"},\
 "nationality": "Côte d'Ivoire",\
 "height": "186 cm",\
 "weight": "71 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/103.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 95,\
 "name": "Strasbourg",\
 "logo": "https://media.api-sports.io/football/teams/95.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 20,\
 "lineups": 19,\
 "minutes": 1561,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.550000",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 9,\
 "bench": 1},\
 "shots": {\
 "total": 2,\
 "on": 1},\
 "goals": {\
 "total": 2,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 7,\
 "key": 0,\
 "accuracy": 62},\
 "tackles": {\
 "total": 1,\
 "blocks": 0,\
 "interceptions": 1},\
 "duels": {\
 "total": 5,\
 "won": 3},\
 "dribbles": {\
 "attempts": 0,\
 "success": 0,\
 "past": null},\
 "fouls": {\
 "drawn": 1,\
 "committed": 0},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 4399,\
 "name": "H. Boudaoui",\
 "firstname": "Hichem",\
 "lastname": "Boudaoui",\
 "age": 22,\
 "birth": {\
 "date": "1999-09-23",\
 "place": "Béchar",\
 "country": "Algeria"},\
 "nationality": "Algeria",\
 "height": "175 cm",\
 "weight": "61 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/4399.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 84,\
 "name": "Nice",\
 "logo": "https://media.api-sports.io/football/teams/84.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 19,\
 "lineups": 17,\
 "minutes": 1327,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.731578",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 12,\
 "bench": 3},\
 "shots": {\
 "total": 9,\
 "on": 5},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": 2,\
 "saves": null},\
 "passes": {\
 "total": 648,\
 "key": 7,\
 "accuracy": 28},\
 "tackles": {\
 "total": 44,\
 "blocks": 3,\
 "interceptions": 21},\
 "duels": {\
 "total": 200,\
 "won": 93},\
 "dribbles": {\
 "attempts": 29,\
 "success": 18,\
 "past": null},\
 "fouls": {\
 "drawn": 19,\
 "committed": 23},\
 "cards": {\
 "yellow": 7,\
 "yellowred": 0,\
 "red": 0},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]}]}`

 ## [tag/Players/operation/get-players-topredcards](https://www.api-football.com/documentation-v3\#tag/Players/operation/get-players-topredcards) Top Red Cards

 Get the 20 players with the most red cards for a league or cup.

 **How it is calculated:**

 - 1 : The player that received the higher number of red cards
 - 2 : The player that received the higher number of yellow cards
 - 3 : The player that assists in the higher number of matches
 - 4 : The player that played the fewer minutes

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | league<br>required | integer<br>The id of the league |
 | season<br>required | integer = 4 characters YYYY<br>The season of the league |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/players/topredcards

 API-SPORTS

 https://v3.football.api-sports.io/players/topredcards

 ### Request samples

 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 $client = new http\Client;
 $request = new http\Client\Request;

 $request->setRequestUrl('https://v3.football.api-sports.io/players/topredcards');
 $request->setRequestMethod('GET');
 $request->setQuery(new http\QueryString(array(
 	'season' => '2020',
 	'league' => '61'
 )));

 $request->setHeaders(array(
 	'x-rapidapi-host' => 'v3.football.api-sports.io',
 	'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx'
 ));

 $client->enqueue($request)->send();
 $response = $client->getResponse();

 echo $response->getBody();

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "players/topredcards",
 "parameters": {
 "season": "2020",
 "league": "61"},
 "errors": [ ],
 "results": 20,
 "paging": {
 "current": 0,
 "total": 1},
 "response": [\
 {\
 "player": {\
 "id": 22004,\
 "name": "Moreto Cassamã",\
 "firstname": "Moreto Moro",\
 "lastname": "Cassamã",\
 "age": 23,\
 "birth": {\
 "date": "1998-02-16",\
 "place": "Bissau",\
 "country": "Portugal"},\
 "nationality": "Guinea-Bissau",\
 "height": "165 cm",\
 "weight": "63 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/22004.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 93,\
 "name": "Reims",\
 "logo": "https://media.api-sports.io/football/teams/93.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 23,\
 "lineups": 20,\
 "minutes": 1550,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.760869",\
 "captain": false},\
 "substitutes": {\
 "in": 3,\
 "out": 10,\
 "bench": 5},\
 "shots": {\
 "total": 7,\
 "on": 2},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 1005,\
 "key": 10,\
 "accuracy": 43},\
 "tackles": {\
 "total": 31,\
 "blocks": 5,\
 "interceptions": 33},\
 "duels": {\
 "total": 131,\
 "won": 74},\
 "dribbles": {\
 "attempts": 24,\
 "success": 22,\
 "past": null},\
 "fouls": {\
 "drawn": 18,\
 "committed": 22},\
 "cards": {\
 "yellow": 8,\
 "yellowred": 0,\
 "red": 2},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21998,\
 "name": "A. Disasi",\
 "firstname": "Axel",\
 "lastname": "Disasi",\
 "age": 23,\
 "birth": {\
 "date": "1998-03-11",\
 "place": "Gonesse",\
 "country": "France"},\
 "nationality": "France",\
 "height": "190 cm",\
 "weight": "86 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21998.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 91,\
 "name": "Monaco",\
 "logo": "https://media.api-sports.io/football/teams/91.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 22,\
 "lineups": 19,\
 "minutes": 1602,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.747619",\
 "captain": false},\
 "substitutes": {\
 "in": 3,\
 "out": 3,\
 "bench": 8},\
 "shots": {\
 "total": 13,\
 "on": 6},\
 "goals": {\
 "total": 3,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 1180,\
 "key": 4,\
 "accuracy": 47},\
 "tackles": {\
 "total": 21,\
 "blocks": 10,\
 "interceptions": 21},\
 "duels": {\
 "total": 143,\
 "won": 77},\
 "dribbles": {\
 "attempts": 8,\
 "success": 5,\
 "past": null},\
 "fouls": {\
 "drawn": 12,\
 "committed": 21},\
 "cards": {\
 "yellow": 4,\
 "yellowred": 0,\
 "red": 2},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 1912,\
 "name": "D. Payet",\
 "firstname": "Dimitri",\
 "lastname": "Payet",\
 "age": 34,\
 "birth": {\
 "date": "1987-03-29",\
 "place": "Saint-Pierre",\
 "country": "Réunion"},\
 "nationality": "France",\
 "height": "175 cm",\
 "weight": "77 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/1912.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 81,\
 "name": "Marseille",\
 "logo": "https://media.api-sports.io/football/teams/81.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 25,\
 "lineups": 20,\
 "minutes": 1716,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.956000",\
 "captain": false},\
 "substitutes": {\
 "in": 5,\
 "out": 11,\
 "bench": 5},\
 "shots": {\
 "total": 21,\
 "on": 9},\
 "goals": {\
 "total": 4,\
 "conceded": 0,\
 "assists": 4,\
 "saves": null},\
 "passes": {\
 "total": 816,\
 "key": 45,\
 "accuracy": 25},\
 "tackles": {\
 "total": 17,\
 "blocks": 2,\
 "interceptions": 4},\
 "duels": {\
 "total": 156,\
 "won": 81},\
 "dribbles": {\
 "attempts": 46,\
 "success": 28,\
 "past": null},\
 "fouls": {\
 "drawn": 32,\
 "committed": 11},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 2},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 1,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21571,\
 "name": "Hilton",\
 "firstname": "Vitorino",\
 "lastname": "Hilton da Silva",\
 "age": 44,\
 "birth": {\
 "date": "1977-09-13",\
 "place": "Brasília",\
 "country": "Brazil"},\
 "nationality": "Brazil",\
 "height": "180 cm",\
 "weight": "78 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21571.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 82,\
 "name": "Montpellier",\
 "logo": "https://media.api-sports.io/football/teams/82.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 22,\
 "lineups": 18,\
 "minutes": 1537,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.588888",\
 "captain": false},\
 "substitutes": {\
 "in": 4,\
 "out": 0,\
 "bench": 7},\
 "shots": {\
 "total": 10,\
 "on": 3},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 808,\
 "key": null,\
 "accuracy": 33},\
 "tackles": {\
 "total": 10,\
 "blocks": 19,\
 "interceptions": 27},\
 "duels": {\
 "total": 91,\
 "won": 49},\
 "dribbles": {\
 "attempts": 1,\
 "success": 1,\
 "past": null},\
 "fouls": {\
 "drawn": 10,\
 "committed": 15},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 2},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 2478,\
 "name": "D. Benedetto",\
 "firstname": "Darío Ismael",\
 "lastname": "Benedetto",\
 "age": 31,\
 "birth": {\
 "date": "1990-05-17",\
 "place": "Berazategui",\
 "country": "Argentina"},\
 "nationality": "Argentina",\
 "height": "177 cm",\
 "weight": "75 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/2478.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 81,\
 "name": "Marseille",\
 "logo": "https://media.api-sports.io/football/teams/81.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 18,\
 "minutes": 1484,\
 "number": null,\
 "position": "Attacker",\
 "rating": "6.553846",\
 "captain": false},\
 "substitutes": {\
 "in": 8,\
 "out": 15,\
 "bench": 8},\
 "shots": {\
 "total": 32,\
 "on": 13},\
 "goals": {\
 "total": 4,\
 "conceded": 0,\
 "assists": 3,\
 "saves": null},\
 "passes": {\
 "total": 310,\
 "key": 13,\
 "accuracy": 9},\
 "tackles": {\
 "total": 5,\
 "blocks": 2,\
 "interceptions": 3},\
 "duels": {\
 "total": 164,\
 "won": 56},\
 "dribbles": {\
 "attempts": 15,\
 "success": 9,\
 "past": null},\
 "fouls": {\
 "drawn": 19,\
 "committed": 17},\
 "cards": {\
 "yellow": 2,\
 "yellowred": 1,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 1,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21433,\
 "name": "F. Miguel",\
 "firstname": "Florian",\
 "lastname": "Miguel",\
 "age": 25,\
 "birth": {\
 "date": "1996-09-01",\
 "place": "Brugge",\
 "country": "France"},\
 "nationality": "France",\
 "height": "179 cm",\
 "weight": "70 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21433.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 92,\
 "name": "Nimes",\
 "logo": "https://media.api-sports.io/football/teams/92.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 19,\
 "lineups": 16,\
 "minutes": 1357,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.783333",\
 "captain": false},\
 "substitutes": {\
 "in": 3,\
 "out": 2,\
 "bench": 10},\
 "shots": {\
 "total": 6,\
 "on": 3},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 714,\
 "key": 1,\
 "accuracy": 35},\
 "tackles": {\
 "total": 13,\
 "blocks": 12,\
 "interceptions": 40},\
 "duels": {\
 "total": 125,\
 "won": 71},\
 "dribbles": {\
 "attempts": 4,\
 "success": 3,\
 "past": null},\
 "fouls": {\
 "drawn": 29,\
 "committed": 14},\
 "cards": {\
 "yellow": 2,\
 "yellowred": 1,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 7,\
 "name": "A. Diallo",\
 "firstname": "Abdou",\
 "lastname": "Diallo",\
 "age": 25,\
 "birth": {\
 "date": "1996-05-04",\
 "place": "Tours",\
 "country": "France"},\
 "nationality": "Senegal",\
 "height": "187 cm",\
 "weight": "79 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/7.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 18,\
 "lineups": 14,\
 "minutes": 1209,\
 "number": null,\
 "position": "Defender",\
 "rating": "7.005882",\
 "captain": false},\
 "substitutes": {\
 "in": 4,\
 "out": 1,\
 "bench": 8},\
 "shots": {\
 "total": 3,\
 "on": null},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 951,\
 "key": 1,\
 "accuracy": 49},\
 "tackles": {\
 "total": 12,\
 "blocks": 8,\
 "interceptions": 22},\
 "duels": {\
 "total": 92,\
 "won": 55},\
 "dribbles": {\
 "attempts": 20,\
 "success": 14,\
 "past": null},\
 "fouls": {\
 "drawn": 8,\
 "committed": 15},\
 "cards": {\
 "yellow": 1,\
 "yellowred": 1,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 8694,\
 "name": "W. Faes",\
 "firstname": "Wout",\
 "lastname": "Faes",\
 "age": 23,\
 "birth": {\
 "date": "1998-04-03",\
 "place": null,\
 "country": "Belgium"},\
 "nationality": "Belgium",\
 "height": "187 cm",\
 "weight": "84 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/8694.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 93,\
 "name": "Reims",\
 "logo": "https://media.api-sports.io/football/teams/93.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 26,\
 "lineups": 26,\
 "minutes": 2292,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.907692",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 0,\
 "bench": 0},\
 "shots": {\
 "total": 5,\
 "on": 1},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 1228,\
 "key": 0,\
 "accuracy": 43},\
 "tackles": {\
 "total": 25,\
 "blocks": 24,\
 "interceptions": 55},\
 "duels": {\
 "total": 164,\
 "won": 95},\
 "dribbles": {\
 "attempts": 12,\
 "success": 10,\
 "past": null},\
 "fouls": {\
 "drawn": 12,\
 "committed": 16},\
 "cards": {\
 "yellow": 10,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 1907,\
 "name": "H. Sakai",\
 "firstname": "Hiroki",\
 "lastname": "Sakai",\
 "age": 31,\
 "birth": {\
 "date": "1990-04-12",\
 "place": "Kashiwa",\
 "country": "Japan"},\
 "nationality": "Japan",\
 "height": "183 cm",\
 "weight": "70 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/1907.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 81,\
 "name": "Marseille",\
 "logo": "https://media.api-sports.io/football/teams/81.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 25,\
 "lineups": 23,\
 "minutes": 2087,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.776000",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 4,\
 "bench": 3},\
 "shots": {\
 "total": 1,\
 "on": 0},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 926,\
 "key": 18,\
 "accuracy": 31},\
 "tackles": {\
 "total": 71,\
 "blocks": 4,\
 "interceptions": 50},\
 "duels": {\
 "total": 250,\
 "won": 133},\
 "dribbles": {\
 "attempts": 21,\
 "success": 7,\
 "past": null},\
 "fouls": {\
 "drawn": 15,\
 "committed": 41},\
 "cards": {\
 "yellow": 6,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21443,\
 "name": "T. Savanier",\
 "firstname": "Téji",\
 "lastname": "Savanier",\
 "age": 30,\
 "birth": {\
 "date": "1991-12-22",\
 "place": "Montpellier",\
 "country": "France"},\
 "nationality": "France",\
 "height": "171 cm",\
 "weight": "62 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21443.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 82,\
 "name": "Montpellier",\
 "logo": "https://media.api-sports.io/football/teams/82.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 22,\
 "lineups": 21,\
 "minutes": 1738,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "7.100000",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 8,\
 "bench": 1},\
 "shots": {\
 "total": 33,\
 "on": 15},\
 "goals": {\
 "total": 5,\
 "conceded": 0,\
 "assists": 4,\
 "saves": null},\
 "passes": {\
 "total": 850,\
 "key": 49,\
 "accuracy": 30},\
 "tackles": {\
 "total": 39,\
 "blocks": 4,\
 "interceptions": 32},\
 "duels": {\
 "total": 322,\
 "won": 149},\
 "dribbles": {\
 "attempts": 70,\
 "success": 41,\
 "past": null},\
 "fouls": {\
 "drawn": 54,\
 "committed": 45},\
 "cards": {\
 "yellow": 6,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 2,\
 "missed": 2,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 941,\
 "name": "L. Benito",\
 "firstname": "Loris",\
 "lastname": "Benito Souto",\
 "age": 29,\
 "birth": {\
 "date": "1992-01-07",\
 "place": "Aarau",\
 "country": "Switzerland"},\
 "nationality": "Switzerland",\
 "height": "184 cm",\
 "weight": "80 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/941.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 78,\
 "name": "Bordeaux",\
 "logo": "https://media.api-sports.io/football/teams/78.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 25,\
 "lineups": 24,\
 "minutes": 2113,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.828000",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 2,\
 "bench": 4},\
 "shots": {\
 "total": 6,\
 "on": 1},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 1240,\
 "key": 11,\
 "accuracy": 45},\
 "tackles": {\
 "total": 35,\
 "blocks": 7,\
 "interceptions": 39},\
 "duels": {\
 "total": 158,\
 "won": 84},\
 "dribbles": {\
 "attempts": 2,\
 "success": 2,\
 "past": null},\
 "fouls": {\
 "drawn": 13,\
 "committed": 32},\
 "cards": {\
 "yellow": 5,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 22232,\
 "name": "Thiago Mendes",\
 "firstname": "Thiago Henrique",\
 "lastname": "Mendes Ribeiro",\
 "age": 29,\
 "birth": {\
 "date": "1992-03-15",\
 "place": "São Luís",\
 "country": "Brazil"},\
 "nationality": "Brazil",\
 "height": "176 cm",\
 "weight": "78 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/22232.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 80,\
 "name": "Lyon",\
 "logo": "https://media.api-sports.io/football/teams/80.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 23,\
 "lineups": 19,\
 "minutes": 1813,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.956521",\
 "captain": false},\
 "substitutes": {\
 "in": 4,\
 "out": 2,\
 "bench": 5},\
 "shots": {\
 "total": 15,\
 "on": 6},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 1220,\
 "key": 22,\
 "accuracy": 46},\
 "tackles": {\
 "total": 32,\
 "blocks": 6,\
 "interceptions": 32},\
 "duels": {\
 "total": 157,\
 "won": 84},\
 "dribbles": {\
 "attempts": 17,\
 "success": 11,\
 "past": null},\
 "fouls": {\
 "drawn": 20,\
 "committed": 22},\
 "cards": {\
 "yellow": 5,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 3080,\
 "name": "M. Munetsi",\
 "firstname": "Marshall Nyasha",\
 "lastname": "Munetsi",\
 "age": 25,\
 "birth": {\
 "date": "1996-06-22",\
 "place": "Bulawayo",\
 "country": "Zimbabwe"},\
 "nationality": "Zimbabwe",\
 "height": "188 cm",\
 "weight": "83 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/3080.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 93,\
 "name": "Reims",\
 "logo": "https://media.api-sports.io/football/teams/93.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 21,\
 "lineups": 15,\
 "minutes": 1386,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.828571",\
 "captain": false},\
 "substitutes": {\
 "in": 6,\
 "out": 3,\
 "bench": 9},\
 "shots": {\
 "total": 9,\
 "on": 3},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 587,\
 "key": 7,\
 "accuracy": 30},\
 "tackles": {\
 "total": 27,\
 "blocks": 17,\
 "interceptions": 51},\
 "duels": {\
 "total": 163,\
 "won": 93},\
 "dribbles": {\
 "attempts": 17,\
 "success": 12,\
 "past": null},\
 "fouls": {\
 "drawn": 15,\
 "committed": 23},\
 "cards": {\
 "yellow": 5,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 3416,\
 "name": "J. Boye",\
 "firstname": "John",\
 "lastname": "Boye",\
 "age": 34,\
 "birth": {\
 "date": "1987-04-23",\
 "place": "Accra",\
 "country": "Ghana"},\
 "nationality": "Ghana",\
 "height": "184 cm",\
 "weight": "73 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/3416.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 112,\
 "name": "Metz",\
 "logo": "https://media.api-sports.io/football/teams/112.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 28,\
 "lineups": 28,\
 "minutes": 2456,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.885714",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 3,\
 "bench": 0},\
 "shots": {\
 "total": 9,\
 "on": 1},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": 2,\
 "saves": null},\
 "passes": {\
 "total": 980,\
 "key": 6,\
 "accuracy": 30},\
 "tackles": {\
 "total": 39,\
 "blocks": 18,\
 "interceptions": 61},\
 "duels": {\
 "total": 188,\
 "won": 99},\
 "dribbles": {\
 "attempts": 3,\
 "success": 3,\
 "past": null},\
 "fouls": {\
 "drawn": 13,\
 "committed": 23},\
 "cards": {\
 "yellow": 4,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21711,\
 "name": "F. Sammaritano",\
 "firstname": "Frédéric",\
 "lastname": "Sammaritano",\
 "age": 35,\
 "birth": {\
 "date": "1986-03-23",\
 "place": "Vannes",\
 "country": "France"},\
 "nationality": "France",\
 "height": "162 cm",\
 "weight": "65 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21711.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 89,\
 "name": "Dijon",\
 "logo": "https://media.api-sports.io/football/teams/89.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 24,\
 "lineups": 9,\
 "minutes": 941,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.604166",\
 "captain": false},\
 "substitutes": {\
 "in": 15,\
 "out": 9,\
 "bench": 18},\
 "shots": {\
 "total": 8,\
 "on": 3},\
 "goals": {\
 "total": 0,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 322,\
 "key": 20,\
 "accuracy": 17},\
 "tackles": {\
 "total": 15,\
 "blocks": 0,\
 "interceptions": 9},\
 "duels": {\
 "total": 107,\
 "won": 49},\
 "dribbles": {\
 "attempts": 23,\
 "success": 14,\
 "past": null},\
 "fouls": {\
 "drawn": 18,\
 "committed": 12},\
 "cards": {\
 "yellow": 4,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21499,\
 "name": "L. Deaux",\
 "firstname": "Lucas",\
 "lastname": "Deaux",\
 "age": 33,\
 "birth": {\
 "date": "1988-12-26",\
 "place": "Reims",\
 "country": "France"},\
 "nationality": "France",\
 "height": "188 cm",\
 "weight": "82 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21499.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 92,\
 "name": "Nimes",\
 "logo": "https://media.api-sports.io/football/teams/92.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 17,\
 "lineups": 15,\
 "minutes": 1347,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.629411",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 2,\
 "bench": 3},\
 "shots": {\
 "total": 10,\
 "on": 4},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 739,\
 "key": 13,\
 "accuracy": 41},\
 "tackles": {\
 "total": 30,\
 "blocks": 3,\
 "interceptions": 16},\
 "duels": {\
 "total": 178,\
 "won": 90},\
 "dribbles": {\
 "attempts": 23,\
 "success": 16,\
 "past": null},\
 "fouls": {\
 "drawn": 15,\
 "committed": 25},\
 "cards": {\
 "yellow": 4,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 6,\
 "name": "L. Balerdi",\
 "firstname": "Leonardo Julián",\
 "lastname": "Balerdi Rossa",\
 "age": 22,\
 "birth": {\
 "date": "1999-01-26",\
 "place": "Villa Mercedes",\
 "country": "Argentina"},\
 "nationality": "Argentina",\
 "height": "187 cm",\
 "weight": "85 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/6.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 81,\
 "name": "Marseille",\
 "logo": "https://media.api-sports.io/football/teams/81.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 13,\
 "lineups": 12,\
 "minutes": 1004,\
 "number": null,\
 "position": "Defender",\
 "rating": "6.476923",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 1,\
 "bench": 16},\
 "shots": {\
 "total": 8,\
 "on": 2},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": null,\
 "saves": null},\
 "passes": {\
 "total": 561,\
 "key": 0,\
 "accuracy": 41},\
 "tackles": {\
 "total": 14,\
 "blocks": 6,\
 "interceptions": 16},\
 "duels": {\
 "total": 114,\
 "won": 48},\
 "dribbles": {\
 "attempts": 5,\
 "success": 2,\
 "past": null},\
 "fouls": {\
 "drawn": 13,\
 "committed": 21},\
 "cards": {\
 "yellow": 4,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 276,\
 "name": "Neymar",\
 "firstname": "Neymar",\
 "lastname": "da Silva Santos Júnior",\
 "age": 29,\
 "birth": {\
 "date": "1992-02-05",\
 "place": "Mogi das Cruzes",\
 "country": "Brazil"},\
 "nationality": "Brazil",\
 "height": "175 cm",\
 "weight": "68 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/276.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 85,\
 "name": "Paris Saint Germain",\
 "logo": "https://media.api-sports.io/football/teams/85.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 11,\
 "lineups": 9,\
 "minutes": 865,\
 "number": null,\
 "position": "Attacker",\
 "rating": "7.490909",\
 "captain": false},\
 "substitutes": {\
 "in": 2,\
 "out": 0,\
 "bench": 2},\
 "shots": {\
 "total": 32,\
 "on": 14},\
 "goals": {\
 "total": 6,\
 "conceded": 0,\
 "assists": 3,\
 "saves": null},\
 "passes": {\
 "total": 552,\
 "key": 32,\
 "accuracy": 39},\
 "tackles": {\
 "total": 8,\
 "blocks": null,\
 "interceptions": 6},\
 "duels": {\
 "total": 216,\
 "won": 111},\
 "dribbles": {\
 "attempts": 99,\
 "success": 57,\
 "past": null},\
 "fouls": {\
 "drawn": 43,\
 "committed": 17},\
 "cards": {\
 "yellow": 4,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 3,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 21097,\
 "name": "Andrei Girotto",\
 "firstname": "Andrei",\
 "lastname": "Girotto",\
 "age": 29,\
 "birth": {\
 "date": "1992-02-17",\
 "place": "Bento Gonçalves",\
 "country": "Brazil"},\
 "nationality": "Brazil",\
 "height": "186 cm",\
 "weight": "73 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/21097.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 83,\
 "name": "Nantes",\
 "logo": "https://media.api-sports.io/football/teams/83.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 27,\
 "lineups": 26,\
 "minutes": 2282,\
 "number": null,\
 "position": "Midfielder",\
 "rating": "6.844444",\
 "captain": false},\
 "substitutes": {\
 "in": 1,\
 "out": 0,\
 "bench": 1},\
 "shots": {\
 "total": 20,\
 "on": 5},\
 "goals": {\
 "total": 1,\
 "conceded": 0,\
 "assists": 1,\
 "saves": null},\
 "passes": {\
 "total": 1278,\
 "key": 10,\
 "accuracy": 40},\
 "tackles": {\
 "total": 58,\
 "blocks": 11,\
 "interceptions": 50},\
 "duels": {\
 "total": 254,\
 "won": 157},\
 "dribbles": {\
 "attempts": 5,\
 "success": 3,\
 "past": null},\
 "fouls": {\
 "drawn": 21,\
 "committed": 25},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": null}}]},\
 {\
 "player": {\
 "id": 20519,\
 "name": "A. Oukidja",\
 "firstname": "Alexandre",\
 "lastname": "Oukidja",\
 "age": 33,\
 "birth": {\
 "date": "1988-07-19",\
 "place": "Nevers",\
 "country": "France"},\
 "nationality": "Algeria",\
 "height": "184 cm",\
 "weight": "79 kg",\
 "injured": false,\
 "photo": "https://media.api-sports.io/football/players/20519.png"},\
 "statistics": [\
 {\
 "team": {\
 "id": 112,\
 "name": "Metz",\
 "logo": "https://media.api-sports.io/football/teams/112.png"},\
 "league": {\
 "id": 61,\
 "name": "Ligue 1",\
 "country": "France",\
 "logo": "https://media.api-sports.io/football/leagues/61.png",\
 "flag": "https://media.api-sports.io/flags/fr.svg",\
 "season": 2020},\
 "games": {\
 "appearences": 27,\
 "lineups": 27,\
 "minutes": 2430,\
 "number": null,\
 "position": "Goalkeeper",\
 "rating": "6.922222",\
 "captain": false},\
 "substitutes": {\
 "in": 0,\
 "out": 1,\
 "bench": 0},\
 "shots": {\
 "total": 0,\
 "on": 0},\
 "goals": {\
 "total": 0,\
 "conceded": 26,\
 "assists": null,\
 "saves": 69},\
 "passes": {\
 "total": 685,\
 "key": 1,\
 "accuracy": 16},\
 "tackles": {\
 "total": null,\
 "blocks": 0,\
 "interceptions": 0},\
 "duels": {\
 "total": 24,\
 "won": 20},\
 "dribbles": {\
 "attempts": 2,\
 "success": 2,\
 "past": null},\
 "fouls": {\
 "drawn": 6,\
 "committed": 0},\
 "cards": {\
 "yellow": 3,\
 "yellowred": 0,\
 "red": 1},\
 "penalty": {\
 "won": null,\
 "commited": null,\
 "scored": 0,\
 "missed": 0,\
 "saved": 2}}]}]}`

 # [tag/Transfers](https://www.api-football.com/documentation-v3\#tag/Transfers) Transfers

 ## [tag/Transfers/operation/get-transfers](https://www.api-football.com/documentation-v3\#tag/Transfers/operation/get-transfers) Transfers

 Get all available transfers for players and teams

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | player | integer<br>The id of the player |
 | team | integer<br>The id of the team |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/transfers

 API-SPORTS

 https://v3.football.api-sports.io/transfers

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all transfers from one {player}
 get("https://v3.football.api-sports.io/transfers?player=35845");

 // Get all transfers from one {team}
 get("https://v3.football.api-sports.io/transfers?team=463");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "transfers",
 "parameters": {
 "player": "35845"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "player": {\
 "id": 35845,\
 "name": "Hernán Darío Burbano"},\
 "update": "2020-02-06T00:08:15+00:00",\
 "transfers": [\
 {\
 "date": "2019-07-15",\
 "type": "Free",\
 "teams": {\
 "in": {\
 "id": 2283,\
 "name": "Atlas",\
 "logo": "https://media.api-sports.io/football/teams/2283.png"},\
 "out": {\
 "id": 2283,\
 "name": "Atlas",\
 "logo": "https://media.api-sports.io/football/teams/2283.png"}}},\
 {\
 "date": "2019-01-01",\
 "type": "N/A",\
 "teams": {\
 "in": {\
 "id": 1937,\
 "name": "Atletico Atlas",\
 "logo": "https://media.api-sports.io/football/teams/1937.png"},\
 "out": {\
 "id": 1139,\
 "name": "Santa Fe",\
 "logo": "https://media.api-sports.io/football/teams/1139.png"}}},\
 {\
 "date": "2018-07-01",\
 "type": "N/A",\
 "teams": {\
 "in": {\
 "id": 1139,\
 "name": "Santa Fe",\
 "logo": "https://media.api-sports.io/football/teams/1139.png"},\
 "out": {\
 "id": 2289,\
 "name": "Leon",\
 "logo": "https://media.api-sports.io/football/teams/2289.png"}}},\
 {\
 "date": "2015-06-11",\
 "type": "N/A",\
 "teams": {\
 "in": {\
 "id": 2289,\
 "name": "Leon",\
 "logo": "https://media.api-sports.io/football/teams/2289.png"},\
 "out": {\
 "id": 2279,\
 "name": "Tigres UANL",\
 "logo": "https://media.api-sports.io/football/teams/2279.png"}}},\
 {\
 "date": "2014-01-01",\
 "type": "N/A",\
 "teams": {\
 "in": {\
 "id": 2279,\
 "name": "Tigres UANL",\
 "logo": "https://media.api-sports.io/football/teams/2279.png"},\
 "out": {\
 "id": 2289,\
 "name": "Leon",\
 "logo": "https://media.api-sports.io/football/teams/2289.png"}}},\
 {\
 "date": "2012-01-01",\
 "type": "N/A",\
 "teams": {\
 "in": {\
 "id": 2289,\
 "name": "Leon",\
 "logo": "https://media.api-sports.io/football/teams/2289.png"},\
 "out": {\
 "id": 1127,\
 "name": "Deportivo Cali",\
 "logo": "https://media.api-sports.io/football/teams/1127.png"}}},\
 {\
 "date": "2011-01-01",\
 "type": "N/A",\
 "teams": {\
 "in": {\
 "id": 1127,\
 "name": "Deportivo Cali",\
 "logo": "https://media.api-sports.io/football/teams/1127.png"},\
 "out": {\
 "id": 1126,\
 "name": "Deportivo Pasto",\
 "logo": "https://media.api-sports.io/football/teams/1126.png"}}},\
 {\
 "date": "2020-01-01",\
 "type": null,\
 "teams": {\
 "in": {\
 "id": 1470,\
 "name": "Cucuta",\
 "logo": "https://media.api-sports.io/football/teams/1470.png"},\
 "out": {\
 "id": 463,\
 "name": "Aldosivi",\
 "logo": "https://media.api-sports.io/football/teams/463.png"}}}]}]}`

 # [tag/Trophies](https://www.api-football.com/documentation-v3\#tag/Trophies) Trophies

 ## [tag/Trophies/operation/get-trophies](https://www.api-football.com/documentation-v3\#tag/Trophies/operation/get-trophies) Trophies

 Get all available trophies for a player or a coach.

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | player | integer<br>The id of the player |
 | players | stringMaximum of 20 players ids<br>Value:"id-id-id"<br>One or more players ids |
 | coach | integer<br>The id of the coach |
 | coachs | stringMaximum of 20 coachs ids<br>Value:"id-id-id"<br>One or more coachs ids |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/trophies

 API-SPORTS

 https://v3.football.api-sports.io/trophies

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all trophies from one {player}
 get("https://v3.football.api-sports.io/trophies?player=276");

 // Get all trophies from several {player} ids
 get("https://v3.football.api-sports.io/trophies?players=276-278");

 // Get all trophies from one {coach}
 get("https://v3.football.api-sports.io/trophies?coach=2");

 // Get all trophies from several {coach} ids
 get("https://v3.football.api-sports.io/trophies?coachs=2-6");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Example

 DefaultWith players or Coachs parameterDefault

 Copy
 Expand all  Collapse all

 `{
 "get": "trophies",
 "parameters": {
 "player": "276"},
 "errors": [ ],
 "results": 38,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "league": "Sudamericano U20",\
 "country": "South-America",\
 "season": "Peru 2011",\
 "place": "Winner"},\
 {\
 "league": "Trophée des Champions",\
 "country": "France",\
 "season": "2019/2020",\
 "place": "Winner"},\
 {\
 "league": "Copa America",\
 "country": "South-America",\
 "season": "2019 Brazil",\
 "place": "Winner"},\
 {\
 "league": "Ligue 1",\
 "country": "France",\
 "season": "2018/2019",\
 "place": "Winner"},\
 {\
 "league": "Coupe de France",\
 "country": "France",\
 "season": "2018/2019",\
 "place": "2nd Place"},\
 {\
 "league": "Trophée des Champions",\
 "country": "France",\
 "season": "2018/2019",\
 "place": "Winner"},\
 {\
 "league": "Ligue 1",\
 "country": "France",\
 "season": "2017/2018",\
 "place": "Winner"},\
 {\
 "league": "Coupe de France",\
 "country": "France",\
 "season": "2017/2018",\
 "place": "Winner"},\
 {\
 "league": "Coupe de la Ligue",\
 "country": "France",\
 "season": "2017/2018",\
 "place": "Winner"},\
 {\
 "league": "La Liga",\
 "country": "Spain",\
 "season": "2016/2017",\
 "place": "2nd Place"}]}`

 # [tag/Sidelined](https://www.api-football.com/documentation-v3\#tag/Sidelined) Sidelined

 ## [tag/Sidelined/operation/get-sidelined](https://www.api-football.com/documentation-v3\#tag/Sidelined/operation/get-sidelined) Sidelined

 Get all available sidelined for a player or a coach.

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | player | integer<br>The id of the player |
 | players | stringMaximum of 20 players ids<br>Value:"id-id-id"<br>One or more players ids |
 | coach | integer<br>The id of the coach |
 | coachs | stringMaximum of 20 coachs ids<br>Value:"id-id-id"<br>One or more coachs ids |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/sidelined

 API-SPORTS

 https://v3.football.api-sports.io/sidelined

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all from one {player}
 get("https://v3.football.api-sports.io/sidelined?player=276");

 // Get all from several {player} ids
 get("https://v3.football.api-sports.io/sidelined?players=276-278-279-280-281-282");

 // Get all from one {coach}
 get("https://v3.football.api-sports.io/sidelined?coach=2");

 // Get all from several {coach} ids
 get("https://v3.football.api-sports.io/sidelined?coachs=2-6-44-77-54-52");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Example

 DefaultWith players or Coachs parameterDefault

 Copy
 Expand all  Collapse all

 `{
 "get": "sidelined",
 "parameters": {
 "player": "276"},
 "errors": [ ],
 "results": 27,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "type": "Suspended",\
 "start": "2020-02-26",\
 "end": "2020-03-01"},\
 {\
 "type": "Hip/Thigh Injury",\
 "start": "2020-02-02",\
 "end": "2020-02-10"},\
 {\
 "type": "Groin/Pelvis Injury",\
 "start": "2019-10-11",\
 "end": "2019-11-20"},\
 {\
 "type": "Ankle/Foot Injury",\
 "start": "2019-08-01",\
 "end": "2019-08-23"},\
 {\
 "type": "Suspended",\
 "start": "2019-05-15",\
 "end": "2019-05-27"},\
 {\
 "type": "Ankle/Foot Injury",\
 "start": "2019-01-24",\
 "end": "2019-04-20"},\
 {\
 "type": "Groin Strain",\
 "start": "2018-12-03",\
 "end": "2019-01-02"},\
 {\
 "type": "Groin Strain",\
 "start": "2018-11-21",\
 "end": "2018-11-27"},\
 {\
 "type": "Broken Toe",\
 "start": "2018-02-26",\
 "end": "2018-05-20"},\
 {\
 "type": "Thigh Muscle Strain",\
 "start": "2018-01-20",\
 "end": "2018-01-25"},\
 {\
 "type": "Rib Injury",\
 "start": "2018-01-11",\
 "end": "2018-01-16"},\
 {\
 "type": "Suspended",\
 "start": "2017-12-05",\
 "end": "2017-12-11"},\
 {\
 "type": "Thigh Muscle Strain",\
 "start": "2017-11-03",\
 "end": "2017-11-15"},\
 {\
 "type": "Suspended",\
 "start": "2017-10-23",\
 "end": "2017-10-28"},\
 {\
 "type": "Ankle/Foot Injury",\
 "start": "2017-09-21",\
 "end": "2017-09-25"},\
 {\
 "type": "Suspended",\
 "start": "2017-04-09",\
 "end": "2017-04-27"},\
 {\
 "type": "Suspended",\
 "start": "2016-12-04",\
 "end": "2016-12-11"},\
 {\
 "type": "Suspended",\
 "start": "2016-03-04",\
 "end": "2016-03-07"},\
 {\
 "type": "Hamstring",\
 "start": "2016-01-21",\
 "end": "2016-01-26"},\
 {\
 "type": "Hamstring",\
 "start": "2015-12-08",\
 "end": "2015-12-16"},\
 {\
 "type": "Virus",\
 "start": "2015-08-09",\
 "end": "2015-08-26"},\
 {\
 "type": "Suspended",\
 "start": "2015-03-01",\
 "end": "2015-03-09"},\
 {\
 "type": "Sprained Ankle",\
 "start": "2014-08-22",\
 "end": "2014-08-29"},\
 {\
 "type": "Vertebral Fracture",\
 "start": "2014-07-05",\
 "end": "2014-08-05"},\
 {\
 "type": "Ankle/Foot Injury",\
 "start": "2014-04-17",\
 "end": "2014-05-10"},\
 {\
 "type": "Sprained Ankle",\
 "start": "2014-01-17",\
 "end": "2014-02-14"},\
 {\
 "type": "Suspended",\
 "start": "2013-12-15",\
 "end": "2013-12-23"}]}`

 # [tag/Odds-(In-Play)](https://www.api-football.com/documentation-v3\#tag/Odds-(In-Play)) Odds (In-Play)

 ## [tag/Odds-(In-Play)/operation/get-odds-live](https://www.api-football.com/documentation-v3\#tag/Odds-(In-Play)/operation/get-odds-live) odds/live

 This endpoint returns in-play odds for fixtures in progress.

 Fixtures are added between 15 and 5 minutes before the start of the fixture. Once the fixture is over they are removed from the endpoint between 5 and 20 minutes. **No history is stored**. So fixtures that are about to start, fixtures in progress and fixtures that have just ended are available in this endpoint.

 **Update Frequency** : This endpoint is updated every 5 seconds. `*`

 `* This value can change in the range of 5 to 60 seconds`

 **INFORMATIONS ABOUT STATUS**

 ```
 "status": {
    "stopped": false, // True if the fixture is stopped by the referee for X reason
    "blocked": false, // True if bets on this fixture are temporarily blocked
    "finished": false // True if the fixture has not started or if it is finished
 },

 ```

 **INFORMATIONS ABOUT VALUES**

 When several identical values exist for the same bet the `main` field is set to `True` for the bet being considered, the others will have the value `False`.

 The `main` field will be set to `True` only if several identical values exist for the same bet.

 When a value is unique for a bet the `main` value will always be `False` or `null`.

 **Example below** :

 ```
 "id": 36,
 "name": "Over/Under Line",
 "values": [\
    {\
        "value": "Over",\
        "odd": "1.975",\
        "handicap": "2",\
        "main": true, // Bet to consider\
        "suspended": false // True if this bet is temporarily suspended\
    },\
    {\
        "value": "Over",\
        "odd": "3.45",\
        "handicap": "2",\
        "main": false, // Bet to no consider\
        "suspended": false\
    },\
 ]

 ```

 ##### query Parameters

 |     |     |
 | --- | --- |
 | fixture | integer<br>The id of the fixture |
 | league | integer (In this endpoint the "season" parameter is ...Show pattern<br>The id of the league |
 | bet | integer<br>The id of the bet |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/odds/live

 API-SPORTS

 https://v3.football.api-sports.io/odds/live

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available odds
 get("https://v3.football.api-sports.io/odds/live");

 // Get all available odds from one {fixture}
 get("https://v3.football.api-sports.io/odds/live?fixture=164327");

 // Get all available odds from one {league}
 get("https://v3.football.api-sports.io/odds/live?league=39");

 // It’s possible to make requests by mixing the available parameters
 get("https://v3.football.api-sports.io/odds/live?bet=4&league=39");
 get("https://v3.football.api-sports.io/odds/live?bet=4&fixture=164327");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "odds/live",
 "parameters": {
 "fixture": "721238"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "fixture": {\
 "id": 721238,\
 "status": {\
 "long": "Second Half",\
 "elapsed": 62,\
 "seconds": "62:14"}},\
 "league": {\
 "id": 30,\
 "season": 2022},\
 "teams": {\
 "home": {\
 "id": 1563,\
 "goals": 1},\
 "away": {\
 "id": 1565,\
 "goals": 0}},\
 "status": {\
 "stopped": false,\
 "blocked": false,\
 "finished": false},\
 "update": "2022-01-27T16:21:01+00:00",\
 "odds": [\
 {\
 "id": 20,\
 "name": "Match Corners",\
 "values": [\
 {\
 "value": "Over",\
 "odd": "2.5",\
 "handicap": "8",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Exactly",\
 "odd": "4.333",\
 "handicap": "8",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "2.2",\
 "handicap": "8",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "9",\
 "handicap": "10",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Exactly",\
 "odd": "7.5",\
 "handicap": "10",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.181",\
 "handicap": "10",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "1.615",\
 "handicap": "7",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Exactly",\
 "odd": "4",\
 "handicap": "7",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "4.333",\
 "handicap": "7",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "1.2",\
 "handicap": "6",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Exactly",\
 "odd": "5.5",\
 "handicap": "6",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "15",\
 "handicap": "6",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "4.5",\
 "handicap": "9",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Exactly",\
 "odd": "5",\
 "handicap": "9",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.5",\
 "handicap": "9",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 33,\
 "name": "Asian Handicap",\
 "values": [\
 {\
 "value": "Home",\
 "odd": "1.475",\
 "handicap": "-1",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "2.6",\
 "handicap": "1",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Home",\
 "odd": "2.05",\
 "handicap": "-1",\
 "main": true,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "1.8",\
 "handicap": "1",\
 "main": true,\
 "suspended": false},\
 {\
 "value": "Home",\
 "odd": "3.8",\
 "handicap": "-2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "1.25",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Home",\
 "odd": "1.3",\
 "handicap": "-1",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "3.45",\
 "handicap": "1",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Home",\
 "odd": "2.85",\
 "handicap": "-1",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "1.4",\
 "handicap": "1",\
 "main": false,\
 "suspended": false}]},\
 {\
 "id": 85,\
 "name": "Which team will score the 2nd goal?",\
 "values": [\
 {\
 "value": "1",\
 "odd": "3.2",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No goal",\
 "odd": "2.2",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2",\
 "odd": "2.875",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 36,\
 "name": "Over/Under Line",\
 "values": [\
 {\
 "value": "Over",\
 "odd": "1.625",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "2.25",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "2.675",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.45",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "3.45",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.3",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "1.975",\
 "handicap": "2",\
 "main": true,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.875",\
 "handicap": "2",\
 "main": true,\
 "suspended": false}]},\
 {\
 "id": 60,\
 "name": "To Score 3 or More",\
 "values": [\
 {\
 "value": "Correa Caio Canedo",\
 "odd": "67",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Al-Somah",\
 "odd": "126",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Khrbin",\
 "odd": "151",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Ali Saleh",\
 "odd": "401",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Tahnoon Al Zaabi",\
 "odd": "501",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mahmood Al Mawas",\
 "odd": "401",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Khalil Ibrahim",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Abdullah Ramadan",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Oliver Kass Kawo",\
 "odd": "501",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Ali Salmeen",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Amro Jenyat",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Fahd Youssef",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Mouhamad Anez",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Abdelaziz Sanqour",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Walid Abbas",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Mohamad Al Attas",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Tamer Haj Mohamad",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Moaiad Al Khouli",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Omar Midani",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Mahmoud Al Hammadi",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true}]},\
 {\
 "id": 23,\
 "name": "Final Score",\
 "values": [\
 {\
 "value": "1-0",\
 "odd": "2.2",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2-0",\
 "odd": "4.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2-1",\
 "odd": "9",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "3-0",\
 "odd": "19",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "3-1",\
 "odd": "34",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "3-2",\
 "odd": "67",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "4-0",\
 "odd": "67",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "4-1",\
 "odd": "101",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "4-2",\
 "odd": "301",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "4-3",\
 "odd": "351",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "5-0",\
 "odd": "301",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "5-1",\
 "odd": "301",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "5-2",\
 "odd": "351",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "6-0",\
 "odd": "351",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "6-1",\
 "odd": "401",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "0-0",\
 "odd": "3.4",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "1-1",\
 "odd": "4.333",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2-2",\
 "odd": "29",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "3-3",\
 "odd": "301",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "0-1",\
 "odd": "5.5",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "0-2",\
 "odd": "17",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "1-2",\
 "odd": "17",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "0-3",\
 "odd": "51",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "1-3",\
 "odd": "51",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2-3",\
 "odd": "81",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "0-4",\
 "odd": "201",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "1-4",\
 "odd": "201",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2-4",\
 "odd": "351",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "3-4",\
 "odd": "351",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "0-5",\
 "odd": "351",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "1-5",\
 "odd": "401",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "2-5",\
 "odd": "401",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "5-3",\
 "odd": "401",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "4-4",\
 "odd": "401",\
 "handicap": null,\
 "main": null,\
 "suspended": true}]},\
 {\
 "id": 29,\
 "name": "Result / Both Teams To Score",\
 "values": [\
 {\
 "value": "Home/Yes",\
 "odd": "8",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Away/Yes",\
 "odd": "17",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Draw/Yes",\
 "odd": "4.333",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Home/No",\
 "odd": "1.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Away/No",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Draw/No",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true}]},\
 {\
 "id": 27,\
 "name": "Home Team Score a Goal (2nd Half)",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "2.625",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.444",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 58,\
 "name": "Home Team Goals",\
 "values": [\
 {\
 "value": "Over",\
 "odd": "2.625",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.444",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "13",\
 "handicap": "3",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.04",\
 "handicap": "3",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 46,\
 "name": "Goal Scorer",\
 "values": [\
 {\
 "value": "Omar Al-Somah",\
 "odd": "7",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Correa Caio Canedo",\
 "odd": "10",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Khrbin",\
 "odd": "8.5",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Ali Saleh",\
 "odd": "12",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mahmood Al Mawas",\
 "odd": "13",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Tahnoon Al Zaabi",\
 "odd": "15",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Khalil Ibrahim",\
 "odd": "19",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Oliver Kass Kawo",\
 "odd": "17",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Abdullah Ramadan",\
 "odd": "23",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Fahd Youssef",\
 "odd": "19",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Amro Jenyat",\
 "odd": "21",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Ali Salmeen",\
 "odd": "23",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mouhamad Anez",\
 "odd": "21",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Tamer Haj Mohamad",\
 "odd": "26",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Abdelaziz Sanqour",\
 "odd": "41",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mahmoud Al Hammadi",\
 "odd": "41",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Walid Abbas",\
 "odd": "41",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Moaiad Al Khouli",\
 "odd": "34",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mohamad Al Attas",\
 "odd": "41",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Midani",\
 "odd": "41",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No 2nd Goal",\
 "odd": "2.2",\
 "handicap": "2",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 21,\
 "name": "3-Way Handicap",\
 "values": [\
 {\
 "value": "Home",\
 "odd": "1.025",\
 "handicap": "1",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Draw",\
 "odd": "19",\
 "handicap": "-1",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "51",\
 "handicap": "-1",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Home",\
 "odd": "51",\
 "handicap": "-3",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Draw",\
 "odd": "17",\
 "handicap": "3",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "1.025",\
 "handicap": "3",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Home",\
 "odd": "15",\
 "handicap": "-2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Draw",\
 "odd": "4.333",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "1.222",\
 "handicap": "2",\
 "main": false,\
 "suspended": false},\
 {\
 "value": "Home",\
 "odd": "3.75",\
 "handicap": "-1",\
 "main": true,\
 "suspended": false},\
 {\
 "value": "Draw",\
 "odd": "1.833",\
 "handicap": "1",\
 "main": true,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "3.4",\
 "handicap": "1",\
 "main": true,\
 "suspended": false}]},\
 {\
 "id": 32,\
 "name": "Asian Corners",\
 "values": [\
 {\
 "value": "Over",\
 "odd": "2.05",\
 "handicap": "8",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.75",\
 "handicap": "8",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 25,\
 "name": "Match Goals",\
 "values": [\
 {\
 "value": "Over",\
 "odd": "11",\
 "handicap": "4",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.05",\
 "handicap": "4",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "1.615",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "2.2",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Over",\
 "odd": "3.75",\
 "handicap": "3",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.25",\
 "handicap": "3",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 35,\
 "name": "To Win 2nd Half",\
 "values": [\
 {\
 "value": "Home",\
 "odd": "3.75",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Draw",\
 "odd": "1.833",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "3.4",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 45,\
 "name": "Race to the 7th corner?",\
 "values": [\
 {\
 "value": "1",\
 "odd": "81",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2",\
 "odd": "3.4",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Neither",\
 "odd": "1.3",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 16,\
 "name": "How many goals will Away Team score?",\
 "values": [\
 {\
 "value": "No goal",\
 "odd": "1.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "1",\
 "odd": "2.75",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2",\
 "odd": "11",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "3 or more",\
 "odd": "41",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 44,\
 "name": "Race to the 9th corner?",\
 "values": [\
 {\
 "value": "1",\
 "odd": "101",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2",\
 "odd": "15",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Neither",\
 "odd": "1.03",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 59,\
 "name": "Fulltime Result",\
 "values": [\
 {\
 "value": "Home",\
 "odd": "1.3",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Draw",\
 "odd": "4.333",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "17",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 72,\
 "name": "Double Chance",\
 "values": [\
 {\
 "value": "Home or Draw",\
 "odd": "1.025",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Away or Draw",\
 "odd": "3.4",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Home or Away",\
 "odd": "1.2",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 66,\
 "name": "Home Team Clean Sheet",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "1.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "2.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 90,\
 "name": "2nd Goal in Interval",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "4.5",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.166",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Yes",\
 "odd": "2.5",\
 "handicap": "80",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.5",\
 "handicap": "80",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 88,\
 "name": "Which team will score the 7th corner? (2 Way)",\
 "values": [\
 {\
 "value": "1",\
 "odd": "2.375",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2",\
 "odd": "1.533",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 68,\
 "name": "Goals Odd/Even",\
 "values": [\
 {\
 "value": "Odd",\
 "odd": "1.615",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Even",\
 "odd": "2.2",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 39,\
 "name": "Away Team Goals",\
 "values": [\
 {\
 "value": "Over",\
 "odd": "11",\
 "handicap": "2",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "1.05",\
 "handicap": "2",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 48,\
 "name": "Draw No Bet",\
 "values": [\
 {\
 "value": "Home",\
 "odd": "1.05",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "11",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 65,\
 "name": "Next 10 Minutes Total",\
 "values": [\
 {\
 "value": "Goals/Over  0.5",\
 "odd": "3.75",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Goals/Under  0.5",\
 "odd": "1.25",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Corners/Over  0.5",\
 "odd": "1.571",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Corners/Under  0.5",\
 "odd": "2.25",\
 "handicap": "70",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 37,\
 "name": "Total Corners",\
 "values": [\
 {\
 "value": "Over",\
 "odd": "1.615",\
 "handicap": "8",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Under",\
 "odd": "2.2",\
 "handicap": "8",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 52,\
 "name": "1x2 - 80 minutes",\
 "values": [\
 {\
 "value": "Home",\
 "odd": "1.142",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Draw",\
 "odd": "5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "41",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 69,\
 "name": "Both Teams to Score",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "2.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 43,\
 "name": "Both Teams To Score (2nd Half)",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "7",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.1",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 56,\
 "name": "1x2 - 70 minutes",\
 "values": [\
 {\
 "value": "Home",\
 "odd": "1.055",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Draw",\
 "odd": "8.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Away",\
 "odd": "151",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 15,\
 "name": "Last Corner",\
 "values": [\
 {\
 "value": "1",\
 "odd": "2.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2",\
 "odd": "1.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 53,\
 "name": "To Score 2 or More",\
 "values": [\
 {\
 "value": "Correa Caio Canedo",\
 "odd": "6.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Al-Somah",\
 "odd": "34",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Khrbin",\
 "odd": "51",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Ali Saleh",\
 "odd": "101",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Tahnoon Al Zaabi",\
 "odd": "101",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mahmood Al Mawas",\
 "odd": "101",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Khalil Ibrahim",\
 "odd": "126",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Abdullah Ramadan",\
 "odd": "151",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Oliver Kass Kawo",\
 "odd": "101",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Ali Salmeen",\
 "odd": "151",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Amro Jenyat",\
 "odd": "126",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Fahd Youssef",\
 "odd": "126",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mouhamad Anez",\
 "odd": "126",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Abdelaziz Sanqour",\
 "odd": "251",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Walid Abbas",\
 "odd": "301",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mohamad Al Attas",\
 "odd": "301",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Tamer Haj Mohamad",\
 "odd": "151",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Moaiad Al Khouli",\
 "odd": "251",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Midani",\
 "odd": "301",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mahmoud Al Hammadi",\
 "odd": "251",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 62,\
 "name": "Last Team to Score (3 way)",\
 "values": [\
 {\
 "value": "1",\
 "odd": "1.363",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No goal",\
 "odd": "3.4",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "2",\
 "odd": "3",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 47,\
 "name": "Away 1st Goal in Interval",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "7.5",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.071",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Yes",\
 "odd": "4",\
 "handicap": "80",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.222",\
 "handicap": "80",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 70,\
 "name": "Away Team Score a Goal (2nd Half)",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "2.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 95,\
 "name": "Home 2nd Goal in Interval",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "8",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.062",\
 "handicap": "70",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Yes",\
 "odd": "4.333",\
 "handicap": "80",\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No",\
 "odd": "1.2",\
 "handicap": "80",\
 "main": null,\
 "suspended": false}]},\
 {\
 "id": 63,\
 "name": "Anytime Goal Scorer",\
 "values": [\
 {\
 "value": "Correa Caio Canedo",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Omar Al-Somah",\
 "odd": "5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Khrbin",\
 "odd": "6",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Ali Saleh",\
 "odd": "8.5",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Tahnoon Al Zaabi",\
 "odd": "11",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mahmood Al Mawas",\
 "odd": "9",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Khalil Ibrahim",\
 "odd": "13",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Abdullah Ramadan",\
 "odd": "17",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Oliver Kass Kawo",\
 "odd": "12",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Ali Salmeen",\
 "odd": "17",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Fahd Youssef",\
 "odd": "13",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Amro Jenyat",\
 "odd": "15",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mouhamad Anez",\
 "odd": "15",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Tamer Haj Mohamad",\
 "odd": "19",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Abdelaziz Sanqour",\
 "odd": "26",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Walid Abbas",\
 "odd": "29",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Mohamad Al Attas",\
 "odd": "29",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Moaiad Al Khouli",\
 "odd": "26",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "Omar Midani",\
 "odd": "29",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No 1st Goal",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "Mahmoud Al Hammadi",\
 "odd": "26",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "No 2nd Goal",\
 "odd": "0",\
 "handicap": null,\
 "main": null,\
 "suspended": true}]},\
 {\
 "id": 67,\
 "name": "How many goals will Home Team score?",\
 "values": [\
 {\
 "value": "No goal",\
 "odd": "2",\
 "handicap": null,\
 "main": null,\
 "suspended": true},\
 {\
 "value": "1",\
 "odd": "1.444",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "2",\
 "odd": "3.25",\
 "handicap": null,\
 "main": null,\
 "suspended": false},\
 {\
 "value": "3 or more",\
 "odd": "13",\
 "handicap": null,\
 "main": null,\
 "suspended": false}]}]}]}`

 ## [tag/Odds-(In-Play)/operation/get-bets](https://www.api-football.com/documentation-v3\#tag/Odds-(In-Play)/operation/get-bets) odds/live/bets

 Get all available bets for in-play odds.

 All bets `id` can be used in endpoint `odds/live` as filters, **but are not compatible with endpoint `odds` for pre-match odds**.

 **Update Frequency** : This endpoint is updated every 60 seconds.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | string<br>The id of the bet name |
 | search | string = 3 characters <br>The name of the bet |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/odds/live/bets

 API-SPORTS

 https://v3.football.api-sports.io/odds/live/bets

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available bets
 get("https://v3.football.api-sports.io/odds/live/bets");

 // Get bet from one {id}
 get("https://v3.football.api-sports.io/odds/live/bets?id=1");

 // Allows you to search for a bet in relation to a bets {name}
 get("https://v3.football.api-sports.io/odds/live/bets?search=winner");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "odds/live/bets",
 "parameters": [ ],
 "errors": [ ],
 "results": 137,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "id": 1,\
 "name": "Over/Under Extra Time"},\
 {\
 "id": 2,\
 "name": "1x2 Extra Time"},\
 {\
 "id": 3,\
 "name": "Extra Time Asian Corners"},\
 {\
 "id": 4,\
 "name": "Extra Time Total Corners (3 Ways) (1st Half)"},\
 {\
 "id": 5,\
 "name": "Extra Time Double Result"},\
 {\
 "id": 6,\
 "name": "Which team will score the 1st goal in extra time?"},\
 {\
 "id": 7,\
 "name": "Extra Time Asian Corners (1st Half)"},\
 {\
 "id": 8,\
 "name": "Method of Victory"},\
 {\
 "id": 9,\
 "name": "Both Teams To Score (ET)"},\
 {\
 "id": 10,\
 "name": "To Qualify"},\
 {\
 "id": 11,\
 "name": "Asian Handicap Extra Time"},\
 {\
 "id": 12,\
 "name": "1x2 Extra Time (1st Half)"},\
 {\
 "id": 13,\
 "name": "Extra Time Total Corners (3 Ways)"},\
 {\
 "id": 14,\
 "name": "Over/Under Extra Time (1st Half)"},\
 {\
 "id": 15,\
 "name": "Last Corner"},\
 {\
 "id": 16,\
 "name": "How many goals will Away Team score?"},\
 {\
 "id": 17,\
 "name": "Asian Handicap (1st Half)"},\
 {\
 "id": 18,\
 "name": "1st Goal in Interval"},\
 {\
 "id": 19,\
 "name": "1x2 (1st Half)"},\
 {\
 "id": 20,\
 "name": "Match Corners"},\
 {\
 "id": 21,\
 "name": "3-Way Handicap"},\
 {\
 "id": 22,\
 "name": "1x2 - 30 minutes"},\
 {\
 "id": 23,\
 "name": "Final Score"},\
 {\
 "id": 24,\
 "name": "Over/Under Line (1st Half)"},\
 {\
 "id": 25,\
 "name": "Match Goals"},\
 {\
 "id": 26,\
 "name": "European Handicap (1st Half)"},\
 {\
 "id": 27,\
 "name": "Home Team Score a Goal (2nd Half)"},\
 {\
 "id": 28,\
 "name": "Home Team  to Score in Both Halves"},\
 {\
 "id": 29,\
 "name": "Result / Both Teams To Score"},\
 {\
 "id": 30,\
 "name": "Both Teams To Score (1st Half)"},\
 {\
 "id": 31,\
 "name": "Total Corners (3way) (2nd Half)"},\
 {\
 "id": 32,\
 "name": "Asian Corners"},\
 {\
 "id": 33,\
 "name": "Asian Handicap"},\
 {\
 "id": 34,\
 "name": "1x2 - 40 minutes"},\
 {\
 "id": 35,\
 "name": "To Win 2nd Half"},\
 {\
 "id": 36,\
 "name": "Over/Under Line"},\
 {\
 "id": 37,\
 "name": "Total Corners"},\
 {\
 "id": 38,\
 "name": "Away Team to Score in Both Halves"},\
 {\
 "id": 39,\
 "name": "Away Team Goals"},\
 {\
 "id": 40,\
 "name": "Total Corners (3 way) (1st Half)"},\
 {\
 "id": 41,\
 "name": "1x2 - 50 minutes"},\
 {\
 "id": 42,\
 "name": "Race to the 3rd corner?"},\
 {\
 "id": 43,\
 "name": "Both Teams To Score (2nd Half)"},\
 {\
 "id": 44,\
 "name": "Race to the 9th corner?"},\
 {\
 "id": 45,\
 "name": "Race to the 7th corner?"},\
 {\
 "id": 46,\
 "name": "Goal Scorer"},\
 {\
 "id": 47,\
 "name": "Away 1st Goal in Interval"},\
 {\
 "id": 48,\
 "name": "Draw No Bet"},\
 {\
 "id": 49,\
 "name": "Over/Under (1st Half)"},\
 {\
 "id": 50,\
 "name": "1x2 - 60 minutes"},\
 {\
 "id": 51,\
 "name": "Asian Corners (1st Half)"},\
 {\
 "id": 52,\
 "name": "1x2 - 80 minutes"},\
 {\
 "id": 53,\
 "name": "To Score 2 or More"},\
 {\
 "id": 54,\
 "name": "Home 1st Goal in Interval"},\
 {\
 "id": 55,\
 "name": "Correct Score (1st Half)"},\
 {\
 "id": 56,\
 "name": "1x2 - 70 minutes"},\
 {\
 "id": 57,\
 "name": "Away Team Clean Sheet"},\
 {\
 "id": 58,\
 "name": "Home Team Goals"},\
 {\
 "id": 59,\
 "name": "Fulltime Result"},\
 {\
 "id": 60,\
 "name": "To Score 3 or More"},\
 {\
 "id": 61,\
 "name": "Race to the 5th corner?"},\
 {\
 "id": 62,\
 "name": "Last Team to Score (3 way)"},\
 {\
 "id": 63,\
 "name": "Anytime Goal Scorer"},\
 {\
 "id": 64,\
 "name": "Half Time/Full Time"},\
 {\
 "id": 65,\
 "name": "Next 10 Minutes Total"},\
 {\
 "id": 66,\
 "name": "Home Team Clean Sheet"},\
 {\
 "id": 67,\
 "name": "How many goals will Home Team score?"},\
 {\
 "id": 68,\
 "name": "Goals Odd/Even"},\
 {\
 "id": 69,\
 "name": "Both Teams to Score"},\
 {\
 "id": 70,\
 "name": "Away Team Score a Goal (2nd Half)"},\
 {\
 "id": 71,\
 "name": "Which team will score the 4th corner? (2 Way)"},\
 {\
 "id": 72,\
 "name": "Double Chance"},\
 {\
 "id": 73,\
 "name": "Which team will score the 1st goal?"},\
 {\
 "id": 74,\
 "name": "Which team will score the 3rd corner? (2 Way)"},\
 {\
 "id": 75,\
 "name": "Which team will score the 2nd corner? (2 Way)"},\
 {\
 "id": 76,\
 "name": "Corners European Handicap"},\
 {\
 "id": 77,\
 "name": "1x2 - 10 minutes"},\
 {\
 "id": 78,\
 "name": "Corners 1x2"},\
 {\
 "id": 79,\
 "name": "1x2 - 20 minutes"},\
 {\
 "id": 80,\
 "name": "Method of 1st Goal"},\
 {\
 "id": 81,\
 "name": "Method of Qualification"},\
 {\
 "id": 82,\
 "name": "Game Won After Penalties Shootout"},\
 {\
 "id": 83,\
 "name": "Game Won In Extra Time"},\
 {\
 "id": 84,\
 "name": "Which team will score the 2nd goal?"},\
 {\
 "id": 85,\
 "name": "Which team will score the 2nd goal?"},\
 {\
 "id": 86,\
 "name": "Which team will score the 6th corner? (2 Way)"},\
 {\
 "id": 87,\
 "name": "Which team will score the 5th corner? (2 Way)"},\
 {\
 "id": 88,\
 "name": "Which team will score the 7th corner? (2 Way)"},\
 {\
 "id": 89,\
 "name": "Which team will score the 9th corner? (2 Way)"},\
 {\
 "id": 90,\
 "name": "2nd Goal in Interval"},\
 {\
 "id": 91,\
 "name": "Away 2nd Goal in Interval"},\
 {\
 "id": 92,\
 "name": "Which team will score the 3rd goal?"},\
 {\
 "id": 93,\
 "name": "Which team will score the 10th corner? (2 Way)"},\
 {\
 "id": 94,\
 "name": "3rd Goal in Interval"},\
 {\
 "id": 95,\
 "name": "Home 2nd Goal in Interval"},\
 {\
 "id": 96,\
 "name": "Asian Handicap Converted Penalties"},\
 {\
 "id": 97,\
 "name": "Sudden Death"},\
 {\
 "id": 98,\
 "name": "Away Penalty Shootout"},\
 {\
 "id": 99,\
 "name": "Home Penalty Shootout"},\
 {\
 "id": 100,\
 "name": "Home Total Converted Penalties"},\
 {\
 "id": 101,\
 "name": "Total Penalties in Shootout"},\
 {\
 "id": 102,\
 "name": "Last Penalty Score/Miss"},\
 {\
 "id": 103,\
 "name": "Correct Score in Shootouts"},\
 {\
 "id": 104,\
 "name": "Total Converted Penalties"},\
 {\
 "id": 105,\
 "name": "Total Converted Penalties - Goal Line"},\
 {\
 "id": 106,\
 "name": "Away Total Converted Penalties"},\
 {\
 "id": 107,\
 "name": "Penalties Shootout Winner"},\
 {\
 "id": 108,\
 "name": "Which team will score the 11th corner? (2 Way)"},\
 {\
 "id": 109,\
 "name": "Which team will score the 4th goal?"},\
 {\
 "id": 110,\
 "name": "Which team will score the 8th corner? (2 Way)"},\
 {\
 "id": 111,\
 "name": "Last Penalty Scorer in Shootout"},\
 {\
 "id": 112,\
 "name": "Which team will score the 5th goal?"},\
 {\
 "id": 113,\
 "name": "Method of 2nd Goal"},\
 {\
 "id": 114,\
 "name": "Which team will score the 13th corner? (2 Way)"},\
 {\
 "id": 115,\
 "name": "Player to be Booked"},\
 {\
 "id": 116,\
 "name": "Action In Next 1 Minutes"},\
 {\
 "id": 117,\
 "name": "First Action In Next 5 Minutes"},\
 {\
 "id": 118,\
 "name": "Player to be Sent Off"},\
 {\
 "id": 119,\
 "name": "Total Cards"},\
 {\
 "id": 120,\
 "name": "Which team will score the 12th corner? (2 Way)"},\
 {\
 "id": 121,\
 "name": "Which team will score the 14th corner? (2 Way)"},\
 {\
 "id": 122,\
 "name": "Which team will score the 15th corner? (2 Way)"},\
 {\
 "id": 123,\
 "name": "Which team will score the 16th corner? (2 Way)"},\
 {\
 "id": 124,\
 "name": "Which team will score the 17th corner? (2 Way)"},\
 {\
 "id": 125,\
 "name": "Home 3rd Goal in Interval"},\
 {\
 "id": 126,\
 "name": "Which team will score the 18th corner? (2 Way)"},\
 {\
 "id": 127,\
 "name": "Which team will score the 6th goal?"},\
 {\
 "id": 128,\
 "name": "Away 3rd Goal in Interval"},\
 {\
 "id": 129,\
 "name": "Which team will score the 2nd goal in extra time?"},\
 {\
 "id": 130,\
 "name": "Method of 3rd Goal"},\
 {\
 "id": 131,\
 "name": "4th Goal in Interval"},\
 {\
 "id": 132,\
 "name": "Which team will score the 7th goal?"},\
 {\
 "id": 133,\
 "name": "Which team will score the 19th corner? (2 Way)"},\
 {\
 "id": 134,\
 "name": "Home 4th Goal in Interval"},\
 {\
 "id": 135,\
 "name": "Away 4th Goal in Interval"},\
 {\
 "id": 136,\
 "name": "5th Goal in Interval"},\
 {\
 "id": 137,\
 "name": "Home 5th Goal in Interval"}]}`

 # [tag/Odds-(Pre-Match)](https://www.api-football.com/documentation-v3\#tag/Odds-(Pre-Match)) Odds (Pre-Match)

 ## [tag/Odds-(Pre-Match)/operation/get-odds](https://www.api-football.com/documentation-v3\#tag/Odds-(Pre-Match)/operation/get-odds) Odds

 Get odds from fixtures, leagues or date.

 This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter.

 > **Pagination** : 10 results per page.

 We provide pre-match odds between 1 and 14 days before the fixture.

 We keep a 7-days history _(The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers)_

 **Update Frequency** : This endpoint is updated every 3 hours.

 **Recommended Calls** : 1 call every 3 hours.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | fixture | integer<br>The id of the fixture |
 | league | integer<br>The id of the league |
 | season | integer = 4 characters YYYY<br>The season of the league |
 | date | stringYYYY-MM-DD<br>A valid date |
 | timezone | string<br>A valid timezone from the endpoint `Timezone` |
 | page | integer<br>Default: 1<br>Use for the pagination |
 | bookmaker | integer<br>The id of the bookmaker |
 | bet | integer<br>The id of the bet |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/odds

 API-SPORTS

 https://v3.football.api-sports.io/odds

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available odds from one {fixture}
 get("https://v3.football.api-sports.io/odds?fixture=164327");

 // Get all available odds from one {league} & {season}
 get("https://v3.football.api-sports.io/odds?league=39&season=2019");

 // Get all available odds from one {date}
 get("https://v3.football.api-sports.io/odds?date=2020-05-15");

 // It’s possible to make requests by mixing the available parameters
 get("https://v3.football.api-sports.io/odds?bookmaker=1&bet=4&league=39&season=2019");
 get("https://v3.football.api-sports.io/odds?bet=4&fixture=164327");
 get("https://v3.football.api-sports.io/odds?bookmaker=1&league=39&season=2019");
 get("https://v3.football.api-sports.io/odds?date=2020-05-15&page=2&bet=4");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "odds",
 "parameters": {
 "fixture": "326090",
 "bookmaker": "6"},
 "errors": [ ],
 "results": 1,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "league": {\
 "id": 116,\
 "name": "Vysshaya Liga",\
 "country": "Belarus",\
 "logo": "https://media.api-sports.io/football/leagues/116.png",\
 "flag": "https://media.api-sports.io/flags/by.svg",\
 "season": 2020},\
 "fixture": {\
 "id": 326090,\
 "timezone": "UTC",\
 "date": "2020-05-15T15:00:00+00:00",\
 "timestamp": 1589554800},\
 "update": "2020-05-15T09:49:32+00:00",\
 "bookmakers": [\
 {\
 "id": 6,\
 "name": "Bwin",\
 "bets": [\
 {\
 "id": 38,\
 "name": "Exact Goals Number",\
 "values": [\
 {\
 "value": 4,\
 "odd": "7.00"},\
 {\
 "value": 3,\
 "odd": "4.40"},\
 {\
 "value": 2,\
 "odd": "3.40"},\
 {\
 "value": "more 8",\
 "odd": "251.00"},\
 {\
 "value": 7,\
 "odd": "101.00"},\
 {\
 "value": "more 5",\
 "odd": "8.00"},\
 {\
 "value": 6,\
 "odd": "31.00"},\
 {\
 "value": 5,\
 "odd": "14.00"},\
 {\
 "value": 0,\
 "odd": "6.25"},\
 {\
 "value": 1,\
 "odd": "3.90"}]},\
 {\
 "id": 20,\
 "name": "Double Chance - First Half",\
 "values": [\
 {\
 "value": "Home/Draw",\
 "odd": "1.20"},\
 {\
 "value": "Home/Away",\
 "odd": "1.75"},\
 {\
 "value": "Draw/Away",\
 "odd": "1.26"}]},\
 {\
 "id": 17,\
 "name": "Total - Away",\
 "values": [\
 {\
 "value": "Under 2.5",\
 "odd": "1.06"},\
 {\
 "value": "Over 2.5",\
 "odd": "7.25"},\
 {\
 "value": "Under 1.5",\
 "odd": "1.33"},\
 {\
 "value": "Over 1.5",\
 "odd": "3.10"}]},\
 {\
 "id": 16,\
 "name": "Total - Home",\
 "values": [\
 {\
 "value": "Under 2.5",\
 "odd": "1.09"},\
 {\
 "value": "Over 2.5",\
 "odd": "6.25"},\
 {\
 "value": "Under 1.5",\
 "odd": "1.40"},\
 {\
 "value": "Over 1.5",\
 "odd": "2.70"}]},\
 {\
 "id": 22,\
 "name": "Odd/Even - First Half",\
 "values": [\
 {\
 "value": "Even",\
 "odd": "1.60"},\
 {\
 "value": "Odd",\
 "odd": "2.20"}]},\
 {\
 "id": 21,\
 "name": "Odd/Even",\
 "values": [\
 {\
 "value": "Even",\
 "odd": "1.80"},\
 {\
 "value": "Odd",\
 "odd": "1.91"}]},\
 {\
 "id": 34,\
 "name": "Both Teams Score - First Half",\
 "values": [\
 {\
 "value": "No",\
 "odd": "1.14"},\
 {\
 "value": "Yes",\
 "odd": "5.00"}]},\
 {\
 "id": 32,\
 "name": "Win Both Halves",\
 "values": [\
 {\
 "value": "Away",\
 "odd": "10.50"},\
 {\
 "value": "Draw",\
 "odd": "1.13"},\
 {\
 "value": "Home",\
 "odd": "8.00"}]},\
 {\
 "id": 12,\
 "name": "Double Chance",\
 "values": [\
 {\
 "value": "Draw/Away",\
 "odd": "1.50"},\
 {\
 "value": "Home/Away",\
 "odd": "1.33"},\
 {\
 "value": "Home/Draw",\
 "odd": "1.36"}]},\
 {\
 "id": 10,\
 "name": "Exact Score",\
 "values": [\
 {\
 "value": "3:4",\
 "odd": "126.00"},\
 {\
 "value": "2:4",\
 "odd": "81.00"},\
 {\
 "value": "2:3",\
 "odd": "36.00"},\
 {\
 "value": "1:4",\
 "odd": "67.00"},\
 {\
 "value": "1:3",\
 "odd": "26.00"},\
 {\
 "value": "1:2",\
 "odd": "11.50"},\
 {\
 "value": "0:4",\
 "odd": "67.00"},\
 {\
 "value": "4:1",\
 "odd": "51.00"},\
 {\
 "value": "4:0",\
 "odd": "51.00"},\
 {\
 "value": "3:2",\
 "odd": "34.00"},\
 {\
 "value": "3:1",\
 "odd": "21.00"},\
 {\
 "value": "3:0",\
 "odd": "23.00"},\
 {\
 "value": "2:1",\
 "odd": "10.50"},\
 {\
 "value": "2:0",\
 "odd": "11.50"},\
 {\
 "value": "1:0",\
 "odd": "7.25"},\
 {\
 "value": "4:2",\
 "odd": "81.00"},\
 {\
 "value": "4:3",\
 "odd": "126.00"},\
 {\
 "value": "0:3",\
 "odd": "31.00"},\
 {\
 "value": "0:2",\
 "odd": "14.00"},\
 {\
 "value": "0:1",\
 "odd": "8.25"},\
 {\
 "value": "4:4",\
 "odd": "151.00"},\
 {\
 "value": "3:3",\
 "odd": "67.00"},\
 {\
 "value": "2:2",\
 "odd": "16.00"},\
 {\
 "value": "1:1",\
 "odd": "6.25"},\
 {\
 "value": "0:0",\
 "odd": "6.25"}]},\
 {\
 "id": 13,\
 "name": "First Half Winner",\
 "values": [\
 {\
 "value": "Home",\
 "odd": "3.20"},\
 {\
 "value": "Draw",\
 "odd": "1.90"},\
 {\
 "value": "Away",\
 "odd": "3.70"}]},\
 {\
 "id": 15,\
 "name": "Team To Score Last",\
 "values": [\
 {\
 "value": "No goal",\
 "odd": "6.25"},\
 {\
 "value": "Away",\
 "odd": "2.15"},\
 {\
 "value": "Home",\
 "odd": "1.95"}]},\
 {\
 "id": 14,\
 "name": "Team To Score First",\
 "values": [\
 {\
 "value": "Away",\
 "odd": "2.15"},\
 {\
 "value": "Draw",\
 "odd": "6.25"},\
 {\
 "value": "Home",\
 "odd": "1.95"}]},\
 {\
 "id": 46,\
 "name": "Exact Goals Number - First Half",\
 "values": [\
 {\
 "value": "more 3",\
 "odd": "8.25"},\
 {\
 "value": 0,\
 "odd": "2.35"},\
 {\
 "value": 1,\
 "odd": "2.60"},\
 {\
 "value": 2,\
 "odd": "4.75"}]},\
 {\
 "id": 25,\
 "name": "Result/Total Goals",\
 "values": [\
 {\
 "value": "Home/Over 2.5",\
 "odd": "4.60"},\
 {\
 "value": "Away/Under 3.5",\
 "odd": "3.50"},\
 {\
 "value": "Home/Under 3.5",\
 "odd": "3.00"},\
 {\
 "value": "Away/Over 3.5",\
 "odd": "12.00"},\
 {\
 "value": "Home/Over 3.5",\
 "odd": "9.25"},\
 {\
 "value": "Away/Over 2.5",\
 "odd": "5.50"},\
 {\
 "value": "Home/Under 2.5",\
 "odd": "4.50"},\
 {\
 "value": "Away/Under 2.5",\
 "odd": "5.25"}]},\
 {\
 "id": 24,\
 "name": "Results/Both Teams Score",\
 "values": [\
 {\
 "value": "Away/No",\
 "odd": "4.40"},\
 {\
 "value": "Draw/No",\
 "odd": "6.25"},\
 {\
 "value": "Home/No",\
 "odd": "3.75"},\
 {\
 "value": "Away/Yes",\
 "odd": "6.50"},\
 {\
 "value": "Draw/Yes",\
 "odd": "4.50"},\
 {\
 "value": "Home/Yes",\
 "odd": "5.50"}]},\
 {\
 "id": 44,\
 "name": "Away Team Score a Goal",\
 "values": [\
 {\
 "value": "No",\
 "odd": "2.55"},\
 {\
 "value": "Yes",\
 "odd": "1.45"}]},\
 {\
 "id": 43,\
 "name": "Home Team Score a Goal",\
 "values": [\
 {\
 "value": "No",\
 "odd": "2.90"},\
 {\
 "value": "Yes",\
 "odd": "1.36"}]},\
 {\
 "id": 40,\
 "name": "Home Team Exact Goals Number",\
 "values": [\
 {\
 "value": 1,\
 "odd": "2.55"},\
 {\
 "value": 2,\
 "odd": "4.20"},\
 {\
 "value": 0,\
 "odd": "2.90"},\
 {\
 "value": "more 3",\
 "odd": "6.25"}]},\
 {\
 "id": 42,\
 "name": "Second Half Exact Goals Number",\
 "values": [\
 {\
 "value": "more 3",\
 "odd": "5.50"},\
 {\
 "value": 0,\
 "odd": "3.00"},\
 {\
 "value": 1,\
 "odd": "2.60"},\
 {\
 "value": 2,\
 "odd": "3.90"}]},\
 {\
 "id": 41,\
 "name": "Away Team Exact Goals Number",\
 "values": [\
 {\
 "value": "more 3",\
 "odd": "7.25"},\
 {\
 "value": 0,\
 "odd": "2.55"},\
 {\
 "value": 1,\
 "odd": "2.50"},\
 {\
 "value": 2,\
 "odd": "4.60"}]},\
 {\
 "id": 7,\
 "name": "HT/FT Double",\
 "values": [\
 {\
 "value": "Home/Home",\
 "odd": "4.20"},\
 {\
 "value": "Draw/Draw",\
 "odd": "4.10"},\
 {\
 "value": "Draw/Away",\
 "odd": "6.75"},\
 {\
 "value": "Home/Away",\
 "odd": "36.00"},\
 {\
 "value": "Home/Draw",\
 "odd": "14.50"},\
 {\
 "value": "Away/Away",\
 "odd": "5.00"},\
 {\
 "value": "Away/Draw",\
 "odd": "14.50"},\
 {\
 "value": "Away/Home",\
 "odd": "31.00"},\
 {\
 "value": "Draw/Home",\
 "odd": "5.75"}]},\
 {\
 "id": 26,\
 "name": "Goals Over/Under - Second Half",\
 "values": [\
 {\
 "value": "Under 3.5",\
 "odd": "1.01"},\
 {\
 "value": "Over 3.5",\
 "odd": "12.00"},\
 {\
 "value": "Over 1.5",\
 "odd": "2.50"},\
 {\
 "value": "Under 1.5",\
 "odd": "1.48"},\
 {\
 "value": "Under 0.5",\
 "odd": "3.00"},\
 {\
 "value": "Over 0.5",\
 "odd": "1.34"},\
 {\
 "value": "Under 2.5",\
 "odd": "1.11"},\
 {\
 "value": "Over 2.5",\
 "odd": "5.50"}]},\
 {\
 "id": 6,\
 "name": "Goals Over/Under First Half",\
 "values": [\
 {\
 "value": "Under 0.5",\
 "odd": "2.35"},\
 {\
 "value": "Over 0.5",\
 "odd": "1.53"},\
 {\
 "value": "Under 2.5",\
 "odd": "1.04"},\
 {\
 "value": "Over 2.5",\
 "odd": "8.25"},\
 {\
 "value": "Under 1.5",\
 "odd": "1.28"},\
 {\
 "value": "Over 1.5",\
 "odd": "3.30"},\
 {\
 "value": "Under 3.5",\
 "odd": "1.01"},\
 {\
 "value": "Over 3.5",\
 "odd": "21.00"}]},\
 {\
 "id": 5,\
 "name": "Goals Over/Under",\
 "values": [\
 {\
 "value": "Under 5.5",\
 "odd": "1.01"},\
 {\
 "value": "Over 3.5",\
 "odd": "4.20"},\
 {\
 "value": "Under 3.5",\
 "odd": "1.19"},\
 {\
 "value": "Over 1.5",\
 "odd": "1.44"},\
 {\
 "value": "Over 5.5",\
 "odd": "15.00"},\
 {\
 "value": "Under 0.5",\
 "odd": "6.25"},\
 {\
 "value": "Over 0.5",\
 "odd": "1.09"},\
 {\
 "value": "Under 2.5",\
 "odd": "1.55"},\
 {\
 "value": "Over 2.5",\
 "odd": "2.35"},\
 {\
 "value": "Under 4.5",\
 "odd": "1.05"},\
 {\
 "value": "Over 4.5",\
 "odd": "8.00"},\
 {\
 "value": "Under 1.5",\
 "odd": "2.60"}]},\
 {\
 "id": 3,\
 "name": "Second Half Winner",\
 "values": [\
 {\
 "value": "Away",\
 "odd": "3.30"},\
 {\
 "value": "Draw",\
 "odd": "2.20"},\
 {\
 "value": "Home",\
 "odd": "2.85"}]},\
 {\
 "id": 2,\
 "name": "Home/Away",\
 "values": [\
 {\
 "value": "Away",\
 "odd": "2.05"},\
 {\
 "value": "Home",\
 "odd": "1.70"}]},\
 {\
 "id": 1,\
 "name": "Match Winner",\
 "values": [\
 {\
 "value": "Away",\
 "odd": "2.95"},\
 {\
 "value": "Draw",\
 "odd": "2.95"},\
 {\
 "value": "Home",\
 "odd": "2.50"}]},\
 {\
 "id": 9,\
 "name": "Handicap Result",\
 "values": [\
 {\
 "value": "Away -2",\
 "odd": "1.13"},\
 {\
 "value": "Draw -2",\
 "odd": "7.00"},\
 {\
 "value": "Home -2",\
 "odd": "12.00"},\
 {\
 "value": "Home -1",\
 "odd": "5.25"},\
 {\
 "value": "Away +2",\
 "odd": "15.00"},\
 {\
 "value": "Draw +2",\
 "odd": "8.25"},\
 {\
 "value": "Home +2",\
 "odd": "1.09"},\
 {\
 "value": "Draw +1",\
 "odd": "4.40"},\
 {\
 "value": "Away +1",\
 "odd": "6.75"},\
 {\
 "value": "Home +1",\
 "odd": "1.36"},\
 {\
 "value": "Draw -1",\
 "odd": "4.00"},\
 {\
 "value": "Away -1",\
 "odd": "1.50"}]},\
 {\
 "id": 30,\
 "name": "Win to Nil - Away",\
 "values": [\
 {\
 "value": "Yes",\
 "odd": "4.40"},\
 {\
 "value": "No",\
 "odd": "1.17"}]},\
 {\
 "id": 29,\
 "name": "Win to Nil - Home",\
 "values": [\
 {\
 "value": "No",\
 "odd": "1.22"},\
 {\
 "value": "Yes",\
 "odd": "3.75"}]},\
 {\
 "id": 8,\
 "name": "Both Teams Score",\
 "values": [\
 {\
 "value": "No",\
 "odd": "1.72"},\
 {\
 "value": "Yes",\
 "odd": "2.00"}]}]}]}]}`

 ## [tag/Odds-(Pre-Match)/operation/get-odds-mapping](https://www.api-football.com/documentation-v3\#tag/Odds-(Pre-Match)/operation/get-odds-mapping) Mapping

 Get the list of available fixtures `id` for the endpoint odds.

 All fixtures, leagues `id` and `date` can be used in endpoint odds as filters.

 This endpoint uses a **pagination system**, you can navigate between the different pages with to the `page` parameter.

 > **Pagination** : 100 results per page.

 **Update Frequency** : This endpoint is updated every day.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | page | integer<br>Default: 1<br>Use for the pagination |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/odds/mapping

 API-SPORTS

 https://v3.football.api-sports.io/odds/mapping

 ### Request samples

 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 $client = new http\Client;
 $request = new http\Client\Request;

 $request->setRequestUrl('https://v3.football.api-sports.io/odds/mapping');
 $request->setRequestMethod('GET');
 $request->setHeaders(array(
 	'x-rapidapi-host' => 'v3.football.api-sports.io',
 	'x-rapidapi-key' => 'XxXxXxXxXxXxXxXxXxXxXxXx'
 ));

 $client->enqueue($request)->send();
 $response = $client->getResponse();

 echo $response->getBody();

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "odds/mapping",
 "parameters": [ ],
 "errors": [ ],
 "results": 129,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "league": {\
 "id": 106,\
 "season": 2019},\
 "fixture": {\
 "id": 154507,\
 "date": "2020-05-29T18:30:00+00:00",\
 "timestamp": 1590777000},\
 "update": "2020-05-15T09:52:28+00:00"},\
 {\
 "league": {\
 "id": 106,\
 "season": 2019},\
 "fixture": {\
 "id": 154508,\
 "date": "2020-05-29T16:00:00+00:00",\
 "timestamp": 1590768000},\
 "update": "2020-05-15T09:52:28+00:00"},\
 {\
 "league": {\
 "id": 271,\
 "season": 2019},\
 "fixture": {\
 "id": 182450,\
 "date": "2020-05-23T13:55:00+00:00",\
 "timestamp": 1590242100},\
 "update": "2020-05-15T09:51:45+00:00"},\
 {\
 "league": {\
 "id": 271,\
 "season": 2019},\
 "fixture": {\
 "id": 182564,\
 "date": "2020-05-27T18:00:00+00:00",\
 "timestamp": 1590602400},\
 "update": "2020-05-15T09:52:17+00:00"}]}`

 ## [tag/Odds-(Pre-Match)/operation/get-bookmakers](https://www.api-football.com/documentation-v3\#tag/Odds-(Pre-Match)/operation/get-bookmakers) Bookmakers

 Get all available bookmakers.

 All bookmakers `id` can be used in endpoint odds as filters.

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | integer<br>The id of the bookmaker |
 | search | string = 3 characters <br>The name of the bookmaker |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/odds/bookmakers

 API-SPORTS

 https://v3.football.api-sports.io/odds/bookmakers

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available bookmakers
 get("https://v3.football.api-sports.io/odds/bookmakers");

 // Get bookmaker from one {id}
 get("https://v3.football.api-sports.io/odds/bookmakers?id=1");

 // Allows you to search for a bookmaker in relation to a bookmakers {name}
 get("https://v3.football.api-sports.io/odds/bookmakers?search=Betfair");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "odds/bookmakers",
 "parameters": [ ],
 "errors": [ ],
 "results": 15,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "id": 1,\
 "name": "10Bet"},\
 {\
 "id": 2,\
 "name": "Marathonbet"},\
 {\
 "id": 3,\
 "name": "Betfair"},\
 {\
 "id": 4,\
 "name": "Pinnacle"},\
 {\
 "id": 5,\
 "name": "Sport Betting Online"},\
 {\
 "id": 6,\
 "name": "Bwin"},\
 {\
 "id": 7,\
 "name": "William Hill"},\
 {\
 "id": 8,\
 "name": "Bet365"},\
 {\
 "id": 9,\
 "name": "Dafabet"},\
 {\
 "id": 10,\
 "name": "Ladbrokes"},\
 {\
 "id": 11,\
 "name": "1xBet"},\
 {\
 "id": 12,\
 "name": "BetFred"},\
 {\
 "id": 13,\
 "name": "188Bet"},\
 {\
 "id": 15,\
 "name": "Interwetten"},\
 {\
 "id": 16,\
 "name": "Unibet"}]}`

 ## [tag/Odds-(Pre-Match)/operation/get-bets](https://www.api-football.com/documentation-v3\#tag/Odds-(Pre-Match)/operation/get-bets) Bets

 Get all available bets for pre-match odds.

 All bets `id` can be used in endpoint odds as filters, **but are not compatible with endpoint `odds/live` for in-play odds**.

 **Update Frequency** : This endpoint is updated several times a week.

 **Recommended Calls** : 1 call per day.

 ##### query Parameters

 |     |     |
 | --- | --- |
 | id | string<br>The id of the bet name |
 | search | string = 3 characters <br>The name of the bet |

 ##### header Parameters

 |     |     |
 | --- | --- |
 | x-rapidapi-key<br>required | string<br>Your Api-Key |

 ### Responses

 **200**
 OK

 **204**
 No Content

 **499**
 Time Out

 **500**
 Internal Server Error

 get/odds/bets

 API-SPORTS

 https://v3.football.api-sports.io/odds/bets

 ### Request samples

 - Use Cases
 - Php
 - Python
 - Node
 - JavaScript
 - Curl
 - Ruby

 Copy

 ```
 // Get all available bets
 get("https://v3.football.api-sports.io/odds/bets");

 // Get bet from one {id}
 get("https://v3.football.api-sports.io/odds/bets?id=1");

 // Allows you to search for a bet in relation to a bets {name}
 get("https://v3.football.api-sports.io/odds/bets?search=winner");

 ```

 ### Response samples

 - 200
 - 204
 - 499
 - 500

 Content type

 application/json

 Copy
 Expand all  Collapse all

 `{
 "get": "odds/bets",
 "parameters": {
 "search": "under"},
 "errors": [ ],
 "results": 7,
 "paging": {
 "current": 1,
 "total": 1},
 "response": [\
 {\
 "id": 5,\
 "name": "Goals Over/Under"},\
 {\
 "id": 6,\
 "name": "Goals Over/Under First Half"},\
 {\
 "id": 26,\
 "name": "Goals Over/Under - Second Half"},\
 {\
 "id": 45,\
 "name": "Corners Over Under"},\
 {\
 "id": 57,\
 "name": "Home Corners Over/Under"},\
 {\
 "id": 58,\
 "name": "Away Corners Over/Under"},\
 {\
 "id": 74,\
 "name": "10 Over/Under"}]}`