One game's header: teams, date, status, final and per-period score, coaches, referees, arena, attendance.
Arguments
- game_id
SIHF game id, 14 digits
<season(4)><competition(4)><sequence(6)>(game_idinnl_schedule(); the same id as the SIHF family'sgame_id), e.g.20261105000325. A whole number or a digit string; 14 digits are exact as a double, so do not format them throughinteger.- return_parsed
Logical.
TRUE(the default) returns thefastRhockey_datatibble;FALSEreturns the raw JSON body as a nested list (api keys already dropped).
Value
A fastRhockey_data tibble (47 columns) with the columns below, or the raw JSON body when return_parsed = FALSE.
A valid but empty payload returns a zero-row tibble with these columns.
| col_name | type | description |
| game_id | numeric | SIHF game id <season(4)><competition(4)><sequence(6)> (whole number; e.g. 20261105000325, 1105 = National League). The same id as the sihf family's game_id; its first four digits are the season END year. |
| home_team_short_name | character | Home team abbreviation (e.g. HCD) |
| home_team_name | character | Home team display name |
| away_team_short_name | character | Away team abbreviation |
| away_team_name | character | Away team display name |
| home_team_id | numeric | Home team. SIHF team id (whole number; e.g. 101151 = HC Davos). The same key space as the sihf family's team_id. |
| away_team_id | numeric | Away team. SIHF team id (whole number; e.g. 101151 = HC Davos). The same key space as the sihf family's team_id. |
| vimeo_video_id | numeric | Full-game video. Vimeo video id (whole number): vimeo.com/<id>. |
| date | character | Scheduled start, ISO 8601 with UTC offset |
| status | character | Game state: finished, canceled, beforeStartOfPlay (others appear live) |
| base_status | character | Coarse game state; equal to status in every sampled game |
| home_team_result | integer | Home team goals (final or current score; 0 before the game) |
| away_team_result | integer | Away team goals (final or current score; 0 before the game) |
| is_overtime | logical | Game went to overtime |
| is_shootout | logical | Game went to a shootout |
| highlight_vimeo_video_id | numeric | Highlights video. Vimeo video id (whole number): vimeo.com/<id>. |
| has_highlight | logical | A highlight video exists |
| is_current | logical | Game belongs to the current game day |
| is_current_for_team | logical | Game is the team's current game (team-scoped views) |
| tv_partner | character | Broadcaster logo image URLs |
| spectators | integer | Attendance (whole number; the API sends a digit string). |
| has_my_sports | logical | Broadcast on MySports |
| referees | character | Officials as '#<number> <name>' strings (referees and linesmen; one entry in some games) |
| is_exhibition | logical | Exhibition game, not NL competition (competition code other than 1105) |
| home_team_coach | character | Home head coach name; filled in a game's overview, null in the season lists |
| away_team_coach | character | Away head coach name; filled in a game's overview, null in the season lists |
| game_time | integer | Elapsed game minutes; 0 on every game in the season lists, 60 in a finished game's overview |
| show_game_time | logical | App flag: show gameTime |
| arena | character | Name of the arena the game is played in |
| home_team_first_result | integer | Home goals in the 1st period |
| away_team_first_result | integer | Away goals in the 1st period |
| home_team_second_result | integer | Home goals in the 2nd period |
| away_team_second_result | integer | Away goals in the 2nd period |
| home_team_third_result | integer | Home goals in the 3rd period |
| away_team_third_result | integer | Away goals in the 3rd period |
| home_team_overtime_result | integer | Home overtime goals, all overtime periods |
| away_team_overtime_result | integer | Away overtime goals, all overtime periods |
| home_team_overtime1_result | integer | Home goals in overtime period 1 (playoff games can have several) |
| away_team_overtime1_result | integer | Away goals in overtime period 1 |
| home_team_overtime2_result | integer | Home goals in overtime period 2 |
| away_team_overtime2_result | integer | Away goals in overtime period 2 |
| home_team_overtime3_result | integer | Home goals in overtime period 3 |
| away_team_overtime3_result | integer | Away goals in overtime period 3 |
| home_team_shootout_result | integer | Home shootout goals |
| away_team_shootout_result | integer | Away shootout goals |
| home_aggregated_score | character | Home aggregate over a two-legged tie; unobserved: null or empty in every sampled row |
| away_aggregated_score | character | Away aggregate over a two-legged tie; unobserved: null or empty in every sampled row |
Details
Polite use. www.nationalleague.ch/robots.txt disallows /api, so keep use light and incremental. Requests
are spaced at least one second apart (on every attempt, retries included). Check the site's terms of use before
any bulk download or redistribution. Crawl incrementally: fetch a finished game once (keyed by game_id), find new games with one nl_schedule() call
per run, and fetch season tables at most once per game day.
Seasons are END years and go on the wire unchanged. Ids (*_id) are whole-number numeric (a 14-digit
game_id exceeds R's 32-bit integer); every other whole-number column is integer. The club backend key the
API ships in /teams/{id}/info is dropped before parsing and never returned.
Endpoint: GET https://www.nationalleague.ch/api/games/{gameId}.
The six game-page wrappers (nl_game_overview(), nl_pbp(), nl_lineups(), nl_player_box(),
nl_team_stats(), nl_shots()) each read the same /games/{gameId} body, one request each.
Errors
Raises a classed condition (all inherit fastRhockey_error): fastRhockey_no_data for a 404 or an empty answer (no
games or rows for that season, team or phase), fastRhockey_asset_fetch for a failed fetch, an error object in a 200, a body
without the ids it must carry, or an answer for another season, team, game or player, and fastRhockey_bad_request
for a 400/422 or an argument that is not a whole number.
See also
Other National League Functions:
nl_current_games(),
nl_lineups(),
nl_pbp(),
nl_player_box(),
nl_player_season(),
nl_player_stats(),
nl_playoffs(),
nl_playouts(),
nl_schedule(),
nl_shots(),
nl_standings(),
nl_team_info(),
nl_team_player_stats(),
nl_team_schedule(),
nl_team_stats(),
nl_top_scorers()
Examples
# \donttest{
try(nl_game_overview(game_id = 20261105000325))
#> ── National League Game Overview Information from nationalleague.ch ────────────
#> ℹ Data updated: 2026-11-02 03:51:44 UTC
#> # A tibble: 1 × 47
#> game_id home_team_short_name home_team_name away_team_short_name
#> <dbl> <chr> <chr> <chr>
#> 1 2.03e13 HCD HC Davos SCL
#> # ℹ 43 more variables: away_team_name <chr>, home_team_id <dbl>,
#> # away_team_id <dbl>, vimeo_video_id <dbl>, date <chr>, status <chr>,
#> # base_status <chr>, home_team_result <int>, away_team_result <int>,
#> # is_overtime <lgl>, is_shootout <lgl>, highlight_vimeo_video_id <dbl>,
#> # has_highlight <lgl>, is_current <lgl>, is_current_for_team <lgl>,
#> # tv_partner <chr>, spectators <int>, has_my_sports <lgl>, referees <chr>,
#> # is_exhibition <lgl>, home_team_coach <chr>, away_team_coach <chr>, …
# }