list
List of all referees ⬜ 🟨 🟦 🟩
GET https://api.soccerfootball.info/v1/referees/list/
This endpoint return with all referees and its data. 
This is a paginate call, see instruction inside FAQ 
If this entity has has_image to true, you can access/download the entity media, see the instruction inside FAQ. 
The parameter c must be a country code getted from coutries/list endpoint.
Format CSV is in MS excel compatible mode (double click open without import!)
The latest data are on the last page
Query Parameters
t
string
Your API Token DIRECT API ONLY
f
string
Format response can be "json" or "csv" (default "json")
p
string
Page number (default value is 1)
c
string
Country code or "all" (default value is "all")
Headers
X-RapidAPI-Key
string
Your API token RAPIDAPI ONLY
X-RapidAPI-Host
string
soccerfootballinfo.rapidapi.com RAPIDAPI ONLY
{
   "status":200,
   "errors":[],
   "pagination":[
      {
         "page":1,// current page
         "per_page":100, // items per page
         "items":3613 // total items number
      }
   ],
   "result":[
      {
         "id":"5fb96963cbcad15f", // unique referee ID
         "name":"Oren Siminyan",
         "country":"IL",
         "has_image":false
      },
      ...
   ]
}page_1_perPage_100_items_3619;id;name;country;has_image
;5fb96963cbcad15f;"Oren Siminyan";IL;no
...Example of code for direct API
$url = 'https://api.soccerfootball.info/v1/referees/list/?t=TOKEN';
$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL => $url,
    CURLOPT_PROXY => null,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_CUSTOMREQUEST => "GET"
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if (!$err) {
  $result = json_decode($response);
  print_r($result);
} else {
    echo "cURL Error:" . $err;
}fetch("https://api.soccerfootball.info/v1/referees/list/?t=TOKEN", {
    "method": "GET"
})
.then(response => {
    console.log(response);
})
.catch(err => {
    console.error(err);
});const request = require('request');
const options = {
  method: 'GET',
  url: 'https://api.soccerfootball.info/v1/referees/list/?t=TOKEN'
};
request(options, function (error, response, body) {
    if (error) throw new Error(error);
    console.log(body);
});import requests
url = "https://api.soccerfootball.info/v1/referees/list/?t=TOKEN"
response = requests.get(url).json()
print(response)curl --request GET \
    --url 'https://api.soccerfootball.info/v1/referees/list/?t=TOKEN'package main
import (
    "fmt"
    "net/http"
    "io/ioutil"
)
func main() {
    url := "https://api.soccerfootball.info/v1/referees/list/?t=TOKEN"
    req, _ := http.NewRequest("GET", url, nil)
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := ioutil.ReadAll(res.Body)
    fmt.Println(res)
    fmt.Println(string(body))
}Example of code for RapidAPI
$url = 'https://soccer-football-info.p.rapidapi.com/referees/list/';
$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL => $url,
    CURLOPT_PROXY => null,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "X-RapidAPI-Host: soccer-football-info.p.rapidapi.com",
        "X-RapidAPI-Key: TOKEN"
    ],
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if (!$err) {
  $result = json_decode($response);
  print_r($result);
} else {
    echo "cURL Error:" . $err;
}fetch("https://soccer-football-info.p.rapidapi.com/referees/list/", {
    "method": "GET",
    "headers": {
        "X-RapidAPI-Key": "TOKEN",
        "X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
    }
})
.then(response => {
    console.log(response);
})
.catch(err => {
    console.error(err);
});const request = require('request');
const options = {
  method: 'GET',
  url: "https://soccer-football-info.p.rapidapi.com/referees/list/",
  headers: {
   "X-RapidAPI-Key": "TOKEN",
     "X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
   useQueryString: true
  }
};
request(options, function (error, response, body) {
    if (error) throw new Error(error);
    console.log(body);
});import requests
url = "https://soccer-football-info.p.rapidapi.com/referees/list/"
headers = {
    "X-RapidAPI-Key": "TOKEN",
      "X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
}
response = requests.request("GET", url, headers=headers)
print(response.text)curl --request GET \
    --url https://soccer-football-info.p.rapidapi.com/referees/list/ \
    --header 'X-RapidAPI-Host: soccer-football-info.p.rapidapi.com' \
    --header 'X-RapidAPI-Key: TOKEN'package main
import (
    "fmt"
    "net/http"
    "io/ioutil"
)
func main() {
    url := "https://soccer-football-info.p.rapidapi.com/referees/list/"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Add("X-RapidAPI-Key", "TOKEN")
    req.Header.Add("X-RapidAPI-Host", "soccer-football-info.p.rapidapi.com")
    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := ioutil.ReadAll(res.Body)
    fmt.Println(res)
    fmt.Println(string(body))
}More example of code on rapidAPI
Last updated
Was this helpful?