Skip to contents

Wraps GET https://www.shl.se/api/gameday/game-overview/{game_uuid} of the SHL site API (www.shl.se). Unofficial use of a public source; seasons are END years (2026 = 2025/26) and are mapped to the site's ssgt uuids through /statistics-v2/layout-info.

Usage

shl_game_overview(game_uuid, return_parsed = TRUE)

Arguments

game_uuid

Game uuid (gameInfo[].uuid from /sports-v2/game-schedule). gameday/* has data from 2023/24 on; older games answer 200 with an empty body.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw decoded JSON as a list.

Value

A fastRhockey_data tibble (the raw JSON list when return_parsed = FALSE) with the following columns:

col_nametypedescription
game_uuidcharacterPlatform game uuid (bdhvuc5tex); every gameday route takes it.
home_team_game_source_idcharacterStatNet game key, date-HOME-AWAY (e.g. 20250913-FHC-LHC); the same game as gameId.
home_team_game_idintegerStatNet game number (StatNet key space, e.g. 22003); keys stats-info games and equals sports-v2 game-info extId. Not the game uuid.
home_team_placecharacterSide of the game: home or away.
home_team_scoreintegerGoals scored by the team in the game.
home_team_team_idcharacterTeam code (e.g. FHC) in gameday and standings payloads; not the team uuid.
home_team_team_namecharacterTeam display name (e.g. Frölunda HC).
home_team_team_codecharacterTeam code (FHC, LHC, ...).
home_team_game_uuidcharacterGame uuid (platform key space, e.g. bdhvuc5tex); joins to schedule gameInfo[].uuid and every gameday/{game_uuid} route. The StatNet number of the same game is gameId.
away_team_game_source_idcharacterStatNet game key, date-HOME-AWAY (e.g. 20250913-FHC-LHC); the same game as gameId.
away_team_game_idintegerStatNet game number (StatNet key space, e.g. 22003); keys stats-info games and equals sports-v2 game-info extId. Not the game uuid.
away_team_placecharacterSide of the game: home or away.
away_team_scoreintegerGoals scored by the team in the game.
away_team_team_idcharacterTeam code (e.g. FHC) in gameday and standings payloads; not the team uuid.
away_team_team_namecharacterTeam display name (e.g. Frölunda HC).
away_team_team_codecharacterTeam code (FHC, LHC, ...).
away_team_game_uuidcharacterGame uuid (platform key space, e.g. bdhvuc5tex); joins to schedule gameInfo[].uuid and every gameday/{game_uuid} route. The StatNet number of the same game is gameId.
home_goalsintegerHome goals after this event (running score).
away_goalsintegerAway goals after this event (running score).
statecharacterStatNet game state (GameEnded seen).
time_periodintegerPeriod (1-3, 4 = overtime, 5 = shootout).
time_period_timecharacterTime in period (MM:SS). Clock/duration as an mm:ss string.

Errors

fastRhockey_no_data: the host answered 404, an empty body (gameday routes before 2023/24), a table with no rows, or the season and game type are not in layout-info. fastRhockey_asset_fetch: any other non-2xx answer or a dead connection after retries, a non-JSON or error-envelope 200, a stats-info page that reaches count or falls short of its totalCount, or a body for another game, team, athlete or ssgt than the one asked for. fastRhockey_bad_request: a 400 / 422, a season that is not a year, or an argument outside its choices.

Examples

# \donttest{
  shl_game_overview(game_uuid = "bdhvuc5tex")
#> ── SHL Game Overview Information from www.shl.se ───── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:59:13 UTC
#> # A tibble: 1 × 22
#>   game_uuid  home_team_game_source_id home_team_game_id home_team_place
#>   <chr>      <chr>                                <int> <chr>          
#> 1 bdhvuc5tex 20250913-FHC-LHC                     22003 home           
#> # ℹ 18 more variables: home_team_score <int>, home_team_team_id <chr>,
#> #   home_team_team_name <chr>, home_team_team_code <chr>,
#> #   home_team_game_uuid <chr>, away_team_game_source_id <chr>,
#> #   away_team_game_id <int>, away_team_place <chr>, away_team_score <int>,
#> #   away_team_team_id <chr>, away_team_team_name <chr>,
#> #   away_team_team_code <chr>, away_team_game_uuid <chr>, home_goals <int>,
#> #   away_goals <int>, state <chr>, time_period <int>, time_period_time <chr>
# }