Contents
What Sportmonks provides
Each referee record in the Football API v3 includes:
– Referee ID, full name, common name, and display name
– Sport ID, country ID, and nationality ID
– Birth city ID
– Referee headshot via image_path
– Height and weight
– Date of birth
– Gender
Referee IDs are referenced directly on fixture records, meaning you can retrieve official assignments for any match using the referees include on the fixtures endpoints.
Endpoints
There are five referee endpoints:
GET All Referees returns every referee available within your subscription.
GET https://api.sportmonks.com/v3/football/referees?api_token=YOUR_TOKEN
GET Referee by ID returns a single referee by their ID. This is the most common entry point when building individual official profiles.
GET https://api.sportmonks.com/v3/football/referees/{referee_id}?api_token=YOUR_TOKEN
GET Referees by Country ID returns all referees from a given country.
GET https://api.sportmonks.com/v3/football/referees/countries/{country_id}?api_token=YOUR_TOKEN
GET Referees by Season ID returns all referees who officiated matches in a given season. This is useful for pre-fetching the full set of officials for a league season in one request.
GET https://api.sportmonks.com/v3/football/referees/seasons/{season_id}?api_token=YOUR_TOKEN
GET Referees Search by Name returns referees that match a name query.
GET https://api.sportmonks.com/v3/football/referees/search/{name}?api_token=YOUR_TOKEN
Includes
Referee records support the following includes:
– country adds country metadata for the referee’s country of birth
– nationality adds the referee’s nationality
– city adds the referee’s birth city
– statistics returns aggregated career statistics for the referee
– sport adds the sport the referee officiates in
Example request: retrieving a referee with their nationality and career statistics:
GET https://api.sportmonks.com/v3/football/referees/{referee_id}?api_token=YOUR_TOKEN&include=nationality;statistics
Referee records are also accessible as an include on the fixtures endpoints via the referees include, letting you retrieve official assignments alongside match data without a separate request.
What you can build with referee data
Referee profile pages covering biography, nationality, and career statistics for officials across the Premier League, La Liga, Bundesliga, Serie A, Champions League, and beyond
Fixture official displays using the referees include on fixtures to show which official is assigned to an upcoming match or who refereed a completed one.
Referee statistics features using the statistics include to surface career totals such as cards issued, penalties awarded, and matches officiated.
Season official directories using GET Referees by Season ID to retrieve every referee who officiated in a given competition during a specific season
Referee tendency analysis combining fixture and statistics data to highlight patterns in how a particular official applies the laws of the game, useful for pre-match context in betting or editorial products.
Availability
Referee data is included in all Starter, Growth, Pro, and Enterprise plans. The referees available to you correspond to the leagues within your subscription. You can explore and test the referee endpoints using the Sportmonks Postman collection or the API tester in MySportmonks.
Try it free. All paid plans include a 14-day free trial, and the forever-free plan gives you immediate access to the Danish Superliga and Scottish Premiership with no credit card required.
FAQs about referees
