Skip to contents

Wraps GET https://www.shl.se/api/sports-v2/upcoming-games/{team_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_team_upcoming_games(team_uuid, game_place = NULL, return_parsed = TRUE)

Arguments

team_uuid

Team uuid (homeTeamInfo.uuid / awayTeamInfo.uuid in the schedule, or teamList[].uuid).

game_place

Home/away filter; empty means all. No effect in the drop-one probe.

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
datecharacterDate (YYYY-MM-DD).
timecharacterGame clock in the period (MM:SS, counting up from 00:00). Clock/duration as an mm:ss string.
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_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).
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).

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_team_upcoming_games(team_uuid = "087a-087aTQv9u")
#> ── SHL Team Upcoming Games Information from www.shl.se ─────────────────────────
#> ℹ Data updated: 2026-10-13 01:59:34 UTC
#> # A tibble: 5 × 41
#>   date   time  game_uuid     start_date_time   state overtime shootout ssgt_uuid
#>   <chr>  <chr> <chr>         <chr>             <chr> <lgl>    <lgl>    <chr>    
#> 1 13 oct 17:00 qQ1-5b5lF3Mi5 2026-10-13T17:00… pre-… FALSE    FALSE    aigy31hp…
#> 2 15 oct 17:00 pdllryhpd8    2026-10-15T17:00… pre-… FALSE    FALSE    qa98unlb…
#> 3 17 oct 13:15 et9erhx0si    2026-10-17T13:15… pre-… FALSE    FALSE    qa98unlb…
#> 4 20 oct 17:00 mtn5yq64mp    2026-10-20T17:00… pre-… FALSE    FALSE    qa98unlb…
#> 5 22 oct 17:00 no64p8kr92    2026-10-22T17:00… pre-… FALSE    FALSE    qa98unlb…
#> # ℹ 33 more variables: home_team_status <chr>, 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>, …
# }