nba_schedule: *Get NBA Stats API Season Schedule*

In hoopR: Access Men's Basketball Play by Play Data

Get NBA Stats API Season Schedule

Description

Deprecated in hoopR 3.0.0. This endpoint is unstable/empty; use nba_scoreboardv3() instead.

Restored in hoopR 3.1.0 – a residential-IP live re-probe (2026-08-24) confirmed this endpoint still serves real rows for NBA. For real-time scores, prefer nba_todays_scoreboard() instead (see #129).

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_playbyplayv3() instead.

Usage

nba_schedule(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

nba_scoreboard(league_id = "00", game_date = "2021-07-20", day_offset = 0, ...)

nba_scoreboardv2(
  league_id = "00",
  game_date = "2021-07-20",
  day_offset = 0,
  ...
)

nba_scoreboardv3(league_id = "00", game_date = "2023-03-26", ...)

nba_todays_scoreboard(...)

nba_winprobabilitypbp(game_id = "0021700807", run_type = "each second", ...)

nba_scheduleleaguev2int(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

Arguments

league_id	League - default: '00'. Other options include '10': WNBA, '20': G-League
season	Season
...	Additional arguments passed to an underlying function like httr.
game_date	Game Date
day_offset	Day Offset (integer 0,-1)
game_id	Game ID
run_type	Run Type

Details

 nba_schedule(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))
 nba_schedule(league_id = '20', season = year_to_season(most_recent_nba_season() - 1))

 nba_scoreboard(league_id = '00', game_date = '2021-07-20')

 nba_scoreboardv2(league_id = '00', game_date = '2021-07-20')

 nba_scoreboardv3(league_id = '00', game_date = '2023-03-26')

 nba_todays_scoreboard()

 nba_winprobabilitypbp(game_id = '0021700807', run_type = 'each second')

 nba_scheduleleaguev2int(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a tibble with the following columns:

col_name	types	description
game_date	character	Game date (YYYY-MM-DD).
game_id	character	Unique game identifier.
game_code	character	ESPN game code (numeric identifier).
game_status	integer	Game status label.
game_status_text	character	Game status display text (e.g. 'Final', '4:32 - 4th').
game_sequence	integer	Game sequence.
game_date_est	character	Game date est.
game_time_est	character	Game time est.
game_date_time_est	character	Game date time est.
game_date_utc	character	Game date utc.
game_time_utc	character	Game start time in UTC (ISO 8601 timestamp).
game_date_time_utc	character	Game date time utc.
away_team_time	character	Time / clock value.
home_team_time	character	Time / clock value.
day	character	Day number within the month.
month_num	integer	Month num.
week_number	integer	Week number.
week_name	character	Week name.
if_necessary	character	If necessary.
series_game_number	character	Series game number.
series_text	character	Series text.
arena_name	character	Arena name.
arena_state	character	Arena state.
arena_city	character	Arena city.
postponed_status	character	Postponed status.
branch_link	character	Branch link.
game_subtype	character	Game subtype.
home_team_id	integer	Unique identifier for the home team.
home_team_name	character	Home team name.
home_team_city	character	Home team city / location.
home_team_tricode	character	Home team three-letter code.
home_team_slug	character	Home team's team slug.
home_team_wins	integer	Home team's team wins.
home_team_losses	integer	Home team's team losses.
home_team_score	integer	Home team's score.
home_team_seed	integer	Home team's team seed.
away_team_id	integer	Unique identifier for the away team.
away_team_name	character	Away team name.
away_team_city	character	Away team city / location.
away_team_tricode	character	Away team three-letter code.
away_team_slug	character	Away team's team slug.
away_team_wins	integer	Away team's team wins.
away_team_losses	integer	Away team's team losses.
away_team_score	integer	Away team's score.
away_team_seed	integer	Away team's team seed.
season	character	Season identifier (4-digit year or 'YYYY-YY' string).
league_id	character	League identifier ('10' = WNBA).

Return a named list of data frames: Available, EastConfStandingsByDay, GameHeader, LastMeeting, LineScore, SeriesStandings, WestConfStandingsByDay

GameHeader

Columns as documented in the shared nba_boxscoresummaryv2_gamesummary_schema table.

LineScore

col_name	types	description
GAME_DATE_EST	character	Game date est.
GAME_SEQUENCE	character	Game sequence.
GAME_ID	character	Unique game identifier.
TEAM_ID	character	Unique team identifier.
TEAM_ABBREVIATION	character	Short team abbreviation (e.g. 'LAS').
TEAM_CITY_NAME	character
TEAM_WINS_LOSSES	character
PTS_QTR1	character
PTS_QTR2	character
PTS_QTR3	character
PTS_QTR4	character
PTS_OT1	character
PTS_OT2	character
PTS_OT3	character
PTS_OT4	character
PTS_OT5	character
PTS_OT6	character
PTS_OT7	character
PTS_OT8	character
PTS_OT9	character
PTS_OT10	character
PTS	character	Points scored.
FG_PCT	character	Field goal percentage (0-1).
FT_PCT	character	Free throw percentage (0-1).
FG3_PCT	character	Three-point field goal percentage (0-1).
AST	character	Assists.
REB	character	Total rebounds.
TOV	character	Turnovers.

SeriesStandings

Columns as documented in the shared nba_boxscoresummaryv2_seasonseries_schema table.

LastMeeting

Columns as documented in the shared nba_boxscoresummaryv2_lastmeeting_schema table.

EastConfStandingsByDay

Columns as documented in the shared nba_scoreboard_eastconfstandingsbyday_schema table.

WestConfStandingsByDay

Columns as documented in the shared nba_scoreboard_eastconfstandingsbyday_schema table.

Available

col_name	types	description
GAME_ID	character	Unique game identifier.
PT_AVAILABLE	character	Pt available.

Return a named list of data frames: Available, EastConfStandingsByDay, GameHeader, LastMeeting, LineScore, SeriesStandings, TeamLeaders, TicketLinks, WestConfStandingsByDay, WinProbability

GameHeader

col_name	types	description
GAME_DATE_EST	character	Game date est.
GAME_SEQUENCE	character	Game sequence.
GAME_ID	character	Unique game identifier.
GAME_STATUS_ID	character	Numeric game status identifier.
GAME_STATUS_TEXT	character	Game status display text (e.g. 'Final', '4:32 - 4th').
GAMECODE	character
HOME_TEAM_ID	character	Unique identifier for the home team.
VISITOR_TEAM_ID	character
SEASON	character	Season identifier (4-digit year or 'YYYY-YY' string).
LIVE_PERIOD	character
LIVE_PC_TIME	character
NATL_TV_BROADCASTER_ABBREVIATION	character
HOME_TV_BROADCASTER_ABBREVIATION	character
AWAY_TV_BROADCASTER_ABBREVIATION	character
LIVE_PERIOD_TIME_BCAST	character
ARENA_NAME	character	Arena name.
WH_STATUS	character	Wh status.
WNBA_COMMISSIONER_FLAG	character

LineScore

col_name	types	description
GAME_DATE_EST	character	Game date est.
GAME_SEQUENCE	character	Game sequence.
GAME_ID	character	Unique game identifier.
TEAM_ID	character	Unique team identifier.
TEAM_ABBREVIATION	character	Short team abbreviation (e.g. 'LAS').
TEAM_CITY_NAME	character
TEAM_NAME	character	Full team display name (e.g. 'Las Vegas Aces').
TEAM_WINS_LOSSES	character
PTS_QTR1	character
PTS_QTR2	character
PTS_QTR3	character
PTS_QTR4	character
PTS_OT1	character
PTS_OT2	character
PTS_OT3	character
PTS_OT4	character
PTS_OT5	character
PTS_OT6	character
PTS_OT7	character
PTS_OT8	character
PTS_OT9	character
PTS_OT10	character
PTS	character	Points scored.
FG_PCT	character	Field goal percentage (0-1).
FT_PCT	character	Free throw percentage (0-1).
FG3_PCT	character	Three-point field goal percentage (0-1).
AST	character	Assists.
REB	character	Total rebounds.
TOV	character	Turnovers.

SeriesStandings

Columns as documented in the shared nba_boxscoresummaryv2_seasonseries_schema table.

LastMeeting

Columns as documented in the shared nba_boxscoresummaryv2_lastmeeting_schema table.

EastConfStandingsByDay

Columns as documented in the shared nba_scoreboard_eastconfstandingsbyday_schema table.

WestConfStandingsByDay

Columns as documented in the shared nba_scoreboard_eastconfstandingsbyday_schema table.

Available

col_name	types	description
GAME_ID	character	Unique game identifier.
PT_AVAILABLE	character	Pt available.

TeamLeaders

col_name	types	description
GAME_ID	character	Unique game identifier.
TEAM_ID	character	Unique team identifier.
TEAM_CITY	character	Team city or region (e.g. 'Las Vegas').
TEAM_NICKNAME	character	Team nickname.
TEAM_ABBREVIATION	character	Short team abbreviation (e.g. 'LAS').
PTS_PLAYER_ID	character
PTS_PLAYER_NAME	character
PTS	character	Points scored.
REB_PLAYER_ID	character
REB_PLAYER_NAME	character
REB	character	Total rebounds.
AST_PLAYER_ID	character
AST_PLAYER_NAME	character
AST	character	Assists.

TicketLinks

WinProbability

Return a tibble with the following scoreboard data:

col_name	types	description
game_id	character	Unique game identifier.
game_code	character	ESPN game code (numeric identifier).
game_status	integer	Game status label.
game_status_text	character	Game status display text (e.g. 'Final', '4:32 - 4th').
game_date	character	Game date (YYYY-MM-DD).
game_time_utc	character	Game start time in UTC (ISO 8601 timestamp).
game_et	character	Game et.
home_team_id	integer	Unique identifier for the home team.
home_team_name	character	Home team name.
home_team_city	character	Home team city / location.
home_team_tricode	character	Home team three-letter code.
home_team_slug	character	Home team's team slug.
away_team_id	integer	Unique identifier for the away team.
away_team_name	character	Away team name.
away_team_city	character	Away team city / location.
away_team_tricode	character	Away team three-letter code.
away_team_slug	character	Away team's team slug.
period	integer	Period of the game (1-4 quarters; 5+ for OT).
game_clock	character	Game clock.
regulation_periods	integer	Regulation periods.
series_game_number	character	Series game number.
series_text	character	Series text.
if_necessary	logical	If necessary.
series_conference	character	Series conference.
po_round_desc	character	Po round desc.
game_subtype	character	Game subtype.
game_home_leaders_person_id	integer	Unique identifier for game home leaders person.
game_home_leaders_name	character	Game home leaders name.
game_home_leaders_player_slug	character	Game home leaders player slug.
game_home_leaders_jersey_num	character	Game home leaders jersey num.
game_home_leaders_position	character	Game home leaders position.
game_home_leaders_team_tricode	character	Game home leaders team tricode.
game_home_leaders_points	integer	Game home leaders points.
game_home_leaders_rebounds	integer	Game home leaders rebounds.
game_home_leaders_assists	integer	Game home leaders assists.
game_away_leaders_person_id	integer	Unique identifier for game away leaders person.
game_away_leaders_name	character	Game away leaders name.
game_away_leaders_player_slug	character	Game away leaders player slug.
game_away_leaders_jersey_num	character	Game away leaders jersey num.
game_away_leaders_position	character	Game away leaders position.
game_away_leaders_team_tricode	character	Game away leaders team tricode.
game_away_leaders_points	integer	Game away leaders points.
game_away_leaders_rebounds	integer	Game away leaders rebounds.
game_away_leaders_assists	integer	Game away leaders assists.
team_home_leaders_person_id	integer	Unique identifier for team home leaders person.
team_home_leaders_name	character	Team home leaders name.
team_home_leaders_player_slug	character	Team home leaders player slug.
team_home_leaders_jersey_num	character	Team home leaders jersey num.
team_home_leaders_position	character	Team home leaders position.
team_home_leaders_team_tricode	character	Team home leaders team tricode.
team_home_leaders_points	numeric	Team home leaders points.
team_home_leaders_rebounds	numeric	Team home leaders rebounds.
team_home_leaders_assists	numeric	Team home leaders assists.
team_away_leaders_person_id	integer	Unique identifier for team away leaders person.
team_away_leaders_name	character	Team away leaders name.
team_away_leaders_player_slug	character	Team away leaders player slug.
team_away_leaders_jersey_num	character	Team away leaders jersey num.
team_away_leaders_position	character	Team away leaders position.
team_away_leaders_team_tricode	character	Team away leaders team tricode.
team_away_leaders_points	numeric	Team away leaders points.
team_away_leaders_rebounds	numeric	Team away leaders rebounds.
team_away_leaders_assists	numeric	Team away leaders assists.
team_season_leaders_flag	integer	Team season leaders flag.
home_wins	integer	Home team's wins.
home_losses	integer	Home team's losses.
home_score	integer	Home team score at the time of the play.
home_seed	integer	Home team's seed.
home_in_bonus	logical	Home team's in bonus.
home_timeouts_remaining	integer	Home team's timeouts remaining.
home_periods	list	Home team's periods.
away_wins	integer	Away team's wins.
away_losses	integer	Away team's losses.
away_score	integer	Away team score at the time of the play.
away_seed	integer	Away team's seed.
away_in_bonus	logical	Away team's in bonus.
away_timeouts_remaining	integer	Away team's timeouts remaining.
away_periods	list	Away team's periods.
league_id	character	League identifier ('10' = WNBA).
league	character	League.
broadcasters	data.frame

Return a data frame with the following columns:

col_name	types	description
game_id	character	Unique game identifier.
game_code	character	ESPN game code (numeric identifier).
game_status	integer	Game status label.
game_status_text	character	Game status display text (e.g. 'Final', '4:32 - 4th').
period	integer	Period of the game (1-4 quarters; 5+ for OT).
game_clock	character	Game clock.
game_time_utc	character	Game start time in UTC (ISO 8601 timestamp).
game_et	character	Game et.
regulation_periods	integer	Regulation periods.
if_necessary	logical	If necessary.
series_game_number	character	Series game number.
series_text	character	Series text.
series_conference	character	Series conference.
po_round_desc	character	Po round desc.
game_subtype	character	Game subtype.
home_team_id	integer	Unique identifier for the home team.
home_team_name	character	Home team name.
home_team_city	character	Home team city / location.
home_team_tricode	character	Home team three-letter code.
home_wins	integer	Home team's wins.
home_losses	integer	Home team's losses.
home_score	integer	Home team score at the time of the play.
home_seed	logical	Home team's seed.
home_in_bonus	character	Home team's in bonus.
home_timeouts_remaining	integer	Home team's timeouts remaining.
home_periods	list	Home team's periods.
away_team_id	integer	Unique identifier for the away team.
away_team_name	character	Away team name.
away_team_city	character	Away team city / location.
away_team_tricode	character	Away team three-letter code.
away_wins	integer	Away team's wins.
away_losses	integer	Away team's losses.
away_score	integer	Away team score at the time of the play.
away_seed	logical	Away team's seed.
away_in_bonus	character	Away team's in bonus.
away_timeouts_remaining	integer	Away team's timeouts remaining.
away_periods	list	Away team's periods.
home_leaders_person_id	integer	Unique identifier for home leaders person.
home_leaders_name	character	Home leaders name.
home_leaders_jersey_num	character	Home team's leaders jersey num.
home_leaders_position	character	Home team's leaders position.
home_leaders_team_tricode	character	Home team's leaders team tricode.
home_leaders_player_slug	character	Home team's leaders player slug.
home_leaders_points	integer	Home team's leaders points.
home_leaders_rebounds	integer	Home team's leaders rebounds.
home_leaders_assists	integer	Home team's leaders assists.
away_leaders_person_id	integer	Unique identifier for away leaders person.
away_leaders_name	character	Away leaders name.
away_leaders_jersey_num	character	Away team's leaders jersey num.
away_leaders_position	character	Away team's leaders position.
away_leaders_team_tricode	character	Away team's leaders team tricode.
away_leaders_player_slug	character	Away team's leaders player slug.
away_leaders_points	integer	Away team's leaders points.
away_leaders_rebounds	integer	Away team's leaders rebounds.
away_leaders_assists	integer	Away team's leaders assists.
pb_odds_team	logical	Pb odds team.
pb_odds_odds	numeric	Pb odds odds.
pb_odds_suspended	integer	Pb odds suspended.

Return a named list of data frames: WinProbPBP, GameInfo

WinProbPBP

col_name	types	description
GAME_ID	character	Unique game identifier.
EVENT_NUM	character	Sequential event number within the game (V2 PBP).
HOME_PCT	character
VISITOR_PCT	character
HOME_PTS	character
VISITOR_PTS	character
HOME_SCORE_MARGIN	character
PERIOD	character	Period of the game (1-4 quarters; 5+ for OT).
SECONDS_REMAINING	character	Seconds remaining in the period.
HOME_POSS_IND	character
HOME_G	character
DESCRIPTION	character	Long-form description text.
LOCATION	character	Location.
PCTIMESTRING	character
ISVISIBLE	character

GameInfo

col_name	types	description
GAME_ID	character	Unique game identifier.
GAME_DATE	character	Game date (YYYY-MM-DD).
HOME_TEAM_ID	character	Unique identifier for the home team.
HOME_TEAM_ABR	character
HOME_TEAM_PTS	character
VISITOR_TEAM_ID	character
VISITOR_TEAM_ABR	character
VISITOR_TEAM_PTS	character

Returns a named list of data frames: SeasonGames, SeasonWeeks, BroadcasterList

SeasonGames

col_name	types	description
game_date	character	Game date (YYYY-MM-DD).
game_id	character	Unique game identifier.
game_code	character	ESPN game code (numeric identifier).
game_status	character	Game status label.
game_status_text	character	Game status display text (e.g. 'Final', '4:32 - 4th').
game_sequence	character	Game sequence.
home_team_id	character	Unique identifier for the home team.
home_team_name	character	Home team name.
home_team_city	character	Home team city / location.
home_team_tricode	character	Home team three-letter code.
home_team_slug	character	Home team's team slug.
home_team_wins	character	Home team's team wins.
home_team_losses	character	Home team's team losses.
home_team_score	character	Home team's score.
away_team_id	character	Unique identifier for the away team.
away_team_name	character	Away team name.
away_team_city	character	Away team city / location.
away_team_tricode	character	Away team three-letter code.
away_team_slug	character	Away team's team slug.
away_team_wins	character	Away team's team wins.
away_team_losses	character	Away team's team losses.
away_team_score	character	Away team's score.
season	character	Season identifier (4-digit year or 'YYYY-YY' string).
league_id	character	League identifier ('10' = WNBA).

SeasonWeeks

col_name	types	description
league_id	character	League identifier ('10' = WNBA).
season_year	character	Season year string ('YYYY-YY' format).
week_number	character	Week number.
week_name	character	Week name.
start_date	character	Start date (YYYY-MM-DD).
end_date	character	End date (YYYY-MM-DD).

BroadcasterList

col_name	types	description
league_id	character	League identifier ('10' = WNBA).
season_year	character	Season year string ('YYYY-YY' format).
broadcaster_abbreviation	character	Broadcaster abbreviation.
broadcaster_display	character	Broadcaster display.
broadcaster_id	character	Unique identifier for broadcaster.
region_id	character	Unique identifier for region.

Author(s)

Saiem Gilani

See Also

Other NBA Live Functions: nba_playbyplayv3()

Other NBA PBP Functions: nba_data_pbp(), nba_playbyplayv3()

hoopR documentation built on Aug. 25, 2026, 9:07 a.m.