FIBA (digital API and game pages) — additional Python functions — FIBA digital API and game pages: elw_standings–oly_teams
fiba_elw_standings
fiba_elw_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 EuroLeague Women (FIBA Women's European Club Competitions Tier 1) edition.
EuroLeague Women (FIBA Women's European Club Competitions Tier 1) (women's); season rule: END year (2024-25 = 2025).
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
| Parameter | Type | Default | Description |
|---|---|---|---|
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
competition_id | integer | FIBA competition id (Int64) the final ranking belongs to; the comp argument. |
final_rank | integer | Final rank in the competition. |
team_team_id | integer | Competition 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_code | character | Team abbreviation (FIBA country code or club abbreviation). |
team_short_name | character | Short team name: the country code for a national team, the club's short name for a club. |
team_profile | character | Team profile; null in this route. |
team_status_code | character | Team entry status; always null in the samples, values unverified. |
team_status_name | character | Team entry status label; always null in the samples, values unverified. |
team_organisation_id | integer | Organisation 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_ |
Example
from sportsdataverse.basketball.fiba_hub import fiba_elw_standings
fiba_elw_standings(season=2025)
fiba_elw_team_box
fiba_elw_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 EuroLeague Women (FIBA Women's European Club Competitions Tier 1) game.
EuroLeague Women (FIBA Women's European Club Competitions Tier 1) (women's); season rule: END year (2024-25 = 2025).
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
| Parameter | Type | Default | Description |
|---|---|---|---|
game_id | int | FIBA game id (game_id in the schedule). | |
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
game_id | integer | FIBA game id (Int64), global across competitions: gdapGameId, the |
competition_id | integer | FIBA competition id (Int64) of the game's edition; the comp argument. |
statistic_system | character | Live-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_side | character | A or B: whether the row is the schedule's team A or team B (null when the page does not say). |
organisation_id | integer | Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_ |
score | integer | Team final score. |
points | integer | Points scored in the game. |
fg_made | integer | Field goals made (2 + 3 points). |
fg_attempted | integer | Field goals attempted (2 + 3 points). |
fg_pct | numeric | Field-goal percentage, 0-100. |
fg2_made | integer | Two-point field goals made. |
fg2_attempted | integer | Two-point field goals attempted. |
fg2_pct | numeric | Two-point field-goal percentage, 0-100. |
fg3_made | integer | Three-point field goals made. |
fg3_attempted | integer | Three-point field goals attempted. |
fg3_pct | numeric | Three-point field-goal percentage, 0-100. |
ft_made | integer | Free throws made. |
ft_attempted | integer | Free throws attempted. |
ft_pct | numeric | Free-throw percentage, 0-100. |
reb_offensive | integer | Offensive rebounds. |
reb_defensive | integer | Defensive rebounds. |
reb_total | integer | Total rebounds (a team row includes the team rebounds team_reb_total). |
assists | integer | Assists credited in the game. |
steals | integer | Steals credited in the game. |
blocks | integer | Blocked shots (blocks made). |
blocks_received | character | Own shots blocked by the opponent (blocks received). |
turnovers | integer | Turnovers (a team row includes the team turnovers team_turnovers). |
fouls | integer | Personal fouls (a team row includes the team fouls team_fouls). |
fouls_drawn | integer | Fouls drawn in the game. |
paint_fg_made | integer | Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game). |
paint_fg_attempted | integer | Field goals attempted in the paint. |
paint_fg_pct | numeric | Field-goal percentage in the paint, 0-100. |
efficiency | integer | Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers). |
biggest_lead | integer | Biggest lead, points. |
biggest_lead_score | character | Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led). |
biggest_run | integer | Biggest scoring run, points. |
biggest_run_score | character | Score of the biggest scoring run, 'x-y' string; exact meaning unverified. |
fast_break_points | integer | Fast-break points. |
points_off_turnovers | integer | Points scored after turnovers. |
bench_points | integer | Points from the bench (the sum of the non-starters' points). |
points_in_paint | integer | Points in the paint (2 x paint_fg_made). |
second_chance_points | integer | Second-chance points. |
a_act | integer | Always 0 in the samples; meaning unverified (FIBA stat code A_ACT). |
a_foul | integer | Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL). |
a_tod | integer | Always 0 in the samples; meaning unverified (FIBA stat code A_TOD). |
a_tot | integer | Always 0 in the samples; meaning unverified (FIBA stat code A_TOT). |
team_reb_offensive | integer | Team offensive rebounds, credited to no player. |
team_reb_defensive | integer | Team defensive rebounds, credited to no player. |
team_reb_total | integer | Team rebounds (total rebounds minus the players' sum). |
team_fouls | integer | Team (bench/coach) fouls (personal fouls minus the players' sum). |
team_turnovers | integer | Team turnovers (turnovers minus the players' sum). |
team_bench_points_flag | integer | Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB). |
time_led | character | Time the team led, 'mm:ss' string. |
lead_changes | integer | Lead changes in the game (game-level; repeats on both team rows). |
times_tied | integer | Times the score was tied (game-level; repeats on both team rows). |
duration | character | Game duration as an 'h:mm' string (game-level; repeats on both team rows). |
attendance | integer | Attendance (game-level; repeats on both team rows). |
Example
from sportsdataverse.basketball.fiba_hub import fiba_elw_schedule, fiba_elw_team_box
games = fiba_elw_schedule(season=2025)
fiba_elw_team_box(game_id=int(games['game_id'][0]), season=2025)
fiba_elw_teams
fiba_elw_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 EuroLeague Women (FIBA Women's European Club Competitions Tier 1) edition.
EuroLeague Women (FIBA Women's European Club Competitions Tier 1) (women's); season rule: END year (2024-25 = 2025).
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
| Parameter | Type | Default | Description |
|---|---|---|---|
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
team_id | integer | Competition 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_code | character | Team abbreviation (FIBA country code or club abbreviation). |
short_name | character | Short team name: the country code for a national team, the club's short name for a club. |
profile_team_id | integer | Competition 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_id | integer | Organisation 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_name | character | Team name as registered for the competition. |
profile_code | character | Team code (FIBA country code or club abbreviation). |
profile_country_name | character | Country of the team, in English. |
profile_country_code | character | Country FIBA code. |
profile_gender | character | Men or Women: the gender of the team's competition. |
profile_facebook | character | Facebook handle or URL; always null in the samples, values unverified. |
profile_twitter | character | X/Twitter handle; always null in the samples, values unverified. |
profile_instagram | character | Instagram handle; always null in the samples, values unverified. |
profile_website | character | The team's website address. |
profile_you_tube | character | YouTube handle; always null in the samples, values unverified. |
profile_final_ranking | integer | Final rank in the competition. |
profile_points_per_game | numeric | The team's average points per game played. |
profile_rebounds_per_game | numeric | The team's average rebounds per game played. |
profile_assists_per_game | numeric | The team's average assists per game played. |
profile_rank_points_per_game | numeric | Rank in the competition by points per game (1 = highest). |
profile_rank_rebounds_per_game | numeric | Rank in the competition by rebounds per game (1 = highest). |
profile_rank_assists_per_game | numeric | Rank in the competition by assists per game (1 = highest). |
profile_total_games_won | integer | The team's total games won over the games played. |
profile_total_games_lost | integer | The team's total games lost over the games played. |
profile_social_networks | character | Social-network handles. Stored as a JSON string. |
profile_competition_id | integer | FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId. |
status_code | character | Team entry status: APPR approved. |
status_name | character | Team entry status label (Approved). |
organisation_id | integer | Organisation 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_ |
Example
from sportsdataverse.basketball.fiba_hub import fiba_elw_teams
fiba_elw_teams(season=2025)
fiba_oly_editions
fiba_oly_editions(season: 'Optional[int]' = None, to_season: 'Optional[int]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'
Every edition of Men's Olympic Basketball Tournament.
Men's Olympic Basketball Tournament (men's); season rule: event year (Paris 2024 = 2024).
Convenience wrapper: a thin binding of fiba_gdap_editions 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.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
season | Optional[int] | None | First season (inclusive); omitted = all editions. |
to_season | Optional[int] | None | Last season, inclusive. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_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 |
competition_marketing_name_marketing_name | character | Competition family name; slugified it is the |
competition_marketing_name_code | character | Family code; null in every sample. |
Example
from sportsdataverse.basketball.fiba_hub import fiba_oly_editions
fiba_oly_editions(season=2024)
fiba_oly_pbp
fiba_oly_pbp(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]'
Play-by-play of one Men's Olympic Basketball Tournament game.
Men's Olympic Basketball Tournament (men's); season rule: event year (Paris 2024 = 2024).
Convenience wrapper: a thin binding of fiba_gamepage_pbp 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.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
game_id | int | FIBA game id (game_id in the schedule). | |
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
game_id | integer | FIBA game id (Int64), global across competitions: gdapGameId, the |
competition_id | integer | FIBA competition id (Int64) of the game's edition; the comp argument. |
statistic_system | character | Live-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. |
period | character | Period name: Q1..Q4, then OT1, OT2... |
period_number | integer | 1-based position of the period in the game. |
action_id | character | Action id (String): ' |
order | integer | Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events. |
clock | character | Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime). |
clock_seconds | integer | Seconds remaining in the period, derived from clock. |
wall_time_ms | integer | Wall-clock time of the action, Unix epoch milliseconds. |
score_a | integer | Team A score after the action. |
score_b | integer | Team B score after the action. |
action_code | character | Action 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). |
action_family | character | Action family: shot, subst, timeout, periods, and 'unknwown' (FIBA's spelling) for every other action. |
description | character | English action text ('3pt jump shot missed', 'defensive rebound'); null on most OVR actions. |
organisation_id | integer | Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_ |
team_side | character | A or B: whether the row is the schedule's team A or team B (null when the page does not say). |
player_id | integer | FIBA person id (Int64), global across competitions and roles: the page's P_ |
player2_id | integer | FIBA person id (Int64) of the second player on a substitution; null when the game does not record it (the refs note FLS only, but the Paris 2024 final, an OVR game, carries it and the FLS games sampled leave it null). |
sub_direction | character | Substitution direction: IN or OUT; null on other actions. |
made | logical | True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise). |
points_attempted | integer | Points the attempt was worth (2, 3 or 1), made or not; null on other actions. |
shot_type | character | Shot type derived from action_code: 2PT, 3PT or FT; null on other actions. |
shot_x | integer | Shot 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_y | integer | Shot 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_location | logical | True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions. |
Example
from sportsdataverse.basketball.fiba_hub import fiba_oly_schedule, fiba_oly_pbp
games = fiba_oly_schedule(season=2024)
fiba_oly_pbp(game_id=int(games['game_id'][0]), season=2024)
fiba_oly_player_box
fiba_oly_player_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]'
Player box score of one Men's Olympic Basketball Tournament game.
Men's Olympic Basketball Tournament (men's); season rule: event year (Paris 2024 = 2024).
Convenience wrapper: a thin binding of fiba_gamepage_box_players 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.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
game_id | int | FIBA game id (game_id in the schedule). | |
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
game_id | integer | FIBA game id (Int64), global across competitions: gdapGameId, the |
competition_id | integer | FIBA competition id (Int64) of the game's edition; the comp argument. |
team_side | character | A or B: whether the row is the schedule's team A or team B (null when the page does not say). |
organisation_id | integer | Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_ |
player_id | integer | FIBA person id (Int64), global across competitions and roles: the page's P_ |
first_name | character | Given name(s) as registered with FIBA. |
last_name | character | Last name as registered with FIBA. |
jersey | character | Jersey number as a string. |
position | character | Playing position code from the lineup card (PG, SG, SF, PF, C). |
is_captain | logical | True for the team captain. |
is_starter | logical | True for the starting five. |
has_played | logical | True when the player got on the court. |
minutes | character | Minutes played as an 'm:ss' string ('0:0' = did not play). |
seconds_played | integer | Seconds played, derived from minutes. |
points | integer | Points scored in the game. |
fg_made | integer | Field goals made (2 + 3 points). |
fg_attempted | integer | Field goals attempted (2 + 3 points). |
fg_pct | numeric | Field-goal percentage, 0-100. |
fg2_made | integer | Two-point field goals made. |
fg2_attempted | integer | Two-point field goals attempted. |
fg2_pct | numeric | Two-point field-goal percentage, 0-100. |
fg3_made | integer | Three-point field goals made. |
fg3_attempted | integer | Three-point field goals attempted. |
fg3_pct | numeric | Three-point field-goal percentage, 0-100. |
ft_made | integer | Free throws made. |
ft_attempted | integer | Free throws attempted. |
ft_pct | numeric | Free-throw percentage, 0-100. |
reb_offensive | integer | Offensive rebounds. |
reb_defensive | integer | Defensive rebounds. |
reb_total | integer | Total rebounds (a team row includes the team rebounds team_reb_total). |
assists | integer | Assists credited in the game. |
steals | integer | Steals credited in the game. |
blocks | integer | Blocked shots (blocks made). |
blocks_received | integer | Own shots blocked by the opponent (blocks received). |
turnovers | integer | Turnovers (a team row includes the team turnovers team_turnovers). |
fouls | integer | Personal fouls (a team row includes the team fouls team_fouls). |
fouls_drawn | integer | Fouls drawn in the game. |
paint_fg_made | integer | Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game). |
paint_fg_attempted | integer | Field goals attempted in the paint. |
paint_fg_pct | numeric | Field-goal percentage in the paint, 0-100. |
efficiency | integer | Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers). |
plus_minus | integer | Plus/minus: the team's point differential while the player was on the court. |
cb | logical | Boolean flag, false on every sampled player; meaning unverified. |
Example
from sportsdataverse.basketball.fiba_hub import fiba_oly_schedule, fiba_oly_player_box
games = fiba_oly_schedule(season=2024)
fiba_oly_player_box(game_id=int(games['game_id'][0]), season=2024)
fiba_oly_schedule
fiba_oly_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 Men's Olympic Basketball Tournament edition, one row per game.
Men's Olympic Basketball Tournament (men's); season rule: event year (Paris 2024 = 2024).
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.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
game_id | integer | FIBA game id, global across competitions (GDAP key space): gdapGameId, the |
game_name | character | Technical game name ' |
game_number | character | Game number within the round or pairing (a string: '1', 'A'). |
status_code | character | Game status code: VALID (validated result), CLOS (closed, pre-2000 rows). |
team_a_team_id | integer | Competition 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_id | integer | Organisation 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_code | character | Team code (national: FIBA country code; club: a club abbreviation such as OOST). |
team_a_official_name | character | Official name of team A: the country for a national team, the club for a club team. |
team_a_short_name | character | Short name of team A: the country code for a national team, the club's short name for a club. |
team_b_team_id | integer | Competition 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_id | integer | Organisation 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_code | character | Team code (national: FIBA country code; club: a club abbreviation such as NANT). |
team_b_official_name | character | Official name of team B: the country for a national team, the club for a club team. |
team_b_short_name | character | Short name of team B: the country code for a national team, the club's short name for a club. |
team_a_score | integer | Final score of team A. |
team_b_score | integer | Final score of team B. |
is_live | logical | True while the game is being played. |
current_period | character | Last period reached ('Q4', 'OT1'). |
chrono | character | Game clock of the current period, 'mm:ss' ('00:00' when finished). |
live_game_status | integer | Live state code: 999 on every finished game; 5 seen on a finished 2024 youth game; mapping unverified. |
current_period_status | character | State of the current period: E = ended (the only value sampled). |
host_city | character | City of the venue. |
host_country | character | Country of the venue (name; a FIBA code in getgdapgameswithleaderdetailsbyteamid). |
host_country_code | character | FIBA code of the venue's country. |
venue_id | integer | Venue id (GDAP key space; 0 = unknown). |
venue_name | character | Name of the arena the game is played in. |
game_date_time | character | Tip-off in venue-local wall-clock time, ISO 8601 without offset (T00:00:00 when hasTimeGameDateTime is false). |
game_date_time_utc | character | Tip-off in UTC, ISO 8601 without the Z. |
has_time_game_date_time | logical | False when only the date is known (the time part is then 00:00:00). |
iana_time_zone | character | IANA time zone of the venue. |
utc_offset | character | Venue UTC offset at tip-off, hours. |
is_postponed | logical | True when the game was postponed. |
is_played_behind_closed_doors | logical | True when played without spectators. |
venue_capacity | integer | Venue capacity (0 = unknown). |
spectators | integer | Attendance at the game, as recorded by FIBA. |
statistic_system | character | Live-stats system that scored the game: OVR (FIBA's Olympic/World Cup system), FLS (FIBA LiveStats), null before about 2006. |
group_id | character | Group id (GDAP key space). |
group_pairing_code | character | Group letter (group play) or pairing number (knockout bracket slot). |
round_round_id | integer | Round id (GDAP key space, unique across competitions); the first segment of gameName. |
round_round_code | character | Round code (GP group phase, QF, SF, F final, RS regular season, CL17-32 classification...). |
round_round_name | character | Round label (Group Phase, Quarter-Finals, Final...). |
round_round_number | integer | Round number within the competition (1-based). |
round_round_type | character | Round type label: Group Round, Non Group Round, Super Round (getgdapgamesbycompetitionid uses the code G/NG here). |
round_round_status_code | character | Round status: COMPL completed, PROGR in progress, CLOS closed. |
round_game_system | character | Pairing system label (Single, Home and Away, Best of 3). |
round_game_system_code | character | Pairing system code: S single game, HA home and away, BOF3 best of three. |
round_start_date | character | Round start, local date-time. |
round_end_date | character | Round end, local date-time (23:59:59.9999999 on the last day). |
round_round_kind | character | Standard Round or Qualifiers. |
round_round_order | integer | Display order of the round. |
competition_competition_id | integer | FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId. |
competition_competition_code | character | Competition code (WMM men's World Cup, WOLYM, BCL, ELW...). |
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 | Edition title (FIBA Basketball World Cup; Paris 2024 Men's Olympic Basketball Tournament). |
competition_start | character | First day, YYYY-MM-DD. |
competition_end | character | Last day, YYYY-MM-DD. |
competition_status | character | Competition status: In Progress, Completed, Closed. |
competition_age_category | character | Age category (Senior, Under 16...). |
competition_gender | character | Men or Women: the gender of the competition. |
competition_fiba_zone | character | FIBA zone the competition belongs to (World, Europe, Americas...). |
competition_zone_information_zone_id | integer | FIBA zone id (1 = World, 23 = Europe; zone table key space). |
competition_zone_information_zone_official_name | character | Official name of the competition's FIBA zone (FIBA Europe, FIBA Americas, World). |
competition_zone_information_zone_code | character | Zone code (W, E, AF, AM, AS, OC). |
competition_zone_information_top_zone_id | integer | Parent zone id; null for top zones. |
competition_zone_information_top_zone_official_name | character | Parent zone name; always null in the samples, values unverified. |
competition_zone_information_top_zone_code | character | Parent zone code; always null in the samples, values unverified. |
competition_competition_type | character | National Teams or Clubs. |
competition_competition_category_is_league | logical | True for league-format club competitions. |
competition_competition_category_age_type | character | Age type code: S senior, U16. |
competition_competition_category_code | character | Category code (WC World Cup, OLY Olympic Tournament, CCC-1 continental club tier 1). |
competition_competition_category_name | character | Name of the competition's category (FIBA Basketball World Cup, Olympic Basketball Tournament...). |
competition_official_flag_item_code | character | Official-status code: O = official. |
competition_official_flag_item_name | character | Official-status label. |
competition_official | character | Official-status label. |
competition_discipline | character | Discipline (Basketball; 3x3 is a separate platform). |
competition_competition_marketing_name_competition_marketing_name_id | integer | Competition family id (201 = World Cup, 112 = BCL tier 1, 211 = EuroLeague Women); the |
competition_competition_marketing_name_marketing_name | character | Competition family name; slugified it is the |
competition_competition_marketing_name_code | character | Family code; null in every sample. |
game_statistic_status_code | character | Box-score validation status: VALID. |
game_play_by_play_status_code | character | Play-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_code | character | Result validation status: VALID. |
game_result_additional_information | character | Free-text result note (forfeit, overtime remark); null when none. |
window_code | character | Qualifier window code; null otherwise. |
window_name | character | Qualifier window name; null otherwise. |
team_a_from | character | How team A qualified for this slot ('Winner of Game 87', '1st of group C'); null in group play. |
team_b_from | character | How team B qualified for this slot ('Winner of Game 88', '2nd of group A'); null in group play. |
Example
from sportsdataverse.basketball.fiba_hub import fiba_oly_schedule
fiba_oly_schedule(season=2024)
fiba_oly_shots
fiba_oly_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 Men's Olympic Basketball Tournament game.
Men's Olympic Basketball Tournament (men's); season rule: event year (Paris 2024 = 2024).
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.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
game_id | int | FIBA game id (game_id in the schedule). | |
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
game_id | integer | FIBA game id (Int64), global across competitions: gdapGameId, the |
competition_id | integer | FIBA competition id (Int64) of the game's edition; the comp argument. |
statistic_system | character | Live-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. |
period | character | Period name: Q1..Q4, then OT1, OT2... |
period_number | integer | 1-based position of the period in the game. |
action_id | character | Action id (String): ' |
order | integer | Sort key within the period (OVR: 1, 2, ...; FLS: 1000, 2000, ...); null on some period events. |
clock | character | Game clock: time REMAINING in the period, 'm:ss', counting down from 10:00 (5:00 in overtime). |
clock_seconds | integer | Seconds remaining in the period, derived from clock. |
action_code | character | Action 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_id | integer | Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_ |
team_side | character | A or B: whether the row is the schedule's team A or team B (null when the page does not say). |
player_id | integer | FIBA person id (Int64), global across competitions and roles: the page's P_ |
shot_type | character | Shot type derived from action_code: 2PT, 3PT or FT; null on other actions. |
points_attempted | integer | Points the attempt was worth (2, 3 or 1), made or not; null on other actions. |
made | logical | True when the shot went in (two-pointers, three-pointers and free throws only; null otherwise). |
shot_x | integer | Shot 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_y | integer | Shot 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_location | logical | True when shot_x / shot_y locate the shot (two- and three-pointers); False for free throws (always 0, 0); null on other actions. |
Example
from sportsdataverse.basketball.fiba_hub import fiba_oly_schedule, fiba_oly_shots
games = fiba_oly_schedule(season=2024)
fiba_oly_shots(game_id=int(games['game_id'][0]), season=2024)
fiba_oly_standings
fiba_oly_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 Men's Olympic Basketball Tournament edition.
Men's Olympic Basketball Tournament (men's); season rule: event year (Paris 2024 = 2024).
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.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
competition_id | integer | FIBA competition id (Int64) the final ranking belongs to; the comp argument. |
final_rank | integer | Final rank in the competition. |
team_team_id | integer | Competition 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_code | character | Team abbreviation (FIBA country code or club abbreviation). |
team_short_name | character | Short team name: the country code for a national team, the club's short name for a club. |
team_profile | character | Team profile; null in this route. |
team_status_code | character | Team entry status; always null in the samples, values unverified. |
team_status_name | character | Team entry status label; always null in the samples, values unverified. |
team_organisation_id | integer | Organisation 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_ |
Example
from sportsdataverse.basketball.fiba_hub import fiba_oly_standings
fiba_oly_standings(season=2024)
fiba_oly_team_box
fiba_oly_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 Men's Olympic Basketball Tournament game.
Men's Olympic Basketball Tournament (men's); season rule: event year (Paris 2024 = 2024).
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.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
game_id | int | FIBA game id (game_id in the schedule). | |
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
game_id | integer | FIBA game id (Int64), global across competitions: gdapGameId, the |
competition_id | integer | FIBA competition id (Int64) of the game's edition; the comp argument. |
statistic_system | character | Live-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_side | character | A or B: whether the row is the schedule's team A or team B (null when the page does not say). |
organisation_id | integer | Stable federation or club id (Int64) of the team, the same in every competition (64 = Germany); the page's T_ |
score | integer | Team final score. |
points | integer | Points scored in the game. |
fg_made | integer | Field goals made (2 + 3 points). |
fg_attempted | integer | Field goals attempted (2 + 3 points). |
fg_pct | numeric | Field-goal percentage, 0-100. |
fg2_made | integer | Two-point field goals made. |
fg2_attempted | integer | Two-point field goals attempted. |
fg2_pct | numeric | Two-point field-goal percentage, 0-100. |
fg3_made | integer | Three-point field goals made. |
fg3_attempted | integer | Three-point field goals attempted. |
fg3_pct | numeric | Three-point field-goal percentage, 0-100. |
ft_made | integer | Free throws made. |
ft_attempted | integer | Free throws attempted. |
ft_pct | numeric | Free-throw percentage, 0-100. |
reb_offensive | integer | Offensive rebounds. |
reb_defensive | integer | Defensive rebounds. |
reb_total | integer | Total rebounds (a team row includes the team rebounds team_reb_total). |
assists | integer | Assists credited in the game. |
steals | integer | Steals credited in the game. |
blocks | integer | Blocked shots (blocks made). |
blocks_received | character | Own shots blocked by the opponent (blocks received). |
turnovers | integer | Turnovers (a team row includes the team turnovers team_turnovers). |
fouls | integer | Personal fouls (a team row includes the team fouls team_fouls). |
fouls_drawn | integer | Fouls drawn in the game. |
paint_fg_made | integer | Field goals made in the paint (team points_in_paint = 2 x paint_fg_made on every sampled game). |
paint_fg_attempted | integer | Field goals attempted in the paint. |
paint_fg_pct | numeric | Field-goal percentage in the paint, 0-100. |
efficiency | integer | Efficiency (FIBA EFF: points + rebounds + assists + steals + blocks - missed field goals - missed free throws - turnovers). |
biggest_lead | integer | Biggest lead, points. |
biggest_lead_score | character | Score when the biggest lead was reached, 'A-B' string (spacing varies; empty when the team never led). |
biggest_run | integer | Biggest scoring run, points. |
biggest_run_score | character | Score of the biggest scoring run, 'x-y' string; exact meaning unverified. |
fast_break_points | integer | Fast-break points. |
points_off_turnovers | integer | Points scored after turnovers. |
bench_points | integer | Points from the bench (the sum of the non-starters' points). |
points_in_paint | integer | Points in the paint (2 x paint_fg_made). |
second_chance_points | integer | Second-chance points. |
a_act | integer | Always 0 in the samples; meaning unverified (FIBA stat code A_ACT). |
a_foul | integer | Always 0 in the samples; meaning unverified (FIBA stat code A_FOUL). |
a_tod | integer | Always 0 in the samples; meaning unverified (FIBA stat code A_TOD). |
a_tot | integer | Always 0 in the samples; meaning unverified (FIBA stat code A_TOT). |
team_reb_offensive | integer | Team offensive rebounds, credited to no player. |
team_reb_defensive | integer | Team defensive rebounds, credited to no player. |
team_reb_total | integer | Team rebounds (total rebounds minus the players' sum). |
team_fouls | integer | Team (bench/coach) fouls (personal fouls minus the players' sum). |
team_turnovers | integer | Team turnovers (turnovers minus the players' sum). |
team_bench_points_flag | integer | Bench points in FLS games (equal to bench_points); 0 in OVR games (FIBA stat code T_PFB). |
time_led | character | Time the team led, 'mm:ss' string. |
lead_changes | integer | Lead changes in the game (game-level; repeats on both team rows). |
times_tied | integer | Times the score was tied (game-level; repeats on both team rows). |
duration | character | Game duration as an 'h:mm' string (game-level; repeats on both team rows). |
attendance | integer | Attendance (game-level; repeats on both team rows). |
Example
from sportsdataverse.basketball.fiba_hub import fiba_oly_schedule, fiba_oly_team_box
games = fiba_oly_schedule(season=2024)
fiba_oly_team_box(game_id=int(games['game_id'][0]), season=2024)
fiba_oly_teams
fiba_oly_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 Men's Olympic Basketball Tournament edition.
Men's Olympic Basketball Tournament (men's); season rule: event year (Paris 2024 = 2024).
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.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
season | Optional[int] | None | Edition season key (see the season rule above). Omitted = the newest edition that has started. |
comp | Optional[int] | None | FIBA competition id (one per edition); skips the edition lookup. Needed when a season lists several editions. |
return_parsed | bool | True | parse into a polars DataFrame (default True); False returns the raw body. |
return_as_pandas | bool | False | with 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_name | type | description |
|---|---|---|
team_id | integer | Competition 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_code | character | Team abbreviation (FIBA country code or club abbreviation). |
short_name | character | Short team name: the country code for a national team, the club's short name for a club. |
profile_team_id | integer | Competition 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_id | integer | Organisation 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_name | character | Team name as registered for the competition. |
profile_code | character | Team code (FIBA country code or club abbreviation). |
profile_country_name | character | Country of the team, in English. |
profile_country_code | character | Country FIBA code. |
profile_gender | character | Men or Women: the gender of the team's competition. |
profile_facebook | character | Facebook handle or URL; always null in the samples, values unverified. |
profile_twitter | character | X/Twitter handle; always null in the samples, values unverified. |
profile_instagram | character | Instagram handle; always null in the samples, values unverified. |
profile_website | character | The team's website address. |
profile_you_tube | character | YouTube handle; always null in the samples, values unverified. |
profile_final_ranking | integer | Final rank in the competition. |
profile_points_per_game | numeric | The team's average points per game played. |
profile_rebounds_per_game | numeric | The team's average rebounds per game played. |
profile_assists_per_game | numeric | The team's average assists per game played. |
profile_rank_points_per_game | numeric | Rank in the competition by points per game (1 = highest). |
profile_rank_rebounds_per_game | numeric | Rank in the competition by rebounds per game (1 = highest). |
profile_rank_assists_per_game | numeric | Rank in the competition by assists per game (1 = highest). |
profile_total_games_won | integer | The team's total games won over the games played. |
profile_total_games_lost | integer | The team's total games lost over the games played. |
profile_social_networks | character | Social-network handles. Stored as a JSON string. |
profile_competition_id | integer | FIBA competition id (GDAP key space): one per edition (2023 World Cup = 208182, BCL 2024-25 = 208850); gdapCompetitionId. |
status_code | character | Team entry status: APPR approved. |
status_name | character | Team entry status label (Approved). |
organisation_id | integer | Organisation 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_ |
Example
from sportsdataverse.basketball.fiba_hub import fiba_oly_teams
fiba_oly_teams(season=2024)