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 the season starts in (e.g., 2024 for 2024-25; most_recent_nhl_season() returns the year it ends). 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.9000 ──
#> ℹ Data updated: 2026-10-13 01:58:15 UTC
#> # A tibble: 32 × 20
#>    team_abbr team_name            team_common_name team_logo     conference_abbr
#>    <chr>     <chr>                <chr>            <chr>         <chr>          
#>  1 CAR       Carolina Hurricanes  Hurricanes       https://asse… Eastern        
#>  2 OTT       Ottawa Senators      Senators         https://asse… Eastern        
#>  3 VGK       Vegas Golden Knights Golden Knights   https://asse… Western        
#>  4 NYR       New York Rangers     Rangers          https://asse… Eastern        
#>  5 EDM       Edmonton Oilers      Oilers           https://asse… Western        
#>  6 TBL       Tampa Bay Lightning  Lightning        https://asse… Eastern        
#>  7 ANA       Anaheim Ducks        Ducks            https://asse… Western        
#>  8 SEA       Seattle Kraken       Kraken           https://asse… Western        
#>  9 UTA       Utah Mammoth         Mammoth          https://asse… Western        
#> 10 BOS       Boston Bruins        Bruins           https://asse… 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>
# }