Skip to contents

A team's games with each team's leaders.

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

Usage

fiba_gdap_team_games(team_id, 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

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
game_idintegerFIBA game id, global across competitions (GDAP key space): gdapGameId, the <gameId> of a game-page URL.
round_namecharacterRound label (Group Phase, Quarter-Finals, Final...).
game_numbercharacterGame number within the round or pairing (a string: '1', 'A').
statuscharacterGame status label (Validated).
status_codecharacterGame status code: VALID (validated result), CLOS (closed, pre-2000 rows).
game_dayintegerGame day number within the round.
team_a_fromcharacterHow team A qualified for this slot; null in group play.
team_b_fromcharacterHow team B qualified for this slot; null in group play.
team_a_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_a_organisation_idintegerOrganisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_<id>.
team_a_codecharacterTeam code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_namecharacterOfficial name of team A: the country for a national team, the club for a club team.
team_a_short_namecharacterShort name of team A: the country code for a national team, the club's short name for a club.
team_b_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_b_organisation_idintegerOrganisation id, stable across competitions and seasons: the national federation for a national team (64 = Germany), the club for a club team (396 = Filou Oostende). Same key space as nationalFederationId, clubId, play-by-play oId and the game page's T_<id>.
team_b_codecharacterTeam code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_namecharacterOfficial name of team B: the country for a national team, the club for a club team.
team_b_short_namecharacterShort name of team B: the country code for a national team, the club's short name for a club.
team_a_scoreintegerTeam A points in the period.
team_b_scoreintegerTeam B points in the period.
host_citycharacterCity of the venue.
host_countrycharacterCountry of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_codecharacterFIBA code of the venue's country; always null in the samples, values unverified.
venue_idintegerVenue id (GDAP key space; 0 = unknown).
venue_namecharacterName of the arena the game is played in.
game_date_timecharacterTip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utccharacterTip-off in UTC, ISO 8601 without the Z.
has_time_game_date_timelogicalFalse when only the date is known (the time part is then 00:00:00).
iana_time_zonecharacterIANA time zone of the venue.
utc_offsetdoubleVenue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
buy_tickets_urlcharacterTicket link; always ” in the samples.
watch_urlcharacterStream link; always ” in the samples.
is_postponedlogicalTrue when the game was postponed.
is_played_behind_closed_doorslogicalTrue when played without spectators.
venue_capacityintegerVenue capacity (0 = unknown).
spectatorsintegerAttendance at the game, as recorded by FIBA.
is_livelogicalTrue while the game is being played.
leaders_team_a_points_leader_player_idintegerFIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_<id> = gdapPlayerId.
leaders_team_a_points_leader_first_namecharacterGiven name(s) as registered with FIBA.
leaders_team_a_points_leader_last_namecharacterLast name (officials: upper case).
leaders_team_a_points_leader_statistics_valueintegerLeader's value for the statistic.
leaders_team_a_points_leader_nationalitycharacterFIBA code of the main nationality.
leaders_team_a_points_leader_rankintegerRank (1 = first).
leaders_team_a_rebounds_leader_player_idintegerFIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_<id> = gdapPlayerId.
leaders_team_a_rebounds_leader_first_namecharacterGiven name(s) as registered with FIBA.
leaders_team_a_rebounds_leader_last_namecharacterLast name (officials: upper case).
leaders_team_a_rebounds_leader_statistics_valueintegerLeader's value for the statistic.
leaders_team_a_rebounds_leader_nationalitycharacterFIBA code of the main nationality.
leaders_team_a_rebounds_leader_rankintegerRank (1 = first).
leaders_team_a_assists_leader_player_idintegerFIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_<id> = gdapPlayerId.
leaders_team_a_assists_leader_first_namecharacterGiven name(s) as registered with FIBA.
leaders_team_a_assists_leader_last_namecharacterLast name (officials: upper case).
leaders_team_a_assists_leader_statistics_valueintegerLeader's value for the statistic.
leaders_team_a_assists_leader_nationalitycharacterFIBA code of the main nationality.
leaders_team_a_assists_leader_rankintegerRank (1 = first).
leaders_team_b_points_leader_player_idintegerFIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_<id> = gdapPlayerId.
leaders_team_b_points_leader_first_namecharacterGiven name(s) as registered with FIBA.
leaders_team_b_points_leader_last_namecharacterLast name (officials: upper case).
leaders_team_b_points_leader_statistics_valueintegerLeader's value for the statistic.
leaders_team_b_points_leader_nationalitycharacterFIBA code of the main nationality.
leaders_team_b_points_leader_rankintegerRank (1 = first).
leaders_team_b_rebounds_leader_player_idintegerFIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_<id> = gdapPlayerId.
leaders_team_b_rebounds_leader_first_namecharacterGiven name(s) as registered with FIBA.
leaders_team_b_rebounds_leader_last_namecharacterLast name (officials: upper case).
leaders_team_b_rebounds_leader_statistics_valueintegerLeader's value for the statistic.
leaders_team_b_rebounds_leader_nationalitycharacterFIBA code of the main nationality.
leaders_team_b_rebounds_leader_rankintegerRank (1 = first).
leaders_team_b_assists_leader_player_idintegerFIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_<id> = gdapPlayerId.
leaders_team_b_assists_leader_first_namecharacterGiven name(s) as registered with FIBA.
leaders_team_b_assists_leader_last_namecharacterLast name (officials: upper case).
leaders_team_b_assists_leader_statistics_valueintegerLeader's value for the statistic.
leaders_team_b_assists_leader_nationalitycharacterFIBA code of the main nationality.
leaders_team_b_assists_leader_rankintegerRank (1 = first).
periodscharacterScore by period. Stored as a JSON string.
game_statistic_status_codecharacterBox-score validation status: VALID.
game_play_by_play_status_codecharacterPlay-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_codecharacterResult validation status: VALID.
game_result_additional_informationcharacterFree-text result note (forfeit, overtime remark); null when none.

Details

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

Examples

# \donttest{
  try(fiba_gdap_team_games(team_id = 279569))
#> ── FIBA gdap_team_games from fiba.basketball ──────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:30:18 UTC
#> # A tibble: 8 × 78
#>   game_id round_name     game_number status    status_code game_day team_a_from 
#>     <int> <chr>          <chr>       <chr>     <chr>          <int> <chr>       
#> 1  100720 Final          A           Validated VALID              1 Winner of G…
#> 2  100723 Semi-Finals    A           Validated VALID              1 Winner of G…
#> 3  100724 Quarter-Finals A           Validated VALID              1 1st of grou…
#> 4  100743 First Round    3           Validated VALID              2 NA          
#> 5  100744 First Round    1           Validated VALID              1 NA          
#> 6  100748 First Round    5           Validated VALID              3 NA          
#> 7  100797 Second Round   1           Validated VALID              1 1st of grou…
#> 8  100806 Second Round   4           Validated VALID              2 1st of grou…
#> # ℹ 71 more variables: team_b_from <chr>, team_a_team_id <int>,
#> #   team_a_organisation_id <int>, team_a_code <chr>,
#> #   team_a_official_name <chr>, team_a_short_name <chr>, team_b_team_id <int>,
#> #   team_b_organisation_id <int>, team_b_code <chr>,
#> #   team_b_official_name <chr>, team_b_short_name <chr>, team_a_score <int>,
#> #   team_b_score <int>, host_city <chr>, host_country <chr>,
#> #   host_country_code <chr>, venue_id <int>, venue_name <chr>, …
# }