FIBA GDAP: federation ranking

FIBA world ranking of national teams.

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

Usage

fiba_gdap_federation_ranking(
  category = "women",
  zone_id = 1L,
  as_of_date = NULL,
  return_parsed = TRUE
)

Arguments

category

(character, default "women" in wehoop; sdv-py and hoopR default "men") Ranking category: men or women (the site also knows boys/girls)

zone_id

(integer, default 1L) Ranking zone id from getgdaprankingzones (1 = World, 2 = Africa, 3 = Americas, 4 = Asia, 5 = Europe)

as_of_date

(character, optional) Ranking as of this date, ISO 8601: the latest ranking published on or before it (2026-03-10 answers the 2026-03-03 ranking). Omitted = the latest ranking

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
as_of_date	character	Date of the ranking returned: the latest ranking published on or before the requested date.
zone_ranking_code	character	Ranking zone code (WORLD, AFRICA...).
zone_ranking_official_name	character	Ranking zone official name.
world_rank	integer	Position in the FIBA world ranking (1 = best).
country_name	character	Country name in English.
zone_rank	integer	Rank within the zone.
ioc_code	character	IOC country code.
fiba_code	character	FIBA three-letter country code (GER, USA; historic URS, YUG).
current_points	double	Ranking points (one decimal).
world_rank_variation	integer	Change in world rank since the previous release (positive = up).
comments	character	Ranking note; 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.

 fiba_gdap_federation_ranking(category = "women", zone_id = 1, as_of_date = "2025-09-15")

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_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()