FIBA GDAP: awards

Awards of a competition (MVP, All-Star Five...).

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

Usage

fiba_gdap_awards(comp, discipline_format = NULL, 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.

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 wehoop_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_name	type	description
competition_id	integer	FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_end_date	character	Last day of the competition, YYYY-MM-DD.
award_date	character	Date awarded, YYYY-MM-DD.
competition_season	integer	Season key, three rules: the END year for club competitions (BCL 2024-25 = 2025) and the event year for national-team events (World Cup 2023 = 2023), both equal to the sdv season key; qualifiers carry the TARGET tournament year, not the year played (World Cup 2027 qualifiers played in 2025 = 2027, EuroBasket 2029 pre-qualifiers = 2029), whose sdv mapping is an open Phase B decision.
competition_official_name	character	Official name of the competition edition the award was given in.
award_name	character	Award name (All-Star 5, MVP...).
award_code	character	Award code (ALLSTAR, MVP...).
award_level_id	integer	Id of the object the award is attached to: the competitionId when awardLevel is Competition.
award_level	character	Level the award is given at: Competition.
award_label	character	Extra label; null in every sample.
player_id	integer	FIBA person id, global across competitions and roles (player, coach, official): roster personId = play-by-play pId = game-page P_<id> = gdapPlayerId.
player_first_name	character	Awarded player's first name.
player_last_name	character	Awarded player's last name.
player_date_of_birth	character	Awarded player's date of birth, YYYY-MM-DD.
player_nationality	character	Awarded player's nationality, FIBA code.
teams	character	Teams the awarded player played for in the competition. Stored as a JSON string.

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.

 fiba_gdap_awards(comp = 208182)

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_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_rounds(), fiba_gdap_schedule(), fiba_gdap_team_games(), fiba_gdap_team_player_stats(), fiba_gdap_team_staff(), fiba_gdap_team_stats(), fiba_gdap_teams()