// Handball API referees and venues

Referees and halls get their own permanent ids: rf_ for a referee and vn_ for a hall. A name is matched the same way every time, so one referee keeps one id across seasons and competitions.

Referees

• GET /v1/matches/{id}/officials: the referees of one match, each with a referee_id.
• GET /v1/referees?q=nygaard or ?country=de: referees by part of the name or by country.
• GET /v1/referees/{id} and /matches: one referee, and every result they took charge of.
• GET /v1/referees/{id}/stats: the record: home win, draw and away win rates and goals a match, and 2 minute suspensions and 7m throws a match where the matches carry player lines, with a line per season.

Venues

• GET /v1/venues?country=dk or ?q=arena: halls by country or part of the name, with matches held and dates.
• GET /v1/venues/{id}/matches: every result played in a hall.

A hall is known by its name as published, so a hall that changed its name appears under both. Referees and halls are linked to matches every night.