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
robots.txt ruling. www.nationalleague.ch/robots.txt disallows /api. The owner approved building on it
on 2026-10-12, for polite, incremental use only: requests are spaced at least one second apart (on every
attempt, retries included), and a bulk backfill or a published mirror needs the owner's sign-off first. 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-10-13 01:58:20 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>, …
# }