Skip to contents

Returns schedule data for a given team. Supports season, month, and week views.

Usage

nhl_club_schedule(
  team_abbr,
  season = NULL,
  month = NULL,
  view = "season",
  date = NULL
)

Arguments

team_abbr

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

season

Integer 4-digit end year of the season (e.g., 2026 for the 2025-26 season), matching most_recent_nhl_season(). If NULL, returns the current season schedule.

month

Character month in "YYYY-MM" format (e.g., "2025-01"). If provided, returns that month's schedule. Ignored if view is "week".

view

Character: "season" (default), "month", or "week".

date

Character date in "YYYY-MM-DD" format for week view. If NULL with view="week", returns current week.

Value

A data frame (fastRhockey_data) with the following columns:

col_nametypesdescription
idintegerUnique game identifier.
seasonintegerSeason in 8-digit API format (e.g., 20252026).
game_typeintegerGame type code (1 preseason, 2 regular, 3 playoff).
game_datecharacterGame date.
neutral_sitelogicalWhether the game is at a neutral site.
start_time_utccharacterScheduled start time in UTC.
eastern_utc_offsetcharacterEastern time UTC offset.
venue_utc_offsetcharacterVenue UTC offset.
venue_timezonecharacterVenue time zone.
game_statecharacterCurrent game state.
game_schedule_statecharacterSchedule state of the game.
tv_broadcastslistNested list of TV broadcast details.
three_min_recapcharacterLink to the three-minute recap.
game_center_linkcharacterLink to the game center page.
three_min_recap_frcharacterLink to the French three-minute recap.
condensed_game_frcharacterLink to the French condensed game video.
condensed_gamecharacterLink to the condensed game video.
venue_defaultcharacterVenue name (default language).
venue_frcharacterVenue name (French).
venue_escharacterVenue name (Spanish).
away_team_idintegerAway team identifier.
away_team_abbrevcharacterAway team abbreviation.
away_team_logocharacterURL to the away team logo.
away_team_dark_logocharacterURL to the away team dark logo.
away_team_away_split_squadlogicalWhether the away team is a split squad.
away_team_scoreintegerAway team score.
away_team_hotel_linkcharacterLink to away team hotel info.
away_team_hotel_desccharacterAway team hotel description.
away_team_airline_linkcharacterLink to away team airline info.
away_team_airline_desccharacterAway team airline description.
away_team_common_name_defaultcharacterAway team common name (default language).
away_team_common_name_frcharacterAway team common name (French).
away_team_place_name_defaultcharacterAway team place name (default language).
away_team_place_name_frcharacterAway team place name (French).
away_team_place_name_with_preposition_defaultcharacterAway team place name with preposition (default).
away_team_place_name_with_preposition_frcharacterAway team place name with preposition (French).
home_team_idintegerHome team identifier.
home_team_abbrevcharacterHome team abbreviation.
home_team_logocharacterURL to the home team logo.
home_team_dark_logocharacterURL to the home team dark logo.
home_team_home_split_squadlogicalWhether the home team is a split squad.
home_team_scoreintegerHome team score.
home_team_hotel_linkcharacterLink to home team hotel info.
home_team_hotel_desccharacterHome team hotel description.
home_team_airline_linkcharacterLink to home team airline info.
home_team_airline_desccharacterHome team airline description.
home_team_common_name_defaultcharacterHome team common name (default language).
home_team_common_name_frcharacterHome team common name (French).
home_team_place_name_defaultcharacterHome team place name (default language).
home_team_place_name_frcharacterHome team place name (French).
home_team_place_name_with_preposition_defaultcharacterHome team place name with preposition (default).
home_team_place_name_with_preposition_frcharacterHome team place name with preposition (French).
period_descriptor_period_typecharacterPeriod type descriptor.
period_descriptor_max_regulation_periodsintegerMaximum number of regulation periods.
game_outcome_last_period_typecharacterPeriod type in which the game ended.
winning_goalie_player_idintegerWinning goalie player identifier.
winning_goalie_first_initial_defaultcharacterWinning goalie first initial (default language).
winning_goalie_last_name_defaultcharacterWinning goalie last name (default language).
winning_goalie_last_name_cscharacterWinning goalie last name (Czech).
winning_goalie_last_name_ficharacterWinning goalie last name (Finnish).
winning_goalie_last_name_skcharacterWinning goalie last name (Slovak).
winning_goalie_last_name_svcharacterWinning goalie last name (Swedish).
winning_goal_scorer_player_idintegerWinning goal scorer player identifier.
winning_goal_scorer_first_initial_defaultcharacterWinning goal scorer first initial (default).
winning_goal_scorer_last_name_defaultcharacterWinning goal scorer last name (default language).
winning_goal_scorer_last_name_cscharacterWinning goal scorer last name (Czech).
winning_goal_scorer_last_name_skcharacterWinning goal scorer last name (Slovak).
winning_goal_scorer_last_name_ficharacterWinning goal scorer last name (Finnish).
team_abbrcharacterTeam abbreviation queried.

Examples

# \donttest{
  try(nhl_club_schedule(team_abbr = "TOR"))
#> ── NHL Club Schedule ────────────────────────────────────── fastRhockey 1.0.0 ──
#>  Data updated: 2026-06-13 03:24:53 UTC
#> # A tibble: 88 × 69
#>            id   season game_type game_date  neutral_site start_time_utc      
#>         <int>    <int>     <int> <chr>      <lgl>        <chr>               
#>  1 2025010010 20252026         1 2025-09-21 FALSE        2025-09-21T19:00:00Z
#>  2 2025010025 20252026         1 2025-09-23 FALSE        2025-09-23T23:00:00Z
#>  3 2025010037 20252026         1 2025-09-25 FALSE        2025-09-25T23:00:00Z
#>  4 2025010053 20252026         1 2025-09-27 FALSE        2025-09-27T23:00:00Z
#>  5 2025010079 20252026         1 2025-10-02 FALSE        2025-10-02T23:00:00Z
#>  6 2025010100 20252026         1 2025-10-04 FALSE        2025-10-04T23:00:00Z
#>  7 2025020004 20252026         2 2025-10-08 FALSE        2025-10-08T23:00:00Z
#>  8 2025020025 20252026         2 2025-10-11 FALSE        2025-10-11T23:00:00Z
#>  9 2025020043 20252026         2 2025-10-13 FALSE        2025-10-13T18:00:00Z
#> 10 2025020049 20252026         2 2025-10-14 FALSE        2025-10-14T23:00:00Z
#> # ℹ 78 more rows
#> # ℹ 63 more variables: eastern_utc_offset <chr>, venue_utc_offset <chr>,
#> #   venue_timezone <chr>, game_state <chr>, game_schedule_state <chr>,
#> #   tv_broadcasts <list>, three_min_recap <chr>, game_center_link <chr>,
#> #   three_min_recap_fr <chr>, condensed_game_fr <chr>, condensed_game <chr>,
#> #   venue_default <chr>, venue_fr <chr>, venue_es <chr>, away_team_id <int>,
#> #   away_team_abbrev <chr>, away_team_logo <chr>, away_team_dark_logo <chr>, …
# }