NBA dataset loaders — Other

load_nba_pbp

Release: espn_nba_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_pbp/play_by_play_{season}.parquet

Returns

col_name	type	description
game_play_number	Int32	Sequential play number within the game.
id	Int64	Id.
sequence_number	Int32	Sequence number representing a shot-possession (V3 PBP).
type_id	Int32	Type identifier (numeric).
type_text	String	Display text for the type field.
text	String	Text description of the play / record.
away_score	Int32	Away team score at the time of the play.
home_score	Int32	Home team score at the time of the play.
period_number	Int32	Numeric period (1-4 for quarters; 5+ for OT).
period_display_value	String	Period display label (e.g. '1st Quarter', 'OT').
clock_display_value	String	Game clock display string (e.g. '8:32').
scoring_play	Boolean	TRUE if the play resulted in points scored.
score_value	Int32	Point value of the play (2 / 3 / 1).
team_id	Int32	Unique team identifier.
athlete_id_1	Int32	Primary athlete identifier (e.g. shooter).
athlete_id_2	Int32	Secondary athlete identifier (e.g. assister / fouler).
athlete_id_3	Int32	Athlete id 3.
wallclock	String	Wallclock.
shooting_play	Boolean	TRUE if the play was a shooting attempt.
coordinate_x_raw	Float64	X coordinate as returned by the API before any adjustment.
coordinate_y_raw	Float64	Y coordinate as returned by the API before any adjustment.
points_attempted	Int32	Point value attempted on the shot (2 or 3; 1 for a free throw).
short_description	String	Short text description of the play from ESPN.
game_id	Int32	Unique game identifier.
season	Int32	Season year.
season_type	Int32	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
home_team_id	Int32	Unique identifier for the home team.
home_team_name	String	Home team name.
home_team_mascot	String	Home team mascot.
home_team_abbrev	String	Home team three-letter abbreviation.
home_team_name_alt	String	Alternate home team name.
away_team_id	Int32	Unique identifier for the away team.
away_team_name	String	Away team name.
away_team_mascot	String	Away team mascot.
away_team_abbrev	String	Away team three-letter abbreviation.
away_team_name_alt	String	Alternate away team name.
game_spread	Float64	Game spread (signed; positive = home favored).
home_favorite	Boolean	TRUE if the home team is the betting favorite.
game_spread_available	Boolean	TRUE if a point spread was available.
home_team_spread	Float64	Home team's point spread.
qtr	Int32	Quarter (1-4) or OT period (5+).
time	String	Time / clock value.
clock_minutes	Int32	Clock minutes split out for convenience.
clock_seconds	Float64	Clock seconds split out for convenience.
home_timeout_called	Boolean	Whether the play is a timeout called by the home team.
away_timeout_called	Boolean	Whether the play is a timeout called by the away team.
half	Int32	Half of the game (1 or 2).
game_half	Int32	Half of the game (1 or 2).
lag_qtr	Int32	Quarter lag (the previous-play's quarter).
lead_qtr	Int32	Quarter lead (the next-play's quarter).
lag_half	Int32	A lag column on the half
lead_half	Int32	A lead column on the half
start_quarter_seconds_remaining	Float64	Seconds remaining in the period at the start of the play.
start_half_seconds_remaining	Float64	Seconds remaining in the half at the start of the play.
start_game_seconds_remaining	Float64	Seconds remaining in the game at the start of the play.
end_quarter_seconds_remaining	Float64	Seconds remaining in the period at the end of the play.
end_half_seconds_remaining	Float64	Seconds remaining in the half at the end of the play.
end_game_seconds_remaining	Float64	Seconds remaining in the game at the end of the play.
period	Int32	Period of the game (1-4 quarters; 5+ for OT).
coordinate_x	Float64	X coordinate on the court (half-court layout).
coordinate_y	Float64	Y coordinate on the court (half-court layout).
game_date	Date	Game date (YYYY-MM-DD).
game_date_time	Datetime(time_unit='us', time_zone='America/New_York')	Game start date/time (ISO 8601).
athlete_name_1	String	Name of the primary athlete involved in the play (pairs with athlete_id_1).
athlete_name_2	String	Name of the secondary athlete involved in the play (e.g. the assister or fouled player).
athlete_name_3	String	Name of the tertiary athlete involved in the play.
type_abbreviation	String	Type abbreviation.

load_nba_pbp(seasons=2024)

load_nba_schedule

Release: espn_nba_schedules · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_schedules/nba_schedule_{season}.parquet

Returns

col_name	type	description
id	Int32	Id.
uid	String	ESPN UID string.
date	String	Date in YYYY-MM-DD format.
attendance	Float64	Reported attendance.
time_valid	Boolean	Time valid.
neutral_site	Boolean	Neutral site.
conference_competition	Boolean	Conference competition.
play_by_play_available	Boolean
recent	Boolean	Recent.
start_date	String	Start date (YYYY-MM-DD).
broadcast	String	Broadcast information string.
highlights	String
notes_type	String	Notes type.
notes_headline	String	Notes headline.
broadcast_market	String	Broadcast market label (e.g. 'national', 'home').
broadcast_name	String	Broadcast name.
type_id	Int32	Type identifier (numeric).
type_abbreviation	String	Type abbreviation.
venue_id	Int32	Unique venue identifier.
venue_full_name	String	Venue full name.
venue_address_city	String	Venue address city.
venue_indoor	Boolean	TRUE if the venue is indoors.
status_clock	Float64	Status clock.
status_display_clock	String	Status display clock.
status_period	Float64	Status period.
status_type_id	Int32	Unique identifier for status type.
status_type_name	String	Status type name.
status_type_state	String	Status type state.
status_type_completed	Boolean	Status type completed.
status_type_description	String	Status type description.
status_type_detail	String	Status type detail.
status_type_short_detail	String	Status type short detail.
format_regulation_periods	Float64	Format regulation periods.
home_id	Int32	Unique identifier for home.
home_uid	String	Home team's uid.
home_location	String	Home team's location.
home_name	String	Home name.
home_abbreviation	String	Home team's abbreviation.
home_display_name	String	Home display name.
home_short_display_name	String	Home short display name.
home_color	String	Color code (hex) for home.
home_alternate_color	String	Color code (hex) for home alternate.
home_is_active	Boolean	Home team's is active.
home_venue_id	Int32	Unique identifier for home venue.
home_logo	String	Home team logo URL.
home_score	Int32	Home team score at the time of the play.
home_winner	Boolean	Home team's winner.
home_linescores	String	Period-by-period points for the home team, stringified from ESPN's linescores array.
home_records	String	Home team's records at game time (overall, home, away), stringified from ESPN.
away_id	Int32	Unique identifier for away.
away_uid	String	Away team's uid.
away_location	String	Away team's location.
away_name	String	Away name.
away_abbreviation	String	Away team's abbreviation.
away_display_name	String	Away display name.
away_short_display_name	String	Away short display name.
away_color	String	Color code (hex) for away.
away_alternate_color	String	Color code (hex) for away alternate.
away_is_active	Boolean	Away team's is active.
away_venue_id	Int32	Unique identifier for away venue.
away_logo	String	Away team logo URL.
away_score	Int32	Away team score at the time of the play.
away_winner	Boolean	Away team's winner.
away_linescores	String	Period-by-period points for the away team, stringified from ESPN's linescores array.
away_records	String	Away team's records at game time (overall, home, away), stringified from ESPN.
game_id	Int32	Unique game identifier.
season	Int32	Season year.
season_type	Int32	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
venue_address_state	String	Venue address state / region.
status_type_alt_detail	String	Status type alt detail.
game_json	Boolean
game_json_url	String
game_date_time	Datetime(time_unit='us', time_zone='America/New_York')	Game start date/time (ISO 8601).
game_date	Date	Game date (YYYY-MM-DD).
PBP	Boolean
team_box	Boolean	Team box.
player_box	Boolean	Player box.

load_nba_schedule(seasons=2024)

load_nba_team_boxscore

Release: espn_nba_team_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_team_boxscores/team_box_{season}.parquet

Returns

col_name	type	description
game_id	Int32	Unique game identifier.
season	Int32	Season year.
season_type	Int32	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date	Date	Game date (YYYY-MM-DD).
game_date_time	Datetime(time_unit='us', time_zone='America/New_York')	Game start date/time (ISO 8601).
team_id	Int32	Unique team identifier.
team_uid	String	ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location	String	Team city or location string.
team_name	String	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
team_short_display_name	String	Short team display name (e.g. 'Aces').
team_color	String	Team primary color (hex without leading '#').
team_alternate_color	String	Team alternate color (hex without leading '#').
team_logo	String	Team logo image URL.
team_home_away	String	Team home away.
team_score	Int32	Team's score / final score.
team_winner	Boolean	TRUE if the team won this game.
assists	Int32	Total assists.
blocks	Int32	Total blocks.
defensive_rebounds	Int32	Defensive rebounds.
fast_break_points	String	Fast-break points scored.
field_goal_pct	Float64	Field goal percentage (0-1).
field_goals_made	Int32	Field goals made (2-pt + 3-pt).
field_goals_attempted	Int32	Field goal attempts (2-pt + 3-pt).
flagrant_fouls	Int32	Total flagrant fouls.
fouls	Int32	Personal fouls.
free_throw_pct	Float64	Free throw percentage (0-1).
free_throws_made	Int32	Free throws made.
free_throws_attempted	Int32	Free throw attempts.
largest_lead	String	Largest lead during the game.
offensive_rebounds	Int32	Offensive rebounds.
points_in_paint	String	Points scored in the paint.
steals	Int32	Total steals.
team_turnovers	Int32	Team turnovers (turnovers credited to the team rather than a player).
technical_fouls	Int32	Total technical fouls.
three_point_field_goal_pct	Float64	Three-point field goal percentage (0-1).
three_point_field_goals_made	Int32	Three-point field goals made.
three_point_field_goals_attempted	Int32	Three-point field goal attempts.
total_rebounds	Int32	Total rebounds.
total_technical_fouls	Int32	Total technical fouls (player + team).
total_turnovers	Int32	Total turnovers (player + team).
turnover_points	String	Turnover points.
turnovers	Int32	Total turnovers.
opponent_team_id	Int32	Unique identifier for the opponent team.
opponent_team_uid	String	Opponent team uid.
opponent_team_slug	String	Opponent team slug.
opponent_team_location	String	Opponent team city / location.
opponent_team_name	String	Opponent team display name.
opponent_team_abbreviation	String	Opponent team abbreviation.
opponent_team_display_name	String	Opponent team full display name.
opponent_team_short_display_name	String	Opponent team short display name.
opponent_team_color	String	Opponent team primary color (hex).
opponent_team_alternate_color	String	Opponent team alternate color (hex).
opponent_team_logo	String	Opponent team logo URL.
opponent_team_score	Int32	Opponent team's score.
lead_changes	String	Lead changes.
lead_percentage	String	Percentage of the game the team held the lead, from ESPN's team box score stats.

load_nba_team_boxscore(seasons=2024)

load_nba_game_rosters

Release: espn_nba_game_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_game_rosters/game_rosters_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
game_id	String	Unique game identifier.
team_id	Int32	Unique team identifier.
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
home_away	String	Game venue label ('home' or 'away').
athlete_id	Int32	Unique athlete identifier (ESPN).
athlete_uid	String	ESPN athlete UID (universal identifier).
athlete_guid	String	ESPN athlete GUID.
athlete_display_name	String	Athlete display name (full).
athlete_short_name	String	Athlete short display name.
athlete_first_name	String
athlete_last_name	String
athlete_jersey	String	Athlete jersey number.
athlete_position	String	Athlete position.
athlete_headshot	String	URL of the player's headshot image.
starter	Boolean	TRUE if the player was in the starting lineup; FALSE otherwise.
did_not_play	Boolean	TRUE if the player did not appear in the game.
active	Boolean	TRUE if the row represents an active record (player / team / season).
ejected	Boolean	TRUE if the player was ejected from the game.
reason	String	Reason.

load_nba_game_rosters(seasons=2002)

load_nba_officials

Release: espn_nba_officials · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_officials/officials_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
game_id	Int32	Unique game identifier.
official_full_name	String	Full name of an on-court game official as ESPN publishes it in the summary gameInfo.officials array; it is identical to official_display_name in every released NBA row.
official_display_name	String	ESPN's display-form name for the official, falling back to the full name when ESPN omits it; it never diverges from official_full_name in the released NBA data.
official_position	String	ESPN's label for the official's assignment slot; the NBA summary feed only ever ships Referee, so this reads the same on every released row.
official_position_id	Int32	ESPN's numeric identifier for the official's assignment slot, constant at 40 (Referee) across every released NBA season.
official_order	Int32	The official's listing index within the game's crew as ESPN orders them, normally 1 through 3 for a three-person crew; a fourth entry appears in a small share of recent-season games and the sequence is not guaranteed to be gap-free.

load_nba_officials(seasons=2002)

load_nba_shots

Release: espn_nba_shots · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_shots/shots_{season}.parquet

Returns

col_name	type	description
game_id	Int32	Unique game identifier.
season	Int32	Season year.
period_number	Int32	Numeric period (1-4 for quarters; 5+ for OT).
clock_display_value	String	Game clock display string (e.g. '8:32').
team_id	Int32	Unique team identifier.
athlete_id_1	Int32	Primary athlete identifier (e.g. shooter).
athlete_id_2	Int32	Secondary athlete identifier (e.g. assister / fouler).
type_id	Int32	Type identifier (numeric).
type_text	String	Display text for the type field.
scoring_play	Boolean	TRUE if the play resulted in points scored.
score_value	Int32	Point value of the play (2 / 3 / 1).
coordinate_x	Float64	X coordinate on the court (half-court layout).
coordinate_y	Float64	Y coordinate on the court (half-court layout).
coordinate_x_raw	Float64	X coordinate as returned by the API before any adjustment.
coordinate_y_raw	Float64	Y coordinate as returned by the API before any adjustment.
athlete_name_1	String	Name of the shooter on the attempt.
athlete_name_2	String	Name of the secondary athlete on the attempt (e.g. the assister).
team_name	String	Full team display name (e.g. 'Las Vegas Aces').
team_mascot	String	Mascot (nickname) portion of the shooting team's name.
team_abbrev	String	Abbreviation for team.

load_nba_shots(seasons=2002)

load_nba_standings

Release: espn_nba_standings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_standings/standings_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
group_id	String	ESPN group id.
group_name	String
group_abbreviation	String
group_short_name	String	ESPN's short name for the standings grouping the team sits in, read from the group node's shortName; the NBA standings payload supplies only the group name and abbreviation, so this is null throughout.
team_id	Int32	Unique team identifier.
team_uid	String	ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location	String	Team city or location string.
team_name	String	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
team_short_display_name	String	Short team display name (e.g. 'Aces').
team_color	String	Team primary color (hex without leading '#').
team_alternate_color	String	Team alternate color (hex without leading '#').
team_logo	String	Team logo image URL.
stat_name	String	Stat key.
stat_display_name	String	Stat display name.
stat_short_display_name	String
stat_description	String	ESPN's prose gloss for the standings statistic on this row; for the clincher stat it is not a fixed label but the team's actual status text, such as Clinched Playoff Berth or Eliminated From Playoff.
stat_abbreviation	String	ESPN's short code for the standings statistic, such as PCT, GB or OPP PPG; it is null for the four record-style splits (Home, Road, vs. Conf., vs. Div.), which ship no abbreviation.
stat_type	String	Stat type code (e.g. "win", "loss").
display_value	String	Display-formatted value.
value	Float64	Numeric or string value field.

load_nba_standings(seasons=2002)

load_nba_team_season_stats

Release: espn_nba_team_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_team_season_stats/team_season_stats_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
team_id	Int32	Unique team identifier.
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
team_short_display_name	String	Short team display name (e.g. 'Aces').
team_color	String	Team primary color (hex without leading '#').
team_alternate_color	String	Team alternate color (hex without leading '#').
team_logo	String	Team logo image URL.
category	String	Category label.
stat_label	String
stat_name	String	Stat key.
stat_display_name	String	Stat display name.
stat_description	String	ESPN's prose definition of the team statistic on this row, for example the average number of assists a team records per turnover.
display_value	String	Display-formatted value.
value	Float64	Numeric or string value field.

load_nba_team_season_stats(seasons=2025)

load_nba_draft

Release: espn_nba_draft · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_draft/draft_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
round	Int32	Tournament / playoff round.
round_display_name	String	ESPN's display label for the draft round a pick belongs to, read from the round object's displayName; the NBA payload supplies no round metadata, so this is null for every released season 2003 through 2025.
pick	Int32	Pick number within the round.
overall_pick	Int32	Overall pick.
pick_traded	String	ESPN's traded flag for the pick, carried through as a string rather than a boolean; every released NBA row reads FALSE, so it does not currently identify traded picks.
pick_notes	String	Free-text note ESPN can attach to a pick, read from the pick's notes or note field; the NBA draft payload never populates it, so it is null across all released seasons.
athlete_id	Int32	Unique athlete identifier (ESPN).
athlete_uid	String	ESPN athlete UID (universal identifier).
athlete_guid	String	ESPN athlete GUID.
athlete_first_name	String
athlete_last_name	String
athlete_full_name	String
athlete_display_name	String	Athlete display name (full).
athlete_short_name	String	Athlete short display name.
athlete_height	String
athlete_weight	String
athlete_position_abbreviation	String	Athlete position abbreviation (G / F / C).
athlete_position_name	String	Athlete position ('Guard', 'Forward', 'Center').
athlete_headshot_href	String	Athlete headshot image URL.
college_id	Int32	Unique identifier for college.
college_name	String	College / pre-draft team.
college_short_name	String
college_abbreviation	String	Abbreviation of the drafted player's college taken from the pick's nested college block; the ESPN NBA draft feed omits that block entirely, so this and the other college columns are null throughout.
team_id	Int32	Unique team identifier.
team_uid	String	ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location	String	Team city or location string.
team_name	String	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
team_short_display_name	String	Short team display name (e.g. 'Aces').
team_color	String	Team primary color (hex without leading '#').
team_alternate_color	String	Team alternate color (hex without leading '#').
team_logo	String	Team logo image URL.

load_nba_draft(seasons=2025)

load_nba_rosters

Release: espn_nba_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_nba_rosters/rosters_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
team_id	Int32	Unique team identifier.
team_slug	String	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviation	String	Short team abbreviation (e.g. 'LAS').
team_display_name	String	Full team display name.
team_short_display_name	String	Short team display name (e.g. 'Aces').
team_color	String	Team primary color (hex without leading '#').
team_alternate_color	String	Team alternate color (hex without leading '#').
team_logo	String	Team logo image URL.
athlete_id	String	Unique athlete identifier (ESPN).
uid	String	ESPN UID string.
guid	String	Stable cross-league team GUID.
full_name	String	Player's full name.
display_name	String	Display name.
short_name	String	Short display name.
first_name	String	Player's first name.
last_name	String	Player's last name.
jersey	String	Jersey number worn by the player.
position_abbreviation	String	Position abbreviation ('G' / 'F' / 'C').
position_name	String	Listed roster position ('Guard', 'Forward', 'Center').
position_id	String	Unique position identifier.
height	String	Player height (string e.g. '6-2' or inches).
weight	String	Player weight in pounds.
age	String	Player age (in years).
date_of_birth	String	Date of birth (YYYY-MM-DD).
birth_place_city	String	Birth place city.
birth_place_state	String	Birth place state.
birth_place_country	String	Birth place country.
experience_years	String	Experience years.
experience_display_value	String	Experience display value.
headshot_href	String	Headshot image URL.
headshot_alt	String	Alternative-text label for the headshot.
link_web	String	Web link / URL.
status_id	String	Status identifier.
status_name	String	Status label.
status_type	String	Status type.

load_nba_rosters(seasons=2025)

load_nba_schedule_crosswalk

Release: nba_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_crosswalk/nba_schedule_crosswalk_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
season_type	String	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date	Date	Game date (YYYY-MM-DD).
home_espn_team_id	Int32	ESPN home team id (NA for bart-only rows).
away_espn_team_id	Int32	ESPN away team id (NA for bart-only rows).
espn_game_id	String	ESPN game id (NA for bart-only rows).
nba_game_id	String	NBA Stats 10-character game id matched to the ESPN game in the crosswalk.
nba_game_code	String	NBA game code (date and matchup string) from the NBA Stats API.
nba_home_team_id	String	NBA Stats team id of the home team.
nba_away_team_id	String	NBA Stats team id of the away team.
fox_game_id	String	Fox game id (NA placeholder).
fox_home_team_id	String	FOX Sports team id of the home team in the crosswalk.
fox_away_team_id	String	FOX Sports team id of the away team in the crosswalk.
yahoo_game_id	String	Yahoo game id (NA placeholder).
match_method	String	Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidence	Float64	Jaro-Winkler score or 1 for exact (NA if none).

load_nba_schedule_crosswalk(seasons=2026)

load_nba_team_crosswalk

Release: nba_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_crosswalk/nba_team_crosswalk_{season}.parquet

Returns

col_name	type	description
season	Int32	Season year.
espn_team_id	Int32	ESPN team id (canonical key).
espn_abbreviation	String	ESPN abbreviation.
espn_display_name	String	ESPN display name (school + mascot).
espn_short_name	String	ESPN short name.
espn_location	String	ESPN school/location only.
espn_mascot	String	ESPN mascot/nickname.
nba_team_id	String	NBA Stats team id side of the ESPN-to-NBA team crosswalk.
nba_team_abbreviation	String	Team abbreviation as listed by the NBA Stats API.
nba_team_name	String	Full NBA team name from the NBA Stats API, city followed by nickname (e.g. 'Boston Celtics').
nba_team_city	String	Team city as listed by the NBA Stats API.
nba_team_slug	String	URL-friendly slug for the team's name on NBA Stats.
nba_conference	String	Team's conference as listed by the NBA Stats API.
nba_division	String	Team's division as listed by the NBA Stats API.
fox_team_id	String	Fox Bifrost team id (NA if unmatched).
fox_team_name	String	Fox team name (NA if unmatched).
yahoo_team_id	String	Yahoo team id (NA placeholder).
yahoo_team_abbreviation	String	Yahoo abbreviation (NA placeholder).
yahoo_team_name	String	Yahoo team name (NA placeholder).
match_method	String	Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidence	Float64	Jaro-Winkler score or 1 for exact (NA if none).

load_nba_team_crosswalk(seasons=2026)

load_nba_groups

Release: nba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_groups/nba_groups.parquet

Coverage

One season-less file: one row per group lineage (the league, subdivisions, conferences, divisions) with the first and last season it had members. group_id is SDV's own id (e.g. nba:atlantic) and names a lineage: a rename that keeps continuity keeps the id, a new body gets a new one, and notes records each call. Seasons are the ENDING year (2025 = the 2024-25 season).

Returns

col_name	type	description
league	String	League code of the table ("nba"); the prefix of every group_id in it.
group_id	String	SDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
level	String	Hierarchy level of the group: "league", "subdivision", "conference" or "division".
first_season	Int32	First season in which the group had at least one member (ENDING year: 2025 = the 2024-25 season).
last_season	Int32	Last season in which the group had at least one member (ENDING year: 2025 = the 2024-25 season).
notes	String	Builder notes on the group: the lineage decisions behind its group_id and any source caveats.

load_nba_groups()

load_nba_group_seasons

Release: nba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_groups/nba_group_seasons.parquet

Coverage

One season-less file: one row per group per season it existed, with its name, short name, abbreviation and parent group AS OF that season (never today's label applied to the past) and its member count. season is the ENDING year (2025 = the 2024-25 season).

Returns

col_name	type	description
league	String	League code of the table ("nba"); the prefix of every group_id in it.
group_id	String	SDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
season	Int32	Season the row describes (ENDING year: 2025 = the 2024-25 season).
level	String	Hierarchy level of the group: "league", "subdivision", "conference" or "division".
name	String	Full name of the group as of that season -- the label in use then, not today's name.
short_name	String	Short display name of the group as of that season.
abbreviation	String	Abbreviation of the group as of that season.
parent_group_id	String	group_id one level up as of that season (division -> conference -> subdivision -> league); null at the top level or where no higher group applied that season.
n_teams	Int32	Number of member teams in the group that season.

load_nba_group_seasons()

load_nba_group_aliases

Release: nba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_groups/nba_group_aliases.parquet

Coverage

One season-less file: every name, abbreviation, slug and source id that a source (espn, nba_stats, sdv) uses for a group, each with the seasons it is valid for (valid_from / valid_to, inclusive; null = unbounded). Match a source's conference or division label here to reach group_id.

Returns

col_name	type	description
league	String	League code of the table ("nba"); the prefix of every group_id in it.
group_id	String	SDV group id, {league}:{slug}. It names a lineage: renames that keep continuity keep the id, and a new body (a new conference, or a merger the sources treat as new) gets a new one.
source	String	Source that uses this label or id (in this table: espn, nba_stats, sdv); "sdv" marks SDV's own labels.
source_id	String	The source's own id for the group (ESPN group id, NCAA conf_id, CFBD id, MLB division id) when it has one; null otherwise.
name_kind	String	Kind of label in value: "name", "short_name", "abbreviation", "slug" or "code".
value	String	The label exactly as the source writes it; match a source's conference or division label against it to reach group_id.
valid_from	Int32	First season the alias is valid for, inclusive (ENDING year: 2025 = the 2024-25 season); null = unbounded.
valid_to	Int32	Last season the alias is valid for, inclusive (ENDING year: 2025 = the 2024-25 season); null = unbounded (still in use).

load_nba_group_aliases()

load_nba_team_group_seasons

Release: nba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/nba_groups/nba_team_group_seasons_{season}.parquet

Coverage

One row per team per season: the SDV subdivision, conference and division group ids the team belonged to that season (null where a level does not apply), the team name as of that season, where the membership came from, and whether a second source agreed (null when only one source covers the season). team_id is a string: the ESPN team id; team_id_source names the id space. season is the ENDING year (2025 = the 2024-25 season); seasons 1971-2027.

Returns

col_name	type	description
league	String	League code of the table ("nba"); the prefix of every group_id in it.
season	Int32	Season of the membership (ENDING year: 2025 = the 2024-25 season).
team_id	String	Team id as a string: the ESPN team id where ESPN covers the team, otherwise the league's own id; team_id_source says which.
team_id_source	String	Id space of team_id (in this table: espn).
team_name	String	Team name as of that season, not today's.
subdivision_id	String	SDV group_id of the team's subdivision that season (e.g. FBS / FCS, Division I); null where the league has no subdivision level.
conference_id	String	SDV group_id of the team's conference that season; null where the team had no conference (an independent, or a season played without conferences).
division_id	String	SDV group_id of the team's division that season; null where the level does not apply.
source	String	Source the membership was taken from -- the most reliable per-season source for that era.
sources_agree	Boolean	Whether a second source agreed on the membership; null when only one source covers the season.
notes	String	Builder notes on the team-season, such as a source disagreement or which of several listed memberships was kept.

load_nba_team_group_seasons(seasons=2024)