Retrieve detailed coach information via one of our coaches' endpoints. You can retrieve more detailed information by using the correct includes. This section will briefly discuss all the options available to request coaches.
An overview of all the options available:
GET All Coaches: returns all the coaches available within your subscription.
GET Coaches by ID: returns coach information from your requested coach ID.
GET Coaches by Country ID: returns coach information from your requested country ID.
GET Coaches Search by Name: returns all the coaches that match your search query.
GET Last Updated Coaches: returns all the coaches that have received updates in the past two hours.
For all the coaches' endpoints the base URL is the same: URL: https://api.sportmonks.com/v3/football/coaches
Per endpoint the rest of the URL requires additional information. We will explain this per endpoint.
Requesting coaches
GET All Coaches
Every team has a coach. Most of our customers use the GET All Coaches endpoint to get an overview of all coaches within their subscription.
The URL to get all your coaches is the same as the base URL for coaches. All you have to do is authorize the request with your API token. Check our authentication section for more info.
As you can see, the coach and player id are included in the response. Also, the nationality, name, image, height and weight, date of birth and gender are included in this basic response. Obviously, there is way more information about this coach, which we can get by adding includes. A couple of examples will be explained a little further. At the endpoint overview all includes can be found.
Now that you've requested all the coaches, you also know their unique coach id. You can use this id in the second option: GET Coach by ID.
GET Coaches by ID
This endpoint is useful if you only want information about one particular coach. You need to add the coach_id to your request:
{"data": {"id":23237,"player_id":23237,"sport_id":1,"country_id":38,"nationality_id":null,"city_id":null,"common_name":"G. van Bronckhorst","firstname":"Giovanni","lastname":"van Bronckhorst","name":"Giovanni van Bronckhorst","display_name":"Giovanni van Bronckhorst","image_path":"https://cdn.sportmonks.com/images/soccer/coaches/5/23237.png","height":178,"weight":75,"date_of_birth":"1975-02-05","gender":"male" },
GET Coaches by Country ID
Comes in handy if you want to find out how many coaches from a certain country are included in your subscription. You need to add the country_id to your request:
{"data": [ {"id":524394,"player_id":524394,"sport_id":1,"country_id":38,"nationality_id":null,"city_id":null,"common_name":"R. Moniz","firstname":"Ricardo","lastname":"Moniz","name":"Ricardo Moniz","display_name":"Ricardo Moniz","image_path":"https://cdn.sportmonks.com/images/soccer/players/10/524394.png","height":167,"weight":68,"date_of_birth":"1964-06-17","gender":"male" }, {"id":2510291,"player_id":2510291,"sport_id":1,"country_id":38,"nationality_id":null,"city_id":null,"common_name":"J. Lammers","firstname":"Joannes Gerardus Adrianus","lastname":"Lammers","name":"Joannes Gerardus Adrianus Lammers","display_name":"Joannes Lammers","image_path":"https://cdn.sportmonks.com/images/soccer/placeholder.png","height":null,"weight":null,"date_of_birth":"1963-12-11","gender":"male" }, {"id":23237,"player_id":23237,"sport_id":1,"country_id":38,"nationality_id":null,"city_id":null,"common_name":"G. van Bronckhorst","firstname":"Giovanni","lastname":"van Bronckhorst","name":"Giovanni van Bronckhorst","display_name":"Giovanni van Bronckhorst","image_path":"https://cdn.sportmonks.com/images/soccer/coaches/5/23237.png","height":178,"weight":75,"date_of_birth":"1975-02-05","gender":"male" } ],
GET Coaches Search by Name
You want the information about Giovanni van Bronckhorst. However, you don’t know the coach id or country id. Well, we have an endpoint to use his name and get the information you need. The GET Coaches Search by Name endpoint, in order to do this you need to add the /search/{search_query}to your request:
{"data": [ {"id":23237,"player_id":23237,"sport_id":1,"country_id":38,"nationality_id":null,"city_id":null,"common_name":"G. van Bronckhorst","firstname":"Giovanni","lastname":"van Bronckhorst","name":"Giovanni van Bronckhorst","display_name":"Giovanni van Bronckhorst","image_path":"https://cdn.sportmonks.com/images/soccer/coaches/5/23237.png","height":178,"weight":75,"date_of_birth":"1975-02-05","gender":"male" } ],
GET Last Updated Coaches
This endpoint returns all the coaches that have received updates in the past two hours. This comes in handy to keep your database in sync. You’ll need to add /latest to the coaches base URL:
{"data": [ {"id":23237,"player_id":23237,"sport_id":1,"country_id":38,"nationality_id":null,"city_id":null,"common_name":"G. van Bronckhorst","firstname":"Giovanni","lastname":"van Bronckhorst","name":"Giovanni van Bronckhorst","display_name":"Giovanni van Bronckhorst","image_path":"https://cdn.sportmonks.com/images/soccer/coaches/5/23237.png","height":178,"weight":75,"date_of_birth":"1975-02-05","gender":"male" } ],
Adding useful information
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 coaches' endpoints.
First of all, you can find a list of all available includes on the endpoint pages. For the coaches, the most commonly used includes are teams ,statistics ,nationality.
For example, if we want all the above information about Giovanni van Bronckhorst (coach id: 23237).
{"data": [ {"id":23237,"player_id":23237,"sport_id":1,"country_id":38,"nationality_id":null,"city_id":null,"common_name":"G. van Bronckhorst","firstname":"Giovanni","lastname":"van Bronckhorst","name":"Giovanni van Bronckhorst","display_name":"Giovanni van Bronckhorst","image_path":"https://cdn.sportmonks.com/images/soccer/coaches/5/23237.png","height":178,"weight":75,"date_of_birth":"1975-02-05","gender":"male","teams": [ {"id":46,"team_id":62,"coach_id":23237,"position_id":221,"active":false,"start":"2021-11-18","end":"2022-11-27","temporary":false } ],"statistics": [ {"id":5448,"coach_id":23237,"team_id":62,"season_id":18369 }, {"id":54434,"coach_id":23237,"team_id":62,"season_id":19735 } ],"nationality":null } ],
Selecting and filtering
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 coach. We can imagine you’re not interested in all the coach data the API returns. Let’s say you’re only interested in the coach name and image.