Skip to contents

Current referees and commissioners (BBL only).

Endpoint: GET https://api.basketball-bundesliga.de/referees

Usage

scb_referees(page_size = 100)

Arguments

page_size

(default 100) Rows per page. 100 returns all current officials in one page; a result that needs more pages is refused.

Value

A hoopR_data tibble: Current referees and commissioners (BBL only). An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py scb_referees):

col_nametypedescription
leaguecharacterLeague the row belongs to: bbl (men) or dbbl (women); BBL and DBBL game ids overlap, so a game is (league, game_id).
referee_idcharacterOfficial id (refId, equal to the API's id); joins referee1_id .. commissioner_id of scb_games.
first_namecharacterOfficial's given name.
last_namecharacterOfficial's family name.
official_functioncharacterREFEREE or COMMISSIONER.
participationsintegerLeague games officiated.
year_joined_bblintegerYear the official joined the league.

Details

Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in scb_seasons().