Skip to contents

One game's lineups, both teams: line, role, jersey, captaincy and bio.

Usage

liiga_game_lineups(season, game_id)

Arguments

season

Season END year (2026 = 2025-26). Game ids repeat across seasons, so a game is (season, game_id).

game_id

Game id (game_id in liiga_schedule or liiga_games), e.g. 1; unique only within a season.

Value

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

col_nametypedescription
seasonintegerSeason END year (2026 = 2025-26).
game_idintegerGame id, unique only within a season: key a game as (season, game_id).
sidecharacterWhich team of the game the row belongs to: home or away.
player_idintegerPlayer id; the same number in lineups, rosters, stat tables and the profile (fihaId).
team_idintegerTeam id, the number of Liiga's <num>:<slug> team key (sent as that string, a bare integer or a digit string depending on the route).
team_slugcharacterTeam slug, the part of Liiga's <num>:<slug> team key after the colon (e.g. hpk).
team_namecharacterTeam's display name, e.g. HPK or Tappara.
lineintegerLine number 1-4; null for goalkeepers and extras.
country_of_birthcharacterCountry of birth, 3-letter code.
place_of_birthcharacterPlayer's place of birth (town or city).
date_of_birthcharacterDate of birth, YYYY-MM-DD.
nationalitycharacterNationality, 3-letter code.
first_namecharacterPlayer's first name.
last_namecharacterPlayer's last name.
rolecharacterPosition: CENTER, LEFT_WING, RIGHT_WING, LEFT_DEFENSEMAN, RIGHT_DEFENSEMAN, SEVENTH_DEFENSEMAN, GOALIE.
role_codecharacterPosition code, Finnish: KH = centre, VL/OL = left/right wing, VP/OP = left/right defence, 7. P = seventh defenceman, MV = goalkeeper.
handednesscharacterShoots LEFT or RIGHT.
heightintegerPlayer's height in centimetres.
weightintegerPlayer's weight in kilograms.
captainlogicalTrue when the player is the team captain (C).
rookielogicalTrue when Liiga flags the player as a rookie.
alternate_captainlogicalTrue when the player is an alternate captain (A).
jerseyintegerJersey (sweater) number the player wore.
picture_urlcharacterURL of the player's photo.
injuredlogicalTrue when the player is listed as injured.
suspendedlogicalTrue when the player is listed as suspended.
removedlogicalRemoved from the roster.
awardscharacterPlayer awards of the game (stars).
sponsorscharacterPlayer's sponsors; null in every capture (unverified).
extra_descriptioncharacterExtra profile text for the player; null in every capture (meaning unverified).
extra_strengthscharacterExtra profile field for the player's strengths; null in every capture (unverified).
extra_rookie_picturelogicalFlag for an extra rookie picture on the player's profile (meaning unverified).

Details

Endpoint: GET https://liiga.fi/api/v2/games/{season}/{game_id}

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_game_lineups(game_id = 1, season = 2026))
#> ── Liiga game lineups Information from liiga.fi ────── fastRhockey 1.0.0.9000 ──
#> ℹ Data updated: 2026-10-13 01:55:13 UTC
#> # A tibble: 62 × 32
#>    season game_id side  player_id  team_id team_slug team_name  line
#>     <int>   <int> <chr>     <int>    <int> <chr>     <chr>     <int>
#>  1   2026       1 home   21870028 55786244 hpk       HPK           1
#>  2   2026       1 home   22709389 55786244 hpk       HPK           2
#>  3   2026       1 home   23029644 55786244 hpk       HPK           3
#>  4   2026       1 home   23806498 55786244 hpk       HPK           1
#>  5   2026       1 home   29885743 55786244 hpk       HPK           1
#>  6   2026       1 home   30417647 55786244 hpk       HPK           1
#>  7   2026       1 home   30670073 55786244 hpk       HPK           3
#>  8   2026       1 home   30851669 55786244 hpk       HPK           2
#>  9   2026       1 home   31585390 55786244 hpk       HPK           2
#> 10   2026       1 home   32919839 55786244 hpk       HPK           4
#> # ℹ 52 more rows
#> # ℹ 24 more variables: country_of_birth <chr>, place_of_birth <chr>,
#> #   date_of_birth <chr>, nationality <chr>, first_name <chr>, last_name <chr>,
#> #   role <chr>, role_code <chr>, handedness <chr>, height <int>, weight <int>,
#> #   captain <lgl>, rookie <lgl>, alternate_captain <lgl>, jersey <int>,
#> #   picture_url <chr>, injured <lgl>, suspended <lgl>, removed <lgl>,
#> #   awards <chr>, sponsors <chr>, extra_description <chr>, …
# }