// Record of a referee
Record of a referee
Results plan and upMCP: referee_stats
A referee's record: home win, draw and away win rates, goals a match, and 2 minute suspensions and 7m throws a match where player lines are held.
GEThttps://api.handballapi.com/v1/referees/{id}/stats
Try itruns against the live API with your key
keyGet a free key
Kept in this browser and filled in on every docs page. A key made in your account appears here by itself.
Parameters1
| name | type | what it does | |
|---|---|---|---|
id | string | required | Referee id (rf_...) |
Returns14 fields
| field | type | what it holds |
|---|---|---|
referee_id | string | Our id for the referee (rf_). Permanent. |
name | string | The name as published. |
countries | string[] | Matches, results, first and latest dates and player lines, by country. |
matches | integer | Matches with a line for the player. |
first_match | date | The first match held. |
last_match | date | The latest match held. |
home_win_rate | number | Home wins divided by matches, 0 to 1. |
draw_rate | number | Draws divided by matches. |
away_win_rate | number | Away wins divided by matches. |
goals_per_match | number | Goals divided by matches. |
matches_with_player_lines | integer | |
two_min_per_match | number|null | |
seven_m_per_match | number|null | |
seasons | object[] |
Example answerGET /v1/referees/rf_bkvzjsdj/stats
200one record
{
"data": {
"referee_id": "rf_bkvzjsdj",
"name": "Gavin Naeve",
"countries": [
"de"
],
"matches": 2,
"first_match": "2026-10-04",
"last_match": "2026-10-30",
"home_win_rate": 0,
"draw_rate": 0.5,
"away_win_rate": 0.5,
"goals_per_match": 54.5,
"matches_with_player_lines": 2,
"two_min_per_match": 4,
"seven_m_per_match": 10.5,
"seasons": [
{
"season": "2026/27",
"matches": 2,
"home_win_rate": 0
}
]
},
"meta": {
"compiled_at": "2026-10-31T03:40:01Z",
"took_ms": 0
}
}