Skip to contents

A team's coaches on its roster at a competition.

Endpoint: GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionteamrosterbyteamid

Usage

fiba_gdap_roster_coaches(
  team_id,
  discipline_format = NULL,
  return_parsed = TRUE
)

Arguments

team_id

(integer, required) Required. Competition team id: one per team per competition (teamA.teamId of a game row; Germany is 279569 at the 2023 World Cup and 281545 at Paris 2024). Not the federation organisationId

discipline_format

(character, optional) Optional; the site passes its discipline format. 5x5 answers the same as omitting it (verified on awards and rosters)

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw JSON list.

Value

A hoopR_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_nametypedescription
team_idintegerCompetition team id: one per team per competition (Germany = 279569 at the 2023 World Cup, 281545 at Paris 2024). Joins getgdapcompetitionteamrosterbyteamid / getgdapcompetitionteamstatisticsbyteamid gdapTeamId; not an organisationId.
team_codecharacterTeam code (FIBA country code or club abbreviation).
team_namecharacterTeam name (the country for a national team, the club for a club team).
organisation_idintegerStable federation or club id (Int64), the same in every competition and season (64 = Germany).
competition_idintegerFIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
person_idintegerFIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_<id> = gdapPlayerId.
first_namecharacterGiven name(s) as registered with FIBA.
last_namecharacterLast name (officials: upper case).
gendercharacterSex of the person: M or F (Male/Female on getgdapcompetitionnominationsbyid).
functioncharacterRole: Head Coach, Coach, Assistant Coach.
is_head_coachinteger1 for the head coach, 0 otherwise (an integer flag, not a boolean).
is_assistant_coachinteger1 for an assistant coach, else null (integer flag).
is_accompanying_coachlogicalAccompanying-coach flag; always null in the samples, values unverified.
coach_display_orderintegerDisplay order; null when unset.
is_on_final_rosterlogicalTrue when on the final (12-player) roster.
nationalitiescharacterNationalities (FIBA codes on player info; country objects on rosters and officials). Stored as a JSON string.
coach_license_organisation_namecharacterFederation that issued the coaching licence.
coach_license_country_codecharacterFIBA code of the licensing federation's country.
final_roster_member_status_codecharacterRoster entry status: VALID, PARTIAL (incomplete registration).

Details

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

 fiba_gdap_roster_coaches(team_id = 279569)