Soccer API Tech Docs

Search in tech docs

Soccer API Referee Statistics

Provides the information about referee and his/her statistics.

Soccer Referee Statistics Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of the tournament from Tournament List endpoint

Stage / Round Structure Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint

Teams Informations The informations of teams in the tournament. You can find list of the teams from Tournament Teams endpoint

Call Rate / Interval

Recommended API Call Interval: 2 Requests / Day Daily Max API Call: 4 Requests

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
matchId	INT	R	{matchId}	The id of the match.

Response Output

{ "homeTeam": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "awayTeam": { "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "h2h": { "referee": { "country": { "name": "England", "shortName": "ENG", "id": 2 }, "name": "Paul Tierney", "firstName": "Paul", "surName": "Tierney", "age": 42, "id": 346 }, "refereeTournaments": [ { "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "season": { "name": "", "shortName": "", "id": 10565 }, "stats": { "matchCount": 13, "matchResultHomeWin": 3, "matchResultAwayWin": 4, "matchResultAway": 6, "homeTeamYellow": 21, "homeTeamSecondYellow": 1, "homeTeamRed": 1, "awayTeamYellow": 24, "awayTeamSecondYellow": 1, "awayTeamRed": 0, "homeTeamPenaltiesAwarded": 1, "awayTeamPenaltiesAwarded": 2 } }, { "tournament": { "name": "EFL Championship", "shortName": "ECL", "id": 9 }, "season": { "name": "", "shortName": "", "id": 10565 }, "stats": { "matchCount": 1, "matchResultHomeWin": 1, "matchResultAwayWin": 0, "matchResultAway": 0, "homeTeamYellow": 1, "homeTeamSecondYellow": 0, "homeTeamRed": 0, "awayTeamYellow": 3, "awayTeamSecondYellow": 0, "awayTeamRed": 0, "homeTeamPenaltiesAwarded": 0, "awayTeamPenaltiesAwarded": 1 } } ], "refereeMatches": [ { "homeTeam": { "name": "Liverpool", "shortName": "LIV", "mediumName": "Liverpool", "id": 265 }, "awayTeam": { "name": "Chelsea", "shortName": "CHE", "mediumName": "Chelsea", "id": 200 }, "date": "31/01/2024 20:15:00", "id": 1683239, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2023/2024 Season", "shortName": "23/24", "id": 50277 }, "round": { "name": "Round 22", "shortName": "R22", "id": 22 } }, { "homeTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Tottenham Hotspur", "shortName": "TOT", "mediumName": "Tottenham", "id": 373 }, "awayTeam": { "score": { "regular": 1, "halfTime": 0, "current": 1 }, "name": "Manchester City", "shortName": "MCFC", "mediumName": "Man. City", "id": 269 }, "date": "26/01/2024 20:00:00", "id": 1755727, "tournament": { "name": "FA Cup", "shortName": "FAC", "id": 45 }, "stage": { "name": "Round 4", "shortName": "TR 4", "id": 51884 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } }, { "homeTeam": { "score": { "regular": 5, "halfTime": 2, "current": 5 }, "name": "Arsenal", "shortName": "ARS", "mediumName": "Arsenal", "id": 157 }, "awayTeam": { "score": { "regular": 0, "halfTime": 0, "current": 0 }, "name": "Crystal Palace", "shortName": "CPFC", "mediumName": "Cry.Palace", "id": 211 }, "date": "20/01/2024 12:30:00", "id": 1683222, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2023/2024 Season", "shortName": "23/24", "id": 50277 }, "round": { "name": "Round 21", "shortName": "R21", "id": 21 } }, { "homeTeam": { "score": { "regular": 2, "halfTime": 1, "current": 2 }, "name": "Stoke City", "shortName": "STK", "mediumName": "Stoke", "id": 363 }, "awayTeam": { "score": { "regular": 4, "halfTime": 1, "current": 4 }, "name": "Brighton & Hove Albion", "shortName": "BHA", "mediumName": "Brighton", "id": 182 }, "date": "06/01/2024 15:00:00", "id": 1749129, "tournament": { "name": "FA Cup", "shortName": "FAC", "id": 45 }, "stage": { "name": "Round 3", "shortName": "TR 3", "id": 51883 }, "round": { "name": "Single Game", "shortName": "SG", "id": 209 } } ], "refereeLastDecadeForTeams": { "overall": { "homeTeam": { "matchCount": 27, "win": 15, "draw": 8, "lose": 4, "totalGoalsScored": 47, "totalGoalsConceded": 24, "yellowCard": 43, "redCard": 2, "penaltiesAwarded": 2 }, "awayTeam": { "matchCount": 18, "win": 13, "draw": 2, "lose": 3, "totalGoalsScored": 39, "totalGoalsConceded": 13, "yellowCard": 24, "redCard": 2, "penaltiesAwarded": 4 } }, "home": { "homeTeam": { "matchCount": 15, "win": 9, "draw": 6, "lose": 0, "totalGoalsScored": 27, "totalGoalsConceded": 10, "yellowCard": 22, "redCard": 1, "penaltiesAwarded": 2 }, "awayTeam": { "matchCount": 9, "win": 4, "draw": 2, "lose": 3, "totalGoalsScored": 15, "totalGoalsConceded": 8, "yellowCard": 15, "redCard": 2, "penaltiesAwarded": 2 } }, "away": { "homeTeam": { "matchCount": 12, "win": 6, "draw": 2, "lose": 4, "totalGoalsScored": 20, "totalGoalsConceded": 14, "yellowCard": 21, "redCard": 1, "penaltiesAwarded": 0 }, "awayTeam": { "matchCount": 9, "win": 9, "draw": 0, "lose": 0, "totalGoalsScored": 24, "totalGoalsConceded": 5, "yellowCard": 9, "redCard": 0, "penaltiesAwarded": 2 } } } }, "date": "31/01/2024 20:15:00", "id": 1683239, "tournament": { "name": "English Premier League", "shortName": "EPL", "id": 2 }, "stage": { "name": "2023/2024 Season", "shortName": "23/24", "id": 50277 }, "round": { "name": "Round 22", "shortName": "R22", "id": 22 } }

Response Output Definitions

match

Data

Type

Example

Description

INT

1456386

The id of the match

date

DATE/STR

04/10/2020 15:30:00

The kick-off date of the match, also includes the time

tournament

Data	Type	Example	Description
name	STR	English Premier League	The full name of the tournament
shortName	STR	EPL	The short name of the tournament
id	INT	2	The id of the tournament

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	Manchester United	The full name of the homeTeam/awayTeam
shortName	STR	MANU	The short name of the homeTeam/awayTeam
mediumName	STR	Man United	The medium name of the homeTeam/awayTeam
id	INT	4	The id of the homeTeam/awayTeam

status

Data	Type	Example	Description
name	STR	Full Time	The name of the status
shortName	STR	FT	The short name of the status
id	INT	5	The id of the status

h2h

referee

Data

Type

Example

Description

name

STR

Anthony Taylor

Full name of the referee

surName

STR

Taylor

Surname of the referee

firstName

STR

Anthony

First name of the referee

INT

329

Id of the referee

country

Data	Type	Example	Description
name	STR	England	Full name of referee's country of origin
shortName	STR	ENG	Short name of referee's country of origin
id	INT	2	Id of referee's country of origin

refereeTournaments

tournament

Data	Type	Example	Description
name	STR	UEFA Super Cup	Name of the tournament
shortName	STR	USC	Short name of the tournament
id	INT	91	ID of the tournament

season

Data	Type	Example	Description
name	STR	2020	Name of the season
shortName	STR	20	Short name of the season
id	INT	20	ID of the tournament

stats

Data	Type	Example	Description
matchCount	INT	1	Match count of the referee in tournament
matchResultHomeWin	INT	0	Count of home team win (under his/her management)
matchResultDraw	INT	1	Count of draw (under his/her management)
matchResultAwayWin	INT	0	Count of away team win (under his/her management)
homeTeamYellow	INT	2	Count of yellow card to Home Teams (under his/her management)
homeTeamSecondYellow	INT	0	Count of second yellow card to Home Teams (under his/her management)
homeTeamRed	INT	0	Count of red card to Home Teams (under his/her management)
awayTeamYellow	INT	4	Count of yellow card to Away Teams (under his/her management)
awayTeamSecondYellow	INT	0	Count of second yellow card to Away Teams (under his/her management)
awayTeamRed	INT	0	Count of red card to Away Teams (under his/her management)
homeTeamPenaltiesAwarded	INT	0	Count of Penalty awarded to Home Teams (under his/her management)
awayTeamPenaltiesAwarded	INT	1	Count of Penalty awarded to Away Teams (under his/her management)

refereeMatches

match

Data

Type

Example

Description

date

STR

14/10/2020 18:45:00

Date of the match

INT

1427351

Id of the match

tournament

Data	Type	Example	Description
name	STR	UEFA Nations League	Name of the tournament
shortName	STR	UNL	Short name of the tournament
id	INT	526	Id of the tournament

stage

Data	Type	Example	Description
name	STR	Group 1	Name of the stage
shortName	STR	GR 1	Short name of the stage
id	INT	41816	Id of the stage

round

Data	Type	Example	Description
name	STR	Round 4	Name of the round
shortName	STR	W4	Short name of the round
id	INT	4	Id of the round

homeTeam/awayTeam

Data	Type	Example	Description
name	STR	Italy	Name of the homeTeam/awayTeam
shortName	STR	ITA	Short name of the homeTeam/awayTeam
mediumName	STR	Italy	Short name of the homeTeam/awayTeam
id	INT	606	Id of the homeTeam/awayTeam

stage

Data	Type	Example	Description
name	STR	Season 2020/2021	The name of the stage
shortName	STR	20/21	The short name of the stage
id	INT	42532	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 7	The name of the round
shortName	STR	W7	The short name of the round
id	INT	7	The id of the round

Soccer API Tech Docs

Tech Docs Index

Documentation+

Widgets+

Lookups+

Global API+

Soccer API+

Basketball API+

Football API+

Baseball API+

Ice Hockey API+

Volleyball API+

Handball API+

Table Tennis API+

Tennis API+

Soccer API Referee Statistics

Soccer Referee Statistics Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

tournament

homeTeam/awayTeam

status

h2h

referee

country

refereeTournaments

tournament

season

stats

refereeMatches

match

tournament

stage

round

homeTeam/awayTeam

stage

round