Skip to contents

Returns current NHL team information. Uses the NHL API standings endpoint to get up-to-date team info.

Usage

nhl_teams(season = NULL)

Arguments

season

Integer four-digit year (e.g., 2024). If NULL, returns current teams.

Value

A data frame (fastRhockey_data) with the following columns:

col_nametypesdescription
team_abbrcharacterTeam abbreviation.
team_namecharacterTeam name.
team_common_namecharacterTeam common name.
team_logocharacterURL to the team logo image.
conference_abbrcharacterConference abbreviation.
conference_namecharacterConference name.
division_abbrcharacterDivision abbreviation.
division_namecharacterDivision name.
place_namecharacterTeam place/city name.
games_playedintegerGames played.
winsintegerWins.
lossesintegerLosses.
ot_lossesintegerOvertime losses.
pointsintegerTotal points.
point_pctgnumericPoints percentage.
goals_forintegerGoals for.
goals_againstintegerGoals against.
goal_differentialintegerGoal differential.
streak_codecharacterCurrent streak code (W/L/OT).
streak_countintegerLength of the current streak.

Examples

# \donttest{
  try(nhl_teams())
#> ── NHL Teams ────────────────────────────────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-13 04:22:10 UTC
#> # A tibble: 32 × 20
#>    team_abbr team_name           team_common_name team_logo      conference_abbr
#>    <chr>     <chr>               <chr>            <chr>          <chr>          
#>  1 COL       Colorado Avalanche  Avalanche        https://asset… Western        
#>  2 CAR       Carolina Hurricanes Hurricanes       https://asset… Eastern        
#>  3 DAL       Dallas Stars        Stars            https://asset… Western        
#>  4 BUF       Buffalo Sabres      Sabres           https://asset… Eastern        
#>  5 TBL       Tampa Bay Lightning Lightning        https://asset… Eastern        
#>  6 MTL       Montréal Canadiens  Canadiens        https://asset… Eastern        
#>  7 MIN       Minnesota Wild      Wild             https://asset… Western        
#>  8 BOS       Boston Bruins       Bruins           https://asset… Eastern        
#>  9 OTT       Ottawa Senators     Senators         https://asset… Eastern        
#> 10 PIT       Pittsburgh Penguins Penguins         https://asset… Eastern        
#> # ℹ 22 more rows
#> # ℹ 15 more variables: conference_name <chr>, division_abbr <chr>,
#> #   division_name <chr>, place_name <chr>, games_played <int>, wins <int>,
#> #   losses <int>, ot_losses <int>, points <int>, point_pctg <dbl>,
#> #   goals_for <int>, goals_against <int>, goal_differential <int>,
#> #   streak_code <chr>, streak_count <int>
# }