Retrieve detailed referee information via one of our referees' endpoints. You can retrieve more detailed information by using the correct includes. This section will briefly discuss all the options available to request referees.
An overview of all the options available:
GET All Referees: returns all the referees available within your subscription.
GET Referees by ID: returns referee information from your requested referee ID.
GET Referees by Country ID: returns referee information from your requested country ID.
GET Referees Search by Name: returns all the referees that match your search query.
For all the referees; endpoints the base URL is the same: URL: https://api.sportmonks.com/v3/football/referees
Per endpoint the rest of the URL requires additional information. We will explain this per endpoint.
Requesting referees
GET All Referees
Gather an overview of all referees available in your subscription via the GET All Referees endpoint to get an overview of all referees within their subscription.
The URL to get all your referees is the same as the base URL for referees. All you have to do is authorize the request with your API token. Check our authentication section for more info.
{"data": [ {"id":37,"sport_id":1,"country_id":null,"city_id":null,"common_name":"Craig Alexander Thomson","firstname":null,"lastname":null,"name":"Craig Alexander Thomson","display_name":"Craig Alexander Thomson","image_path":"https://cdn.sportmonks.com/images/soccer/placeholder.png","height":null,"weight":null,"date_of_birth":null,"gender":null }, {"id":94,"sport_id":1,"country_id":null,"city_id":null,"common_name":"Robert Madden","firstname":null,"lastname":null,"name":"Robert Madden","display_name":"Robert Madden","image_path":"https://cdn.sportmonks.com/images/soccer/placeholder.png","height":null,"weight":null,"date_of_birth":null,"gender":null },//And more
You can see the referees' name, the unique referee id and some other data.
Now that you've requested all the referees, you also know their unique referee id. You can use this id in the second option: GET Referee by ID.
GET Referee by ID
This endpoint is useful if you only want information about one particular referee. You need to add the referee_id to your request:
You want the information about your favourite referee. However, you don’t know the referee id or country id. Well, we have an endpoint to use his name and get the information you need. The GET Referees Search by Name endpoint, in order to do this you need to add the /search/{search_query}to your request:
As you’ve learnt in the includes tutorial, you can enrich your request with includes. This section will discuss some of the most common requests on the referees' endpoints.
First of all, you can find a list of all available includes on the endpoint pages. For the referees, the most commonly used includes is statistics.
For example, if we want statistics of Crawford Allan(referee id: 70306).
In our filtering tutorial you’ve learnt how to select specific fields or filter only on the data you’re interested in. By default, our API returns a set of data related to the referee. We can imagine you’re not interested in all the referee data the API returns. Let’s say you’re only interested in the referee name and image.