Rounds of a competition (group stage, knockout rounds).
Endpoint: GET https://digital-api.fiba.basketball/hapi/getgdaproundsbycompetitionid
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);FALSEreturns the raw JSON list.
Value
A wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:
| col_name | type | description |
| game_system | character | Pairing system label (Single, Home and Away, Best of 3). |
| game_system_code | character | Pairing system code: S single game, HA home and away, BOF3 best of three. |
| parent_round_id | integer | roundId of the round this one belongs to; null for a top-level round. |
| round_code | character | Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...). |
| round_id | integer | Round id (GDAP key space, unique across competitions); the first segment of gameName. |
| round_name | character | Round label (Group Phase, Quarter-Finals, Final...). |
| round_number | integer | Round number within the competition (1-based). |
| round_type | character | Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here). |
| round_type_code | character | Round type code: G group, NG non-group (knockout), S super round. |
| round_status_code | character | Round status: COMPL completed, PROGR in progress, CLOS closed. |
| start_date | character | Round start, local date-time. |
| end_date | character | Round end, local date-time (23:59:59.9999999 on the last day). |
| has_teams_assigned | logical | True once the round's teams are known. |
| round_kind | character | Standard Round or Qualifiers. |
| standing_header_code | character | Code of the standings table the round feeds. |
| standing_header_name | character | Name of the standings table the round feeds. |
| qualified_team_information | character | Qualification note of the round; null in every sample. |
| round_order | integer | Display order of the round. |
Details
FIBA's terms restrict this source. The GDAP developer-portal terms limit API use to 'Authorized Users' (federations, organisers, FIBA partners) and say any broader use 'is not authorised'; the fiba.basketball terms say no portion of the site may be duplicated, redistributed or manipulated. The package owner reviewed both clauses on 2026-10-12, accepted them and approved the full intake, published data releases included. Users who are not themselves authorised by FIBA should check the terms before using the wrappers.
The GDAP subscription key is public (fiba.basketball ships it in every page); the runtime reads it from the live page at run time and never logs it. Officials' contact details and coaches' and officials' dates of birth are dropped from every body.
Id key spaces: competition_id is one per edition (2023 World Cup = 208182) and game_id is global across
competitions (the <gameId> of a game-page URL). team_id is per team per competition (Germany is 279569 at
the 2023 World Cup and 281545 at Paris 2024), while organisation_id is the stable federation or club (64 =
Germany, every year); the game page's T_<id> and the play-by-play oId are organisation ids, not team ids.
Errors are classed conditions (all inherit wehoop_error): wehoop_no_data when FIBA has nothing (HTTP 404,
or GDAP answers {} / [] for an unknown id); wehoop_bad_request for HTTP 400 / 422 or a malformed id,
season or date; wehoop_asset_fetch for any other failed fetch or an answer that is not about the request (an
error envelope, HTTP 401 after a key refresh, HTTP 500, a body for another game, competition, team, player,
federation, family or season). Seasons are FIBA's own key, which equals the sdv key: the END year for club
competitions, the event year for national-team events, the target tournament year for qualifiers.
See also
Other FIBA Functions:
fiba_gamepage_box_players(),
fiba_gamepage_box_teams(),
fiba_gamepage_lineup(),
fiba_gamepage_pbp(),
fiba_gamepage_period_scores(),
fiba_gamepage_shots(),
fiba_gdap_awards(),
fiba_gdap_competition(),
fiba_gdap_editions(),
fiba_gdap_federation_games(),
fiba_gdap_federation_ranking(),
fiba_gdap_final_standings(),
fiba_gdap_game(),
fiba_gdap_game_officials(),
fiba_gdap_game_periods(),
fiba_gdap_games_between(),
fiba_gdap_gateway_competition_ids(),
fiba_gdap_gateway_federation_ranking(),
fiba_gdap_medal_count(),
fiba_gdap_national_teams(),
fiba_gdap_nominations(),
fiba_gdap_player_game_stats(),
fiba_gdap_player_info(),
fiba_gdap_player_stats(),
fiba_gdap_ranking_zones(),
fiba_gdap_roster(),
fiba_gdap_roster_coaches(),
fiba_gdap_roster_latest(),
fiba_gdap_round_gamedays(),
fiba_gdap_round_standings(),
fiba_gdap_schedule(),
fiba_gdap_team_games(),
fiba_gdap_team_player_stats(),
fiba_gdap_team_staff(),
fiba_gdap_team_stats(),
fiba_gdap_teams()
Examples
# \donttest{
try(fiba_gdap_rounds(comp = 208182))
#> ── FIBA gdap_rounds from fiba.basketball ─────────────────────── wehoop 3.1.0 ──
#> ℹ Data updated: 2026-10-22 02:35:45 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>
# }