Skip to main content

FIBA (digital API and game pages) — additional Python functions — FIBA digital API and game pages: wwc_schedule–wwc_teams

fiba_wwc_schedule​

fiba_wwc_schedule(season: 'Optional[int]' = None, comp: 'Optional[int]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Schedule and results of one FIBA Women's Basketball World Cup edition, one row per game.

FIBA Women's Basketball World Cup (women's); season rule: event year (2022 = 2022).

Convenience wrapper: a thin binding of fiba_gdap_schedule to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: 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. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
seasonOptional[int]NoneEdition season key (see the season rule above). Omitted = the newest edition that has started.
compOptional[int]NoneFIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
game_idInt64FIBA game id, global across competitions (GDAP key space): gdapGameId, the of a game-page URL.
game_nameStringTechnical game name '--'.
game_numberStringGame number within the round or pairing (a string: '1', 'A').
status_codeStringGame status code: VALID (validated result), CLOS (closed, pre-2000 rows).
team_a_team_idInt64Competition 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_a_organisation_idInt64Organisation 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_.
team_a_codeStringTeam code (national: FIBA country code; club: a club abbreviation such as OOST).
team_a_official_nameStringOfficial name of team A: the country for a national team, the club for a club team.
team_a_short_nameStringShort name of team A: the country code for a national team, the club's short name for a club.
team_b_team_idInt64Competition 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_b_organisation_idInt64Organisation 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_.
team_b_codeStringTeam code (national: FIBA country code; club: a club abbreviation such as NANT).
team_b_official_nameStringOfficial name of team B: the country for a national team, the club for a club team.
team_b_short_nameStringShort name of team B: the country code for a national team, the club's short name for a club.
team_a_scoreInt64Final score of team A.
team_b_scoreInt64Final score of team B.
is_liveBooleanTrue while the game is being played.
current_periodStringLast period reached ('Q4', 'OT1').
chronoStringGame clock of the current period, 'mm:ss' ('00:00' when finished).
live_game_statusInt64Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified.
current_period_statusStringState of the current period: E = ended (the only value sampled).
host_cityStringCity of the venue.
host_countryStringCountry of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid).
host_country_codeStringFIBA code of the venue's country.
venue_idInt64Venue id (GDAP key space; 0 = unknown).
venue_nameStringName of the arena the game is played in.
game_date_timeStringTip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false).
game_date_time_utcStringTip-off in UTC, ISO 8601 without the Z.
has_time_game_date_timeBooleanFalse when only the date is known (the time part is then 00:00:00).
iana_time_zoneStringIANA time zone of the venue.
utc_offsetFloat64Venue UTC offset at tip-off, in hours (Float64: a half-hour zone such as India +5.5 or Adelaide +9.5 is a fraction; whole hours in every sample).
is_postponedBooleanTrue when the game was postponed.
is_played_behind_closed_doorsBooleanTrue when played without spectators.
venue_capacityInt64Venue capacity (0 = unknown).
spectatorsInt64Attendance at the game, as recorded by FIBA.
statistic_systemStringLive-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006.
group_idStringGroup id (GDAP key space).
group_pairing_codeStringGroup letter (group play) or pairing number (knockout bracket slot).
round_round_idInt64Round id (GDAP key space, unique across competitions); the first segment of gameName.
round_round_codeStringRound code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...).
round_round_nameStringRound label (Group Phase, Quarter-Finals, Final...).
round_round_numberInt64Round number within the competition (1-based).
round_round_typeStringRound type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here).
round_round_status_codeStringRound status: COMPL completed, PROGR in progress, CLOS closed.
round_game_systemStringPairing system label (Single, Home and Away, Best of 3).
round_game_system_codeStringPairing system code: S single game, HA home and away, BOF3 best of three.
round_start_dateStringRound start, local date-time.
round_end_dateStringRound end, local date-time (23:59:59.9999999 on the last day).
round_round_kindStringStandard Round or Qualifiers.
round_round_orderInt64Display order of the round.
competition_competition_idInt64FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
competition_competition_codeStringCompetition code (WMM men's World Cup, WOLYM, BCL, ELW...).
competition_seasonInt64Season 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_nameStringEdition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament).
competition_startStringFirst day, YYYY-MM-DD.
competition_endStringLast day, YYYY-MM-DD.
competition_statusStringCompetition status: In Progress, Completed, Closed.
competition_age_categoryStringAge category (Senior, Under 16...).
competition_genderStringMen or Women: the gender of the competition.
competition_fiba_zoneStringFIBA zone the competition belongs to (World, Europe, Americas...).
competition_zone_information_zone_idInt64FIBA zone id (1 = World, 23 = Europe; zone table key space).
competition_zone_information_zone_official_nameStringOfficial name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World).
competition_zone_information_zone_codeStringZone code (W, E, AF, AM, AS, OC).
competition_zone_information_top_zone_idInt64Parent zone id; null for top zones.
competition_zone_information_top_zone_official_nameStringParent zone name; always null in the samples, values unverified.
competition_zone_information_top_zone_codeStringParent zone code; always null in the samples, values unverified.
competition_competition_typeStringNational Teams or Clubs.
competition_competition_category_is_leagueBooleanTrue for league-format club competitions.
competition_competition_category_age_typeStringAge type code: S senior, U16.
competition_competition_category_codeStringCategory code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1).
competition_competition_category_nameStringName of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...).
competition_official_flag_item_codeStringOfficial-status code: O = official.
competition_official_flag_item_nameStringOfficial-status label.
competition_officialStringOfficial-status label.
competition_disciplineStringDiscipline (Basketball; 3x3 is a separate platform).
competition_competition_marketing_name_competition_marketing_name_idInt64Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the of /en/history/ pages.
competition_competition_marketing_name_marketing_nameStringCompetition family name; slugified it is the of /en/history/ pages.
competition_competition_marketing_name_codeStringFamily code; null in every sample.
game_statistic_status_codeStringBox-score validation status: VALID.
game_play_by_play_status_codeStringPlay-by-play availability flag: VALID or EMPTY. UNRELIABLE: World Cup 2014 and EuroBasket 2017 say EMPTY but their game pages carry full play-by-play; always check the page.
game_result_status_codeStringResult validation status: VALID.
game_result_additional_informationStringFree-text result note (forfeit, overtime remark); null when none.
window_codeStringQualifier window code; null otherwise.
window_nameStringQualifier window name; null otherwise.
team_a_fromStringHow team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play.
team_b_fromStringHow team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play.

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. FIBA has nothing for the request (HTTP 404, or GDAP answered {} or [] for an unknown id). FIBA lists no edition for the season.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. The fetch failed, or the answer 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). comp is an edition of another competition family, or GDAP gives it no family to check.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. HTTP 400 / 422, or a malformed id, season or date. The season lists several editions (pass comp).

Example

from sportsdataverse.basketball.fiba_hub import fiba_wwc_schedule
fiba_wwc_schedule(season=2022)

fiba_wwc_shots​

fiba_wwc_shots(game_id: 'int', season: 'Optional[int]' = None, comp: 'Optional[int]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Shot chart of one FIBA Women's Basketball World Cup game.

FIBA Women's Basketball World Cup (women's); season rule: event year (2022 = 2022).

Convenience wrapper: a thin binding of fiba_gamepage_shots to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: 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. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
game_idintFIBA game id (game_id in the schedule).
seasonOptional[int]NoneEdition season key (see the season rule above). Required unless comp is given: a game function never guesses the edition.
compOptional[int]NoneFIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the game-page Dict (game, playByPlay, gameDetails, playersTeamA, playersTeamB) cut out of the RSC flight payload with its tokens resolved when return_parsed=False.

col_nametypedescription
game_idInt64FIBA game id (Int64), global across competitions: gdapGameId, the of a game-page URL.
competition_idInt64FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_systemStringLive-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
periodStringPeriod name: Q1..Q4, then OT1, OT2...
period_numberInt641-based position of the period in the game.
action_idStringAction id (String): ':' in OVR games (3:0015), a sequence number in FLS games; unique within the game.
orderInt64Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events.
clockStringGame clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime).
clock_secondsInt64Seconds remaining in the period, derived from clock.
action_codeStringAction code: P2 two-point shot, P3 three-point shot, FT free throw, REB rebound, TREB team rebound, ASS assist, ST steal, BS block, TO turnover, TTO team turnover, FOUL foul, RFOUL foul drawn, SUBST substitution, TIMO timeout, plus period events (STARTG, STARTP, ENDP, ENDG).
organisation_idInt64Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_ and the play-by-play oId. NOT the per-competition team_id.
team_sideStringA or B: whether the row is the schedule's team A or team B (null when the page does not say).
player_idInt64FIBA person id (Int64), global across competitions and roles: the page's P_, play-by-play pId, roster personId and fiba_gdap_roster.player_id.
shot_typeStringShot type derived from action_code: 2PT, 3PT or FT; null on other actions.
points_attemptedInt64Points the attempt was worth (2, 3 or 1), made or not; null on other actions.
madeBooleanTrue when the shot went in (two-pointers, three-pointers and free throws only; null otherwise).
shot_xInt64Shot x, integer pixels on a half-court image across the court width (observed 0-278, basket near x = 139). Present only on shots; free throws are 0. Which sideline is x = 0 and the scale are UNVERIFIED.
shot_yInt64Shot y, integer pixels from the baseline (y = 0) towards midcourt (observed 0-224, basket near y = 25); both teams' shots are drawn on one basket. Free throws are 0. Scale UNVERIFIED.
has_locationBooleanTrue when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions.

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. FIBA has nothing for the request (HTTP 404, GDAP answered {} or [] for an unknown id, a listed game whose teams are not drawn yet, or a game page with no box score). FIBA lists no edition for the season.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. The fetch failed, or the answer 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, a game of another competition than comp, the HTTP 200 'not-found shell' of a wrong game page, a live game). comp is an edition of another competition family, or GDAP gives it no family to check.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. HTTP 400 / 422, a malformed id, season or date, or a game page requested without comp. Neither season nor comp is given, or the season lists several editions (pass comp).

Example

from sportsdataverse.basketball.fiba_hub import fiba_wwc_schedule, fiba_wwc_shots
games = fiba_wwc_schedule(season=2022)
fiba_wwc_shots(game_id=int(games['game_id'][0]), season=2022)

fiba_wwc_standings​

fiba_wwc_standings(season: 'Optional[int]' = None, comp: 'Optional[int]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Final standings of one FIBA Women's Basketball World Cup edition.

FIBA Women's Basketball World Cup (women's); season rule: event year (2022 = 2022).

Convenience wrapper: a thin binding of fiba_gdap_final_standings to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: 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. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
seasonOptional[int]NoneEdition season key (see the season rule above). Omitted = the newest edition that has started.
compOptional[int]NoneFIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
competition_idInt64FIBA competition id (Int64) the final ranking belongs to; the comp argument.
final_rankInt64Final rank in the competition.
team_team_idInt64Competition 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_team_codeStringTeam abbreviation (FIBA country code or club abbreviation).
team_short_nameStringShort team name: the country code for a national team, the club's short name for a club.
team_profileStringTeam profile; null in this route.
team_status_codeStringTeam entry status; always null in the samples, values unverified.
team_status_nameStringTeam entry status label; always null in the samples, values unverified.
team_organisation_idInt64Organisation 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_.

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. FIBA has nothing for the request (HTTP 404, or GDAP answered {} or [] for an unknown id). FIBA lists no edition for the season.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. The fetch failed, or the answer 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). comp is an edition of another competition family, or GDAP gives it no family to check.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. HTTP 400 / 422, or a malformed id, season or date. The season lists several editions (pass comp).

Example

from sportsdataverse.basketball.fiba_hub import fiba_wwc_standings
fiba_wwc_standings(season=2022)

fiba_wwc_team_box​

fiba_wwc_team_box(game_id: 'int', season: 'Optional[int]' = None, comp: 'Optional[int]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Team box score of one FIBA Women's Basketball World Cup game.

FIBA Women's Basketball World Cup (women's); season rule: event year (2022 = 2022).

Convenience wrapper: a thin binding of fiba_gamepage_box_teams to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: 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. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
game_idintFIBA game id (game_id in the schedule).
seasonOptional[int]NoneEdition season key (see the season rule above). Required unless comp is given: a game function never guesses the edition.
compOptional[int]NoneFIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the game-page Dict (game, playByPlay, gameDetails, playersTeamA, playersTeamB) cut out of the RSC flight payload with its tokens resolved when return_parsed=False.

col_nametypedescription
game_idInt64FIBA game id (Int64), global across competitions: gdapGameId, the of a game-page URL.
competition_idInt64FIBA competition id (Int64) of the game's edition; the comp argument.
statistic_systemStringLive-stats system of the game: OVR (World Cup, Olympics) or FLS (club competitions, most qualifiers); they differ in the play-by-play action ids, order and text.
team_sideStringA or B: whether the row is the schedule's team A or team B (null when the page does not say).
organisation_idInt64Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_ and the play-by-play oId. NOT the per-competition team_id.
scoreInt64Team final score.
pointsInt64Points scored in the game.
fg_madeInt64Field goals made (2 + 3 points).
fg_attemptedInt64Field goals attempted (2 + 3 points).
fg_pctFloat64Field-goal percentage, 0-100.
fg2_madeInt64Two-point field goals made.
fg2_attemptedInt64Two-point field goals attempted.
fg2_pctFloat64Two-point field-goal percentage, 0-100.
fg3_madeInt64Three-point field goals made.
fg3_attemptedInt64Three-point field goals attempted.
fg3_pctFloat64Three-point field-goal percentage, 0-100.
ft_madeInt64Free throws made.
ft_attemptedInt64Free throws attempted.
ft_pctFloat64Free-throw percentage, 0-100.
reb_offensiveInt64Offensive rebounds.
reb_defensiveInt64Defensive rebounds.
reb_totalInt64Total rebounds (a team row includes the team rebounds team_reb_total).
assistsInt64Assists credited in the game.
stealsInt64Steals credited in the game.
blocksInt64Blocked shots (blocks made).
blocks_receivedInt64Own shots blocked by the opponent (blocks received).
turnoversInt64Turnovers (a team row includes the team turnovers team_turnovers).
foulsInt64Personal fouls (a team row includes the team fouls team_fouls).
fouls_drawnInt64Fouls drawn in the game.
paint_fg_madeInt64Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game).
paint_fg_attemptedInt64Field goals attempted in the paint.
paint_fg_pctFloat64Field-goal percentage in the paint, 0-100.
efficiencyInt64Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers).
biggest_leadInt64Biggest lead, points.
biggest_lead_scoreStringScore when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led).
biggest_runInt64Biggest scoring run, points.
biggest_run_scoreStringScore of the biggest scoring run, 'x-y' string; exact meaning unverified.
fast_break_pointsInt64Fast-break points.
points_off_turnoversInt64Points scored after turnovers.
bench_pointsInt64Points from the bench (the sum of the non-starters' points).
points_in_paintInt64Points in the paint (2 x paint_fg_made).
second_chance_pointsInt64Second-chance points.
a_actInt64Always 0 in the samples; meaning unverified (FIBA stat code A_ACT).
a_foulInt64Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL).
a_todInt64Always 0 in the samples; meaning unverified (FIBA stat code A_TOD).
a_totInt64Always 0 in the samples; meaning unverified (FIBA stat code A_TOT).
team_reb_offensiveInt64Team offensive rebounds, credited to no player.
team_reb_defensiveInt64Team defensive rebounds, credited to no player.
team_reb_totalInt64Team rebounds (total rebounds minus the players' sum).
team_foulsInt64Team (bench/coach) fouls (personal fouls minus the players' sum).
team_turnoversInt64Team turnovers (turnovers minus the players' sum).
team_bench_points_flagInt64Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB).
time_ledStringTime the team led, 'mm:ss' string.
lead_changesInt64Lead changes in the game (game-level; repeats on both team rows).
times_tiedInt64Times the score was tied (game-level; repeats on both team rows).
durationStringGame duration as an 'h:mm' string (game-level; repeats on both team rows).
attendanceInt64Attendance (game-level; repeats on both team rows).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. FIBA has nothing for the request (HTTP 404, GDAP answered {} or [] for an unknown id, a listed game whose teams are not drawn yet, or a game page with no box score). FIBA lists no edition for the season.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. The fetch failed, or the answer 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, a game of another competition than comp, the HTTP 200 'not-found shell' of a wrong game page, a live game). comp is an edition of another competition family, or GDAP gives it no family to check.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. HTTP 400 / 422, a malformed id, season or date, or a game page requested without comp. Neither season nor comp is given, or the season lists several editions (pass comp).

Example

from sportsdataverse.basketball.fiba_hub import fiba_wwc_schedule, fiba_wwc_team_box
games = fiba_wwc_schedule(season=2022)
fiba_wwc_team_box(game_id=int(games['game_id'][0]), season=2022)

fiba_wwc_teams​

fiba_wwc_teams(season: 'Optional[int]' = None, comp: 'Optional[int]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Teams of one FIBA Women's Basketball World Cup edition.

FIBA Women's Basketball World Cup (women's); season rule: event year (2022 = 2022).

Convenience wrapper: a thin binding of fiba_gdap_teams to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: 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. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
seasonOptional[int]NoneEdition season key (see the season rule above). Omitted = the newest edition that has started.
compOptional[int]NoneFIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. Checked to be an edition of this competition (one cached getGdapCompetitionById request).
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
team_idInt64Competition 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_codeStringTeam abbreviation (FIBA country code or club abbreviation).
short_nameStringShort team name: the country code for a national team, the club's short name for a club.
profile_team_idInt64Competition 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_idInt64Organisation 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_.
profile_nameStringTeam name as registered for the competition.
profile_codeStringTeam code (FIBA country code or club abbreviation).
profile_country_nameStringCountry of the team, in English.
profile_country_codeStringCountry FIBA code.
profile_genderStringMen or Women: the gender of the team's competition.
profile_facebookStringFacebook handle or URL; always null in the samples, values unverified.
profile_twitterStringX/Twitter handle; always null in the samples, values unverified.
profile_instagramStringInstagram handle; always null in the samples, values unverified.
profile_websiteStringThe team's website address.
profile_you_tubeStringYouTube handle; always null in the samples, values unverified.
profile_final_rankingInt64Final rank in the competition.
profile_points_per_gameFloat64The team's average points per game played.
profile_rebounds_per_gameFloat64The team's average rebounds per game played.
profile_assists_per_gameFloat64The team's average assists per game played.
profile_rank_points_per_gameFloat64Rank in the competition by points per game (1 = highest).
profile_rank_rebounds_per_gameFloat64Rank in the competition by rebounds per game (1 = highest).
profile_rank_assists_per_gameFloat64Rank in the competition by assists per game (1 = highest).
profile_total_games_wonInt64The team's total games won over the games played.
profile_total_games_lostInt64The team's total games lost over the games played.
profile_social_networksStringSocial-network handles. Stored as a JSON string.
profile_competition_idInt64FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId.
status_codeStringTeam entry status: APPR approved.
status_nameStringTeam entry status label (Approved).
organisation_idInt64Organisation 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_.

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. FIBA has nothing for the request (HTTP 404, or GDAP answered {} or [] for an unknown id). FIBA lists no edition for the season.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. The fetch failed, or the answer 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). comp is an edition of another competition family, or GDAP gives it no family to check.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help. HTTP 400 / 422, or a malformed id, season or date. The season lists several editions (pass comp).

Example

from sportsdataverse.basketball.fiba_hub import fiba_wwc_teams
fiba_wwc_teams(season=2022)