Skip to contents

Schedule of a season and tournament: game ids, teams, goals, xG, start and rink.

Usage

liiga_schedule(season = NULL, tournament = NULL)

Arguments

season

Season END year (2026 = 2025-26). Omitted = the season in progress.

tournament

Tournament: runkosarja (regular season), playoffs, playout, qualifications, valmistavat_ottelut (preseason) or chl (Champions Hockey League). Omitted = runkosarja.

Value

A fastRhockey_data tibble (35 columns; zero rows when a valid payload has none).

col_nametypedescription
game_idintegerGame id, unique only within a season: key a game as (season, game_id).
serie_idintegerTournament id, the same every season: 1188 regular season, 1189 playoffs, 1194 preseason, 1890 CHL.
seasonintegerSeason END year (2026 = 2025-26).
home_team_namecharacterDisplay name of the home team, e.g. HPK.
away_team_namecharacterDisplay name of the away team, e.g. TPS.
home_team_idintegerHome team id (the number of the <num>:<slug> key).
home_team_slugcharacterHome team slug (e.g. hpk).
away_team_idintegerAway team id (the number of the <num>:<slug> key).
away_team_slugcharacterAway team slug (e.g. tps).
home_team_placeholdercharacterPlaceholder label for an undecided playoff home team, else null.
away_team_placeholdercharacterPlaceholder label for an undecided playoff away team, else null.
home_team_goalsintegerGoals scored by the home team in the game.
away_team_goalsintegerGoals scored by the away team in the game.
expected_home_team_goalsnumericHome team's expected goals (xG) for the game, provider-computed (same value as /games homeTeam.expectedGoals).
expected_away_team_goalsnumericAway team's expected goals (xG) for the game, provider-computed.
game_timeintegerSeconds from the start of the game. Regular season: 3900 (65:00) = the end of the 5-minute overtime; playoff overtime runs past it.
startedlogicalGame has started.
endedlogicalGame has ended.
home_team_winnerlogicalTrue when the home team won the game.
spectatorsintegerAttendance (spectators) reported for the game.
home_team_rankingintegerHome team's table position; null in every capture.
away_team_rankingintegerAway team's table position; null in every capture.
play_off_pairintegerPlayoff pairing number, else null.
play_off_phaseintegerPlayoff round, else null.
play_off_req_winsintegerWins needed to take the series, else null.
startcharacterScheduled start, ISO 8601 UTC.
buy_tickets_urlcharacterTicket link, else null.
finished_typecharacterHow the game ended: ENDED_DURING_REGULAR_GAME_TIME, ENDED_DURING_EXTENDED_GAME_TIME (overtime), ENDED_DURING_WINNING_SHOT_COMPETITION (shootout).
ice_rink_idintegerLiiga's id of the rink (ice arena).
ice_rink_namecharacterName of the rink (ice arena).
ice_rink_latitudenumericRink latitude, decimal degrees.
ice_rink_longitudenumericRink longitude, decimal degrees.
ice_rink_street_addresscharacterStreet address of the rink.
ice_rink_zipcharacterPostal code of the rink.
ice_rink_citycharacterCity where the rink is located.

Details

Endpoint: GET https://liiga.fi/api/v2/schedule

Seasons are END years (2026 = 2025-26), the same key as sdv-py. Requests to liiga.fi are spaced at least one second apart. A request Liiga answers with nothing (an unknown game, a tournament not played that season, a shot map before 2016) raises fastRhockey_no_data; a failed fetch or an error-shaped answer raises fastRhockey_asset_fetch; a bad argument raises fastRhockey_bad_request.

Examples

# \donttest{
  try(liiga_schedule(season = 2026, tournament = "runkosarja"))
#> ── Liiga schedule Information from liiga.fi ────────── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:55:32 UTC
#> # A tibble: 480 × 35
#>    game_id serie_id season home_team_name away_team_name home_team_id
#>      <int>    <int>  <int> <chr>          <chr>                 <int>
#>  1       1     1188   2026 HPK            TPS                55786244
#>  2       2     1188   2026 Jukurit        HIFK              292293444
#>  3       3     1188   2026 KooKoo         Ässät             461765763
#>  4       4     1188   2026 Kärpät         Sport             495643563
#>  5       6     1188   2026 Pelicans       K-Espoo           875886777
#>  6       8     1188   2026 SaiPa          KalPa             933686567
#>  7       5     1188   2026 Lukko          Tappara           624554857
#>  8       7     1188   2026 JYP            Ilves             219244634
#>  9       9     1188   2026 JYP            Jukurit           219244634
#> 10      10     1188   2026 Kärpät         Ilves             495643563
#> # ℹ 470 more rows
#> # ℹ 29 more variables: home_team_slug <chr>, away_team_id <int>,
#> #   away_team_slug <chr>, home_team_placeholder <chr>,
#> #   away_team_placeholder <chr>, home_team_goals <int>, away_team_goals <int>,
#> #   expected_home_team_goals <dbl>, expected_away_team_goals <dbl>,
#> #   game_time <int>, started <lgl>, ended <lgl>, home_team_winner <lgl>,
#> #   spectators <int>, home_team_ranking <int>, away_team_ranking <int>, …
# }