Skip to main content

DBL — Basketligaen site API (www.basketligaen.dk/api, Denmark; Sportality) — Team

sportality_team​

One team.

Endpoint URL: GET https://www.basketligaen.dk/api/sports-v2/teams/{team_uuid}

Valid URL: https://www.basketligaen.dk/api/sports-v2/teams/rfo82vr830

API ParameterPythonPatternRequiredNullableDescription
team_uuidteam_uuidYTeam uuid: homeTeamInfo.uuid / awayTeamInfo.uuid in the schedule or teamList[].uuid. Key space: platform team uuids (not the numeric Genius team id).

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
names_codecharacterThree-letter team code (HOL, RAN ...); codes changed between seasons for some clubs (BAK in 2026, BKA in 2025 for Bakken Bears).
names_shortcharacterShort name of the team.
names_longcharacterLong name of the team.
names_fullcharacterFull name of the team.
names_code_sitecharacterTeam code as the club's own site shows it.
names_short_sitecharacterShort team name as the club's own site shows it.
names_full_sitecharacterFull team name as the club's own site shows it.
names_long_sitecharacterLong team name as the club's own site shows it.
infocharacterDetail record (shape depends on the route; see the child columns).
uuidcharacterPlatform uuid of this record (10-character lowercase key space of its record type; joins the route that serves it).
nationalitycharacterISO 3166-1 alpha-2 country code.
arena_namecharacterName of the arena.
public_urlcharacterThe club's own website.
iconcharacterTeam logo URL (SVG on sportality.cdn.s8y.se).
owner_instance_idcharacterSite instance id of the club that owns the team (platform key space, e.g. hol2_hol).
site_display_namecharacterTeam name as the league site displays it.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

sportality_team(team_uuid='rfo82vr830')

Last validated n/a.

sportality_team_played_games​

A team's recent games (current season view).

Endpoint URL: GET https://www.basketligaen.dk/api/sports-v2/played-games/{team_uuid}

Valid URL: https://www.basketligaen.dk/api/sports-v2/played-games/rfo82vr830

API ParameterPythonPatternRequiredNullableDescription
team_uuidteam_uuidYTeam uuid: homeTeamInfo.uuid / awayTeamInfo.uuid in the schedule or teamList[].uuid. Key space: platform team uuids (not the numeric Genius team id).

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
datecharacterGame date, 'D mon YY' in English ('10 oct 26').
timecharacterLocal start time 'HH:MM' (Europe/Copenhagen).
game_uuidcharacterPlatform game uuid (c4hh5nig6t); every gameday route takes it.
start_date_timecharacterScheduled start. On the schedule route this is the LOCAL (Europe/Copenhagen) wall time 'YYYY-MM-DD HH:MM:SS' with no zone; on the other routes it is ISO 8601 UTC with milliseconds (compare rawStartDateTime).
statecharacterGame state. Schedule and day views: pre-game or post-game (hyphen). sports-v2 game-info: post_game (underscore). Gameday overview: GameEnded. Values: post-game = played (schedule, day views).
overtimelogicalWhether the game went to overtime.
shootoutcharacterUnobserved: null in every sample and every full body. When filled: Whether the game was decided by a shootout (null on every game seen; basketball has none).
ssgt_uuidcharacterssgt uuid (platform key space: one season + series + game type); joins /statistics-v2/layout-info seasonSeriesGameTypeTeams[].ssgtUuid and every route keyed by ssgt.
home_team_statuscharacterWIN or LOSE for the home team once the game is played; absent or empty before. Values: LOSE = the team lost; WIN = the team won.
home_team_uuidcharacterHome team uuid (platform key space); joins /sports-v2/teams/{team_uuid}.
home_team_owner_instance_idcharacterSite instance id of the club that owns the team (platform key space, e.g. hol2_hol).
home_team_codecharacterThree-letter code of the home team.
home_team_names_codecharacterThree-letter team code (HOL, RAN ...); codes changed between seasons for some clubs (BAK in 2026, BKA in 2025 for Bakken Bears).
home_team_names_shortcharacterShort name of the team.
home_team_names_longcharacterLong name of the team.
home_team_names_fullcharacterFull name of the team.
home_team_names_code_sitecharacterTeam code as the club's own site shows it.
home_team_names_short_sitecharacterShort team name as the club's own site shows it.
home_team_names_full_sitecharacterFull team name as the club's own site shows it.
home_team_names_long_sitecharacterLong team name as the club's own site shows it.
home_team_scoreintegerHome points; null before the game is played.
home_team_iconcharacterHome team logo URL.
away_team_statuscharacterWIN or LOSE for the away team once the game is played; absent or empty before. Values: LOSE = the team lost; WIN = the team won.
away_team_uuidcharacterAway team uuid (platform key space); joins /sports-v2/teams/{team_uuid}.
away_team_owner_instance_idcharacterSite instance id of the club that owns the team (platform key space, e.g. hol2_hol).
away_team_codecharacterThree-letter code of the away team.
away_team_names_codecharacterThree-letter team code (HOL, RAN ...); codes changed between seasons for some clubs (BAK in 2026, BKA in 2025 for Bakken Bears).
away_team_names_shortcharacterShort name of the team.
away_team_names_longcharacterLong name of the team.
away_team_names_fullcharacterFull name of the team.
away_team_names_code_sitecharacterTeam code as the club's own site shows it.
away_team_names_short_sitecharacterShort team name as the club's own site shows it.
away_team_names_full_sitecharacterFull team name as the club's own site shows it.
away_team_names_long_sitecharacterLong team name as the club's own site shows it.
away_team_scoreintegerAway points; null before the game is played.
away_team_iconcharacterAway team logo URL.
venue_uuidcharacterVenue uuid (platform key space).
venue_namecharacterVenue name; absent when unknown.
series_uuidcharacterSeries uuid (platform key space).
series_codecharacterSeries display name (Basketligaen; NOT the DBL code).
series_display_namecharacterSeries display name (Basketligaen).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

sportality_team_played_games(team_uuid='rfo82vr830')

Last validated n/a.

sportality_team_stats​

Team totals per period (2023/24 on).

Endpoint URL: GET https://www.basketligaen.dk/api/gameday/team-stats/{game_uuid}

Valid URL: https://www.basketligaen.dk/api/gameday/team-stats/c4hh5nig6t

API ParameterPythonPatternRequiredNullableDescription
game_uuidgame_uuidYGame uuid: gameInfo[].uuid of the schedule (10 lowercase letters and digits). Key space: platform game uuids; the Genius match id is extId / gameSourceId in the body.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_sidecharacterhome or away: the side the row belongs to.
game_source_idintegerGenius match id (Int64), the same number as game_id and sports-v2 game_info_ext_id.
game_idintegerGenius match id (Int64), the join to the genius family; on play-by-play lines, an integer elsewhere.
team_idintegerGenius team id (Int64): in gameday bodies, an integer in standings and stats tables.
team_namecharacterName of the team.
team_codecharacterPlatform team code (HOL, RAN).
team_numberintegerTeam number; home is 1.
instance_idcharacterSite instance that owns the feed (platform key space; dbl1_dbl).
sourcecharacterFeed that produced the row (genius-basketball-stream-reader).
game_uuidcharacterPlatform game uuid (c4hh5nig6t); every gameday route takes it.
periodintegerPeriod: 0 = the whole game, 1-4 the quarters, 5 and up overtime.
period_typecharacterREGULAR or OVERTIME; absent on the whole-game row of some eras. Values: REGULAR = regulation period.
tpintegerPoints scored by the team in the period (period 0 = the whole game).
fgmintegerField goals made (total).
aintegerAssists (total).
rebintegerTotal rebounds.
stlintegerNumber of steals.
blkintegerNumber of blocked shots made.
pfintegerPersonal fouls.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

sportality_team_stats(game_uuid='c4hh5nig6t')

Last validated n/a.

sportality_team_upcoming_games​

A team's next games (current season view).

Endpoint URL: GET https://www.basketligaen.dk/api/sports-v2/upcoming-games/{team_uuid}

Valid URL: https://www.basketligaen.dk/api/sports-v2/upcoming-games/rfo82vr830

API ParameterPythonPatternRequiredNullableDescription
team_uuidteam_uuidYTeam uuid: homeTeamInfo.uuid / awayTeamInfo.uuid in the schedule or teamList[].uuid. Key space: platform team uuids (not the numeric Genius team id).

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
datecharacterGame date, 'D mon YY' in English.
timecharacterLocal start time 'HH:MM' (Europe/Copenhagen).
game_uuidcharacterPlatform game uuid (c4hh5nig6t); every gameday route takes it.
start_date_timecharacterScheduled start. On the schedule route this is the LOCAL (Europe/Copenhagen) wall time 'YYYY-MM-DD HH:MM:SS' with no zone; on the other routes it is ISO 8601 UTC with milliseconds (compare rawStartDateTime).
statecharacterGame state. Schedule and day views: pre-game or post-game (hyphen). sports-v2 game-info: post_game (underscore). Gameday overview: GameEnded. Values: pre-game = not yet played (schedule, day views).
overtimelogicalWhether the game went to overtime.
shootoutcharacterUnobserved: null in every sample and every full body. When filled: Whether the game was decided by a shootout (null on every game seen; basketball has none).
ssgt_uuidcharacterssgt uuid (platform key space: one season + series + game type); joins /statistics-v2/layout-info seasonSeriesGameTypeTeams[].ssgtUuid and every route keyed by ssgt.
home_team_statuscharacterWIN or LOSE for the home team once the game is played; absent or empty before. Values: N/A = no result yet / not applicable.
home_team_uuidcharacterHome team uuid (platform key space); joins /sports-v2/teams/{team_uuid}.
home_team_owner_instance_idcharacterSite instance id of the club that owns the team (platform key space, e.g. hol2_hol).
home_team_codecharacterThree-letter code of the home team.
home_team_names_codecharacterThree-letter team code (HOL, RAN ...); codes changed between seasons for some clubs (BAK in 2026, BKA in 2025 for Bakken Bears).
home_team_names_shortcharacterShort name of the team.
home_team_names_longcharacterLong name of the team.
home_team_names_fullcharacterFull name of the team.
home_team_names_code_sitecharacterTeam code as the club's own site shows it.
home_team_names_short_sitecharacterShort team name as the club's own site shows it.
home_team_names_full_sitecharacterFull team name as the club's own site shows it.
home_team_names_long_sitecharacterLong team name as the club's own site shows it.
home_team_scoreintegerHome points; null before the game is played.
home_team_iconcharacterHome team logo URL.
away_team_statuscharacterWIN or LOSE for the away team once the game is played; absent or empty before. Values: N/A = no result yet / not applicable.
away_team_uuidcharacterAway team uuid (platform key space); joins /sports-v2/teams/{team_uuid}.
away_team_owner_instance_idcharacterSite instance id of the club that owns the team (platform key space, e.g. hol2_hol).
away_team_codecharacterThree-letter code of the away team.
away_team_names_codecharacterThree-letter team code (HOL, RAN ...); codes changed between seasons for some clubs (BAK in 2026, BKA in 2025 for Bakken Bears).
away_team_names_shortcharacterShort name of the team.
away_team_names_longcharacterLong name of the team.
away_team_names_fullcharacterFull name of the team.
away_team_names_code_sitecharacterTeam code as the club's own site shows it.
away_team_names_short_sitecharacterShort team name as the club's own site shows it.
away_team_names_full_sitecharacterFull team name as the club's own site shows it.
away_team_names_long_sitecharacterLong team name as the club's own site shows it.
away_team_scoreintegerAway points; null before the game is played.
away_team_iconcharacterAway team logo URL.
venue_uuidcharacterVenue uuid (platform key space).
venue_namecharacterVenue name; absent when unknown.
series_uuidcharacterSeries uuid (platform key space).
series_codecharacterSeries display name (Basketligaen; NOT the DBL code).
series_display_namecharacterSeries display name (Basketligaen).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

sportality_team_upcoming_games(team_uuid='rfo82vr830')

Last validated n/a.