Skip to contents

Rounds of a competition (group stage, knockout rounds).

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

Usage

fiba_gdap_rounds(comp, return_parsed = TRUE)

Arguments

comp

(integer, required) Required. FIBA competition id (GDAP key space), one per edition: competition.competitionId of any game row (208182 = World Cup 2023, 208722 = Paris 2024 men, 208850 = BCL 2024-25). Find it with fiba_gdap_editions or fiba_gdap_games_between.

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_systemcharacterPairing system label (Single, Home and Away, Best of 3).
game_system_codecharacterPairing system code: S single game, HA home and away, BOF3 best of three.
parent_round_idintegerroundId of the round this one belongs to; null for a top-level round.
round_codecharacterRound code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_idintegerRound id (GDAP key space, unique across competitions); the first segment of gameName.
round_namecharacterRound label (Group Phase, Quarter-Finals, Final...).
round_numberintegerRound number within the competition (1-based).
round_typecharacterRound type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_type_codecharacterRound type code: G group, NG non-group (knockout), S super round.
round_status_codecharacterRound status: COMPL completed, PROGR in progress, CLOS closed.
start_datecharacterRound start, local date-time.
end_datecharacterRound end, local date-time (23:59:59.9999999 on the last day).
has_teams_assignedlogicalTrue once the round's teams are known.
round_kindcharacterStandard Round or Qualifiers.
standing_header_codecharacterCode of the standings table the round feeds.
standing_header_namecharacterName of the standings table the round feeds.
qualified_team_informationcharacterQualification note of the round; null in every sample.
round_orderintegerDisplay order of the round.

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_rounds(comp = 208182))
#> ── FIBA gdap_rounds from fiba.basketball ──────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:30:16 UTC
#> # A tibble: 10 × 18
#>    game_system game_system_code parent_round_id round_code round_id round_name  
#>    <chr>       <chr>                      <int> <chr>         <int> <chr>       
#>  1 Single      S                          25274 FR            25276 First Round 
#>  2 Single      S                          25274 SR            25285 Second Round
#>  3 Single      S                             NA CL17-32       25284 Classificat…
#>  4 Single      S                          25275 QF            25277 Quarter-Fin…
#>  5 Single      S                          25275 CL5-8         25278 Class. Game…
#>  6 Single      S                          25275 SF            25279 Semi-Finals 
#>  7 Single      S                          25275 CL7-8         25280 Class. Game…
#>  8 Single      S                          25275 CL5-6         25281 Class. Game…
#>  9 Single      S                          25275 3PG           25282 3rd Place G…
#> 10 Single      S                          25275 F             25283 Final       
#> # ℹ 12 more variables: round_number <int>, round_type <chr>,
#> #   round_type_code <chr>, round_status_code <chr>, start_date <chr>,
#> #   end_date <chr>, has_teams_assigned <lgl>, round_kind <chr>,
#> #   standing_header_code <chr>, standing_header_name <chr>,
#> #   qualified_team_information <chr>, round_order <int>
# }