// One referee
One referee
Free key and every planOlder dates: Results plan
A referee: countries, matches held, first and last match.
GEThttps://api.handballapi.com/v1/referees/{id}
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_...) |
Returns6 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. |
Example answerGET /v1/referees/rf_bkvzjsdj
200one record
{
"data": {
"referee_id": "rf_bkvzjsdj",
"name": "Gavin Naeve",
"countries": [
"de"
],
"matches": 2,
"first_match": "2026-10-04",
"last_match": "2026-10-30"
},
"meta": {
"compiled_at": "2026-10-31T03:40:01Z",
"took_ms": 1
}
}