Skip to contents

Team faceoffs by zone (offensive, neutral, defensive) per game: taken, won and lost.

Reads the Swiss Ice Hockey Federation statistics API (data.sihf.ch, keyless JSON). SIHF keys a season by its END year (2026 = 2025-26). An unknown season, league_id or phase_id is never an error upstream (SIHF silently answers another one), so every table answer is checked against the body's own filter echo and refused when it differs. Every request is spaced at least one second from the last one to the host.

Usage

sihf_team_faceoffs_by_zone_per_game(
  season,
  league_id = 1L,
  phase_id = NULL,
  language = "en"
)

Arguments

season

Required. Season by its END year (2026 = 2025-26). A season SIHF does not have raises fastRhockey_no_data error (the API itself silently answers another one).

league_id

SIHF league id: 1 = National League, 2 = Swiss League, 100 = MyHockey League, 3 = 1. Liga, 43 = SWHL B, 113 = U21-Elit (the body's League filter lists them). An id SIHF does not have for the season raises fastRhockey_no_data error.

phase_id

SIHF phase id (regular season, a playoff round, ...; the body's Phase filter lists them). NULL = no phase filter: the season summary over every phase.

language

Response language. Only part of the body is translated: status, position and penalty names stay German.

Value

A fastRhockey_data tibble with 17 columns. A zero-row tibble with these columns when the payload holds no rows.

col_nametypedescription
seasonintegerSeason by its END year (2026 = 2025-26), from the body's echo of the Season filter.
phase_idintegerSIHF phase id (regular season, a playoff round, ...); null unless a phase filter is passed.
rankintegerRank in the table; null on a summary row, and on a goaltender below the qualification line.
team_idintegerSIHF team id (integer join key); null on a summary row (the pseudo-team 100000).
team_namecharacterTeam display name as SIHF publishes it; "Durchschnitt" on the league-average row, "Total" on the attendance total row.
team_acronymcharacterTeam abbreviation as SIHF publishes it (e.g., "HCD"); null on a summary row.
games_playedintegerGames played in the table's scope.
faceoffs_offensive_per_gamenumericFaceoffs taken per game, offensive zone.
faceoffs_won_offensive_per_gamenumericFaceoffs won per game, offensive zone.
faceoffs_lost_offensive_per_gamenumericFaceoffs lost per game, offensive zone.
faceoffs_neutral_per_gamenumericFaceoffs taken per game, neutral zone.
faceoffs_won_neutral_per_gamenumericFaceoffs won per game, neutral zone.
faceoffs_lost_neutral_per_gamenumericFaceoffs lost per game, neutral zone.
faceoffs_defensive_per_gamenumericFaceoffs taken per game, defensive zone.
faceoffs_won_defensive_per_gamenumericFaceoffs won per game, defensive zone.
faceoffs_lost_defensive_per_gamenumericFaceoffs lost per game, defensive zone.
row_typecharacter"data" for a regular row; "average" (league average) or "total" (attendance total) for a summary row SIHF mixes into the table.

Errors

  • fastRhockey_no_data: SIHF answered 404 (unknown game), or ignored a requested season, league or phase and served another one.

  • fastRhockey_bad_request: SIHF answered 400 / 422, or an argument is invalid.

  • fastRhockey_asset_fetch: any other non-2xx answer or a dead connection after retries, an empty or unreadable body, a stub or redirect body, a table without its filter echo, a truncated table, or a gameoverview body for another game.

Examples

# \donttest{
  try(sihf_team_faceoffs_by_zone_per_game(season = 2026, league_id = 1))
#> ── SIHF Team Faceoffs By Zone Per Game Information from data.sihf.ch ───────────
#> ℹ Data updated: 2026-10-13 02:00:00 UTC
#> # A tibble: 15 × 17
#>    season phase_id  rank team_id team_name             team_acronym games_played
#>     <int>    <int> <int>   <int> <chr>                 <chr>               <int>
#>  1   2026       NA    14  101150 HC Lugano             HCL                    60
#>  2   2026       NA    13  102126 SC Bern               SCB                    60
#>  3   2026       NA    12  101149 EHC Kloten            EHCK                   52
#>  4   2026       NA    11  103138 Fribourg-Gottéron     FRI                    90
#>  5   2026       NA    10  102128 EHC Biel-Bienne       EHCB                   56
#>  6   2026       NA     9  101151 HC Davos              HCD                    86
#>  7   2026       NA     8  103141 Lausanne HC           LHC                    66
#>  8   2026       NA     7  101144 EV Zug                EVZ                    66
#>  9   2026       NA     6  103140 Genève-Servette HC    GSHC                   76
#> 10   2026       NA    NA      NA Durchschnitt          NA                     65
#> 11   2026       NA     5  101139 ZSC Lions             ZSC                    70
#> 12   2026       NA     4  101152 HC Ambri-Piotta       HCAP                   56
#> 13   2026       NA     3  103144 HC Ajoie              HCA                    56
#> 14   2026       NA     2  101060 SC Rapperswil-Jona L… SCRJ                   74
#> 15   2026       NA     1  102127 SCL Tigers            SCL                    52
#> # ℹ 10 more variables: faceoffs_offensive_per_game <dbl>,
#> #   faceoffs_won_offensive_per_game <dbl>,
#> #   faceoffs_lost_offensive_per_game <dbl>, faceoffs_neutral_per_game <dbl>,
#> #   faceoffs_won_neutral_per_game <dbl>, faceoffs_lost_neutral_per_game <dbl>,
#> #   faceoffs_defensive_per_game <dbl>, faceoffs_won_defensive_per_game <dbl>,
#> #   faceoffs_lost_defensive_per_game <dbl>, row_type <chr>
# }