Skip to contents

Teams of a competition with their profile (final ranking, per-game averages).

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

Usage

fiba_gdap_teams(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 wehoop_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 abbreviation (FIBA country code or club abbreviation).
short_namecharacterShort team name: the country code for a national team, the club's short name for a club.
profile_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.
profile_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>.
profile_namecharacterTeam name as registered for the competition.
profile_codecharacterTeam code (FIBA country code or club abbreviation).
profile_country_namecharacterCountry of the team, in English.
profile_country_codecharacterCountry FIBA code.
profile_gendercharacterMen or Women: the gender of the team's competition.
profile_facebookcharacterFacebook handle or URL; always null in the samples, values unverified.
profile_twittercharacterX/Twitter handle; always null in the samples, values unverified.
profile_instagramcharacterInstagram handle; always null in the samples, values unverified.
profile_websitecharacterThe team's website address.
profile_you_tubecharacterYouTube handle; always null in the samples, values unverified.
profile_final_rankingintegerFinal rank in the competition.
profile_points_per_gamedoubleThe team's average points per game played.
profile_rebounds_per_gamedoubleThe team's average rebounds per game played.
profile_assists_per_gamedoubleThe team's average assists per game played.
profile_rank_points_per_gamedoubleRank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_gamedoubleRank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_gamedoubleRank in the competition by assists per game (1 = highest).
profile_total_games_wonintegerThe team's total games won over the games played.
profile_total_games_lostintegerThe team's total games lost over the games played.
profile_social_networkscharacterSocial-network handles. Stored as a JSON string.
profile_competition_idintegerFIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_codecharacterTeam entry status: APPR approved.
status_namecharacterTeam entry status label (Approved).
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>.

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.

Examples

# \donttest{
  try(fiba_gdap_teams(comp = 208182))
#> ── FIBA gdap_teams from fiba.basketball ──────────────────────── wehoop 3.1.0 ──
#> ℹ Data updated: 2026-10-22 02:35:50 UTC
#> # A tibble: 32 × 29
#>    team_id team_code short_name    profile_team_id profile_organisation_id
#>      <int> <chr>     <chr>                   <int>                   <int>
#>  1  279561 JPN       Japan                  279561                      85
#>  2  279562 PHI       Philippines            279562                     122
#>  3  279563 AUS       Australia              279563                      16
#>  4  279564 CAN       Canada                 279564                      34
#>  5  279565 CHN       China                  279565                      39
#>  6  279566 CIV       Côte d'Ivoire          279566                      44
#>  7  279567 FIN       Finland                279567                      58
#>  8  279568 FRA       France                 279568                      59
#>  9  279569 GER       Germany                279569                      64
#> 10  279570 GRE       Greece                 279570                      67
#> # ℹ 22 more rows
#> # ℹ 24 more variables: profile_name <chr>, profile_code <chr>,
#> #   profile_country_name <chr>, profile_country_code <chr>,
#> #   profile_gender <chr>, profile_facebook <chr>, profile_twitter <chr>,
#> #   profile_instagram <chr>, profile_website <chr>, profile_you_tube <chr>,
#> #   profile_final_ranking <int>, profile_points_per_game <dbl>,
#> #   profile_rebounds_per_game <dbl>, profile_assists_per_game <dbl>, …
# }