League Referees

Get Array of Referees

GEThttps://api.football-data-api.com/league-referees?key=YOURKEY&season_id=*
This endpoint provides an array of referees that have refereed in the particular league/season ID

Query Parameters

Name
Type
Description
max_time
integer
UNIX timestamp. Set this number if you would like the API to return the stats of the league and the teams up to a certain time. For example, if I enter &max_time=1537984169, then the API will respond with stats as of Sept 26, 2018.
key*
string
Your API Key
season_id*
integer
ID of the league season that you would like to retrieve.
200 Successfully retrieved all leagues.
Hide ↑
Copy
Show↓

Queries and Parameters

Variable Name
Description
id
ID of the Referee.
competition_id
Competition ID.
full_name / first_name / last_name
Full name, First name and Last name of the Referee.
known_as
Name of the referee as he is .
shorthand
Code friendly name.
age
Age of the referee.
league
Name of the league.
league_type
Type of the league.
url
FootyStats url of the referee.
season
Season year of the league.
continent
Continent of the league.
starting_year / ending_year
Starting / Ending years of the season.
birthday
UNIX birthday of the referee.
nationality
Nationality of the referee.
appearances_overall
Number of matches participated in the season.
wins_home / wins_away / draws_overall
Number of matches refereed ended with Home win, Away win or draw.
wins_per_home / wins_per_away / draws_per
Percentage value of matches ending in Home win, Away win or draw.
May not always end up accounting to exactly 100% because some numbers are rounded.
btts_overall
BTTS overall.
btts_percentage
Percentage of BTTS.
goals_overall
Number of goals total.
goals_home / goals_away
Number of goals Home and Away.
goals_per_match_overall / goals_per_match_home / goals_per_match_away
Average goal per match Overall, Home or Away.
penalties_given_overall / penalties_given_home / penalties_given_away
Penalties given Overall, Home or Away.
penalties_given_per_match_overall / penalties_given_per_match_home / penalties_given_per_match_away
Penalties given per match Overall, Home or Away.
penalties_given_percentage_overall / penalties_given_percentage_home / penalties_given_percentage_away
Penalties given percentage Overall, Home or Away.
cards_overall, cards_home, cards_away
Cards distributed Overall, Home or Away.
cards_per_match_overall / cards_per_match_home / cards_per_match_away
Average cards distributed per match Overall, Home or Away.
over05_cards_overall (0.5 - 6.5)
Number of Over 0.5 to Over 6.5 cards distributed.
over05_cards_per_match_overall (0.5 - 6.5)
Average number of Over 0.5 to Over 6.5 cards distributed.
over05_cards_percentage_overall (0.5 - 6.5)
Percentage of Over 0.5 to Over 6.5 cards distributed.
yellow_cards_overall / red_cards_overall
Number of yellow cards and red cards distributed.
min_per_goal_overall
Average time between goals accorded.
min_per_card_overall
Average time between cards given.
/
https://cdn.footystats.org/
no