Skip to contents

Wraps GET https://www.shl.se/api/sports-v2/next-game-day 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_next_game_day(season = NULL, game_type = "regular", return_parsed = TRUE)

Arguments

season

Season END year (2026 = 2025/26), mapped to its ssgt through layout-info. None = the active ssgt (these match-day views follow the current season).

game_type

Game type: regular (Grundserie), playoff (Slutspel), qualdown (relegation qualification) or playin (2023/24 on).

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.
start_date_timecharacterScheduled start, local time (Europe/Stockholm).
statecharacterGame state: pre-game or post-game (hyphenated; a live value was not observed).
overtimelogicalWhether the game went to overtime.
shootoutlogicalWhether the game went to a shootout.
ssgt_uuidcharacterssgt uuid (platform key space: one season + series + game type); label via layout-info seasonSeriesGameTypeTeams[].
home_team_statuscharacterResult for the team (WIN, LOSE) or record status.
home_team_uuidcharacterTeam uuid (platform key space, e.g. 087a-087aTQv9u); joins to /sports-v2/teams/{team_uuid} and schedule homeTeamInfo/awayTeamInfo.uuid. Not the team code.
home_team_owner_instance_idcharacterClub site instance id (e.g. fhc1_fhc); also names the logo at sportality.cdn.s8y.se/team-logos/{id}.svg.
home_team_codecharacterHome team code (e.g. FHC); joins to gameday teamId and the code-keyed teams maps.
home_team_names_codecharacterDisplay abbreviation; differs from the team code for some clubs (SKE vs SAIK, ÖRE vs OHK).
home_team_names_shortcharacterShort club name ('Herr' = men's team).
home_team_names_longcharacterLong club name ('Herr' = men's team).
home_team_names_fullcharacterFull club name ('Herr' = men's team).
home_team_names_code_sitecharacterDisplay abbreviation on the site; 'Herr' = men's team (e.g. 'DIF Herr').
home_team_names_short_sitecharacterShort club name as shown on the site ('Herr' = men's team).
home_team_names_full_sitecharacterFull club name as shown on the site ('Herr' = men's team).
home_team_names_long_sitecharacterLong club name as shown on the site ('Herr' = men's team).
home_team_scoreintegerGoals scored by the team in the game.
home_team_iconcharacterURL of the team logo image.
away_team_statuscharacterResult for the team (WIN, LOSE) or record status.
away_team_uuidcharacterTeam uuid (platform key space, e.g. 087a-087aTQv9u); joins to /sports-v2/teams/{team_uuid} and schedule homeTeamInfo/awayTeamInfo.uuid. Not the team code.
away_team_owner_instance_idcharacterClub site instance id (e.g. fhc1_fhc); also names the logo at sportality.cdn.s8y.se/team-logos/{id}.svg.
away_team_codecharacterAway team code (e.g. LHC); joins to gameday teamId and the code-keyed teams maps.
away_team_names_codecharacterDisplay abbreviation; differs from the team code for some clubs (SKE vs SAIK, ÖRE vs OHK).
away_team_names_shortcharacterShort club name ('Herr' = men's team).
away_team_names_longcharacterLong club name ('Herr' = men's team).
away_team_names_fullcharacterFull club name ('Herr' = men's team).
away_team_scoreintegerGoals scored by the team in the game.
away_team_iconcharacterURL of the team logo image.
venue_uuidcharacterArena uuid (platform key space).
venue_namecharacterName of the arena (venue).
series_uuidcharacterSeries uuid (platform key space; SHL = qQ9-bb0bzEWUk).
series_codecharacterSeries code (SHL, CHL).
series_display_namecharacterSeries label shown on the site (SHL, CHL).
away_team_names_code_sitecharacterDisplay abbreviation on the site; 'Herr' = men's team (e.g. 'DIF Herr').
away_team_names_short_sitecharacterShort club name as shown on the site ('Herr' = men's team).
away_team_names_full_sitecharacterFull club name as shown on the site ('Herr' = men's team).
away_team_names_long_sitecharacterLong club name as shown on the site ('Herr' = men's team).

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_next_game_day()
#> ── SHL Next Game Day Information from www.shl.se ───── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:59:18 UTC
#> # A tibble: 7 × 39
#>   game_uuid  start_date_time  state overtime shootout ssgt_uuid home_team_status
#>   <chr>      <chr>            <chr> <lgl>    <lgl>    <chr>     <chr>           
#> 1 blr9i7wd72 2026-10-15T17:0… pre-… FALSE    FALSE    qa98unlb… N/A             
#> 2 pdllryhpd8 2026-10-15T17:0… pre-… FALSE    FALSE    qa98unlb… N/A             
#> 3 pkjfr73iqb 2026-10-15T17:0… pre-… FALSE    FALSE    qa98unlb… N/A             
#> 4 pqcc7xg1m4 2026-10-15T17:0… pre-… FALSE    FALSE    qa98unlb… N/A             
#> 5 s3fwiszzmr 2026-10-15T17:0… pre-… FALSE    FALSE    qa98unlb… N/A             
#> 6 uxqethue6t 2026-10-15T17:0… pre-… FALSE    FALSE    qa98unlb… N/A             
#> 7 x0ws1h01an 2026-10-15T17:0… pre-… FALSE    FALSE    qa98unlb… N/A             
#> # ℹ 32 more variables: home_team_uuid <chr>, home_team_owner_instance_id <chr>,
#> #   home_team_code <chr>, home_team_names_code <chr>,
#> #   home_team_names_short <chr>, home_team_names_long <chr>,
#> #   home_team_names_full <chr>, home_team_names_code_site <chr>,
#> #   home_team_names_short_site <chr>, home_team_names_full_site <chr>,
#> #   home_team_names_long_site <chr>, home_team_score <int>,
#> #   home_team_icon <chr>, away_team_status <chr>, away_team_uuid <chr>, …
# }