Every edition of a competition family between two seasons.
Endpoint: GET https://digital-api.fiba.basketball/hapi/getgdapcompetitionsbyseasonsandcompetitionmarketingname
Arguments
- family_id
(integer, required) Required. Competition family id (competitionMarketingName.competitionMarketingNameId): 201 = World Cup, 320 = men's Olympics, 306 = Women's World Cup, 112 = BCL tier 1, 211 = EuroLeague Women.
- season
(integer, optional) Season key: the END year for club competitions (BCL 2024-25 = 2025), the event year for national-team events (World Cup 2023 = 2023); qualifiers carry the TARGET tournament year (World Cup 2027 qualifiers played in 2025 = 2027). Sent unchanged. First season, inclusive; omitted = no lower bound.
- to_season
(integer, optional) Last season, inclusive (same key as season). Omitted with season given = the same season.
- 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 |
| hosts | character | Host countries with their cities. Stored as a JSON string. |
| competition_id | integer | FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId. |
| competition_code | character | Competition code (WMM men's World Cup, WOLYM, BCL, ELW...). |
| 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. |
| official_name | character | Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament). |
| start | character | First day, YYYY-MM-DD. |
| end | character | Last day, YYYY-MM-DD. |
| status | character | Competition status: In Progress, Completed, Closed. |
| age_category | character | Age category (Senior, Under 16...). |
| gender | character | Men or Women: the gender of the competition. |
| fiba_zone | character | FIBA zone the competition belongs to (World, Europe, Americas...). |
| zone_information_zone_id | integer | FIBA zone id (1 = World, 23 = Europe; zone table key space). |
| zone_information_zone_official_name | character | Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World). |
| zone_information_zone_code | character | Zone code (W, E, AF, AM, AS, OC). |
| zone_information_top_zone_id | integer | Parent zone id; null for top zones. |
| zone_information_top_zone_official_name | character | Parent zone name; always null in the samples, values unverified. |
| zone_information_top_zone_code | character | Parent zone code; always null in the samples, values unverified. |
| competition_type | character | National Teams or Clubs. |
| competition_category_is_league | logical | True for league-format club competitions. |
| competition_category_age_type | character | Age type code: S senior, U16. |
| competition_category_code | character | Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1). |
| competition_category_name | character | Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...). |
| official_flag_item_code | character | Official-status code: O = official. |
| official_flag_item_name | character | Official-status label. |
| official | character | Official-status label. |
| discipline | character | Discipline (Basketball; 3x3 is a separate platform). |
| competition_marketing_name_competition_marketing_name_id | integer | Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the <histId> of /en/history/ pages. |
| competition_marketing_name_marketing_name | character | Competition family name; slugified it is the <histSlug> of /en/history/ pages. |
| competition_marketing_name_code | character | Family code; null in every sample. |
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_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()
Examples
# \donttest{
try(fiba_gdap_editions(family_id = 201, season = 2023))
#> ── FIBA gdap_editions from fiba.basketball ───────────────────── wehoop 3.1.0 ──
#> ℹ Data updated: 2026-10-22 02:35:37 UTC
#> # A tibble: 1 × 29
#> hosts competition_id competition_code season official_name start end status
#> <chr> <int> <chr> <int> <chr> <chr> <chr> <chr>
#> 1 "[{\"… 208182 WMM 2023 FIBA Basketb… 2023… 2023… Compl…
#> # ℹ 21 more variables: age_category <chr>, gender <chr>, fiba_zone <chr>,
#> # zone_information_zone_id <int>, zone_information_zone_official_name <chr>,
#> # zone_information_zone_code <chr>, zone_information_top_zone_id <int>,
#> # zone_information_top_zone_official_name <chr>,
#> # zone_information_top_zone_code <chr>, competition_type <chr>,
#> # competition_category_is_league <lgl>, competition_category_age_type <chr>,
#> # competition_category_code <chr>, competition_category_name <chr>, …
# }