Skip to contents

Get ESPN NBA Calendar

Get ESPN NBA Calendar

Usage

espn_nba_calendar(season = most_recent_nba_season())

Arguments

season

integer or character. Four-digit season year (e.g. 2025). Defaults to most_recent_nba_season().

Value

Returns a tibble of calendar entries.

col_nametypesdescription
seasoncharacterSeason identifier (4-digit year or 'YYYY-YY' string).
season_typecharacterSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
season_type_labelcharacter
season_start_datecharacterDate in YYYY-MM-DD format.
season_end_datecharacterDate in YYYY-MM-DD format.
labelcharacter
alternate_labelcharacter
detailcharacter
valuecharacterNumeric or string value field.
start_datecharacterStart date (YYYY-MM-DD).
end_datecharacterEnd date (YYYY-MM-DD).

Details

Retrieve the ESPN NBA schedule calendar for a given season. The underlying scoreboard response contains a leagues[[1]]$calendar block with season-type entries (pre-season, regular, post). Uses getOption("hoopR.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

See also

Other ESPN NBA Functions: espn_nba_athlete_awards(), espn_nba_athlete_career_stats(), espn_nba_athlete_contract(), espn_nba_athlete_contracts(), espn_nba_athlete_eventlog(), espn_nba_athlete_eventlog_v2(), espn_nba_athlete_gamelog(), espn_nba_athlete_info(), espn_nba_athlete_overview(), espn_nba_athlete_seasons(), espn_nba_athlete_splits(), espn_nba_athlete_statisticslog(), espn_nba_athlete_stats(), espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_coach(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_event_broadcasts(), espn_nba_event_odds(), espn_nba_event_officials(), espn_nba_event_powerindex(), espn_nba_event_predictor(), espn_nba_event_probabilities(), espn_nba_event_propbets(), espn_nba_event_situation(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_rosters(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_box(), espn_nba_player_stats(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Author

Saiem Gilani

Examples

# \donttest{
  espn_nba_calendar(season = 2025)
#> ── ESPN NBA Calendar from ESPN.com ────────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-19 01:33:45 UTC
#> # A tibble: 230 × 12
#>    season season_type season_type_label season_start_date season_end_date  
#>    <chr>  <chr>       <chr>             <chr>             <chr>            
#>  1 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#>  2 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#>  3 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#>  4 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#>  5 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#>  6 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#>  7 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#>  8 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#>  9 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#> 10 2025   NA          NA                2024-09-24T07:00Z 2025-06-27T06:59Z
#> # ℹ 220 more rows
#> # ℹ 7 more variables: calendar_type <chr>, label <chr>, alternate_label <chr>,
#> #   detail <chr>, value <chr>, start_date <chr>, end_date <chr>
# }