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 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.

Previous League Players Next Team