iSports API – Sports API Documentation & Example Responses for Developers

Referee Profile

Update Time: 2026-06-29 15:28

Introduction

• This API endpoint returns referee identity information and their historical performance statistics for specific matches.

• It covers matches scheduled from the past 24 hours into the future, providing details on referee roles and historical home/away team outcomes under their officiating.

• Use it to analyze the potential impact of match officials on game results based on their card-issuing averages and win percentages.

Related Plans

You can use this api by subscribing plans: Live Data.

Request

Path: /sport/football/referee
Method: GET
Calls: This interface is limited to 60 seconds/call;
Recommend Calls: 12 hours/call

Response

Parameter		Value	Description
matchId		string
typeId		int	1: Referee 2: Assistant referee 3: Fourth official
refereeId		int
name		string	Referee name, e.g. Stephanie Frappart
birthday		string	Birth date, e.g. 1983/12/14
country		string	Nationality of the referee
photo		string	Referee photo URL. (Note: Recommended to cache and host assets locally).
statistics		object	Statistical summary based on the referee’s most recent matches, including performance related to home and away teams.
	hasHome	boolean	Indicates whether statistics related to the home team are available. true = data available false = no data available
	hasAway	boolean	Indicates whether statistics related to the away team are available. true = data available false = no data available
	win_home	int	Number of matches where the home team won under this referee.
	draw_home	int	Number of matches where the home team drew under this referee.
	loss_home	int	Number of matches where the home team lost under this referee.
	win_away	int	Number of matches where the away team won under this referee.
	draw_away	int	Number of matches where the away team drew under this referee.
	loss_away	int	Number of matches where the away team lost under this referee.
	winPercent	float	Percentage value derived from recent match outcomes.
	yellowAvg	float	Average number of yellow cards per match issued by the referee.

Example Request

Example Response

• This API endpoint returns referee identity information and their historical performance statistics for specific matches.\n\n • It covers matches scheduled from the past 24 hours into the future, providing details on referee roles and historical home/away team outcomes under their officiating.\n\n • Use it to analyze the potential impact of match officials on game results based on their card-issuing averages and win percentages.

Contact