Skip to main content

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

sportality_game_header​

Game header: Genius match id (extId), arena, state, teams, scores.

Endpoint URL: GET https://www.basketligaen.dk/api/sports-v2/game-info/{game_uuid}

Valid URL: https://www.basketligaen.dk/api/sports-v2/game-info/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
instance_context_site_team_is_in_gamelogicalWhether the requesting site's own team plays in the game.
instance_context_site_team_is_home_teamlogicalWhether the requesting site's own team is the home team.
instance_context_site_team_is_away_teamlogicalWhether the requesting site's own team is the away team.
game_info_game_uuidcharacterGame uuid (platform key space).
game_info_ext_idintegerGenius match id (Int64; the same number as gameday game_source_id).
game_info_start_date_timecharacterScheduled start, ISO 8601 UTC with milliseconds.
game_info_arena_namecharacterName of the arena (venue).
game_info_statecharacterGame state, underscore form: post_game once played. Values: post_game = played (sports-v2 game-info).
game_info_overtimelogicalWhether the game went to overtime.
game_info_shootoutcharacterUnobserved: null in every sample and every full body. When filled: Shootout flag (null on every game seen).
game_info_series_codecharacterSeries code (DBL).
game_info_series_namecharacterSeries name (Basketligaen).
game_info_round_numberintegerRound number (0).
game_info_round_labelcharacterRound label ('').
game_info_series_display_namecharacterSeries display name (Basketligaen).
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_uuidcharacterHome team uuid (platform key space); joins /sports-v2/teams/{team_uuid}.
home_team_instance_idcharacterSite instance id of the home club (platform key space).
home_team_founded_oncharacterYear the club was founded ('' when unknown).
home_team_iconcharacterHome team logo URL.
home_team_scoreintegerPoints scored by the home 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_uuidcharacterAway team uuid (platform key space); joins /sports-v2/teams/{team_uuid}.
away_team_instance_idcharacterSite instance id of the away club (platform key space).
away_team_founded_oncharacterYear the club was founded ('' when unknown).
away_team_iconcharacterAway team logo URL.
away_team_scoreintegerPoints scored by the away team.
ssgt_uuidcharacterssgt uuid (platform key space: one season + series + game type); joins /statistics-v2/layout-info seasonSeriesGameTypeTeams[].ssgtUuid and every route keyed by ssgt.
series_uuidcharacterSeries uuid (platform key space; Basketligaen = m1ay3mpa4t, the only series on this host).

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

Example​

sportality_game_header(game_uuid='c4hh5nig6t')

Last validated n/a.

sportality_game_overview​

Score, state, clock and the Genius ids of one game (2023/24 on).

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

Valid URL: https://www.basketligaen.dk/api/gameday/game-overview/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
game_uuidcharacterPlatform game uuid (c4hh5nig6t); every gameday route takes it.
home_team_game_source_idintegerGenius match id (Genius key space; integer here).
home_team_game_idintegerGenius match id (Genius key space; the same number as gameSourceId).
home_team_team_idintegerGenius team id of the home team (Genius key space; Int64).
home_team_team_namecharacterName of the home team.
home_team_team_codecharacterHome team code as Genius spells it (mixed case, 'Hol').
home_team_team_numberintegerTeam number in the game; home is 1.
home_team_placecharacterhome. Values: home = home team.
home_team_instance_idcharacterSite instance id of the home club (platform key space).
home_team_sourcecharacterFeed that produced the row (genius-basketball-stream-reader).
home_team_game_uuidcharacterGame uuid (platform key space).
away_team_game_source_idintegerGenius match id (Genius key space; integer here).
away_team_game_idintegerGenius match id (Genius key space; the same number as gameSourceId).
away_team_team_idintegerGenius team id of the away team (Genius key space; Int64).
away_team_team_namecharacterName of the away team.
away_team_team_codecharacterAway team code as Genius spells it.
away_team_team_numberintegerTeam number in the game; away is 2.
away_team_placecharacteraway. Values: away = away team.
away_team_instance_idcharacterSite instance id of the away club (platform key space).
away_team_sourcecharacterFeed that produced the row (genius-basketball-stream-reader).
away_team_game_uuidcharacterGame uuid (platform key space).
home_goalsintegerPoints scored by the home team.
away_goalsintegerPoints scored by the away team.
statecharacterGame state. Schedule and day views: pre-game or post-game (hyphen). sports-v2 game-info: post_game (underscore). Gameday overview: GameEnded. Values: GameEnded = played (gameday overview).
time_game_idintegerGenius match id (Genius key space).
time_periodintegerPeriod number the clock stands in (1-4 regulation, 5+ overtime).
time_period_timecharacterClock remaining in the period, 'hh:mm:ss' ('00:00:00' once the period or game is over).
time_instance_idcharacterSite instance that owns the feed (platform key space; dbl1_dbl).
time_sourcecharacterFeed that produced the row (genius-basketball-stream-reader).

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

Example​

sportality_game_overview(game_uuid='c4hh5nig6t')

Last validated n/a.

sportality_game_summary​

Points per period, team comparison and best scorers (2023/24 on).

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

Valid URL: https://www.basketligaen.dk/api/gameday/game-info/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_head2_headcharacterTeam comparison rows (2P, 3P, FT, rebounds, ...), home and away side by side.
team_period_captioncharacterColumn caption of the table (G = goals/points). Values: G = goals/points column.
team_period_overtimelogicalWhether the game went to overtime.
team_period_shootoutlogicalWhether the game was decided by a shootout (false).
team_period_statscharacterOne row per period.
best_scorerscharacterThe game's top scorers, one per side (or the two best).
statistics_providercharacterStats provider of the data (genius-basketball = Genius Sports LiveStats).

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

Example​

sportality_game_summary(game_uuid='c4hh5nig6t')

Last validated n/a.