Skip to contents

Returns NHL team information for a given team abbreviation. Uses the new NHL API via nhl_teams.

Breaking change: The old team_id (integer) parameter has been replaced by team_abbr (3-letter string, e.g., "TBL") because the new NHL API no longer exposes numeric team IDs as a primary identifier.

Usage

nhl_teams_info(team_abbr)

Arguments

team_abbr

Three-letter team abbreviation (e.g., "TBL", "TOR", "SEA")

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_info(team_abbr = "TBL"))
#> ── NHL Teams Information from NHL.com ───────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-13 03:26:09 UTC
#> # A tibble: 1 × 20
#>   team_abbr team_name team_common_name team_logo conference_abbr conference_name
#>   <chr>     <chr>     <chr>            <chr>     <chr>           <chr>          
#> 1 TBL       Tampa Ba… Lightning        https://… Eastern         Eastern        
#> # ℹ 14 more variables: 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>
# }