Skip to main content
Breaking in 4.0.0
  • Integer id columns are decimal strings — Every id column of integers (id, *_id, game_pk, playerId, …) comes back as exact decimal strings on every surface — parsers, producers, loaders, HockeyTech analytics. Compare and join ids as strings; Number(row.game_id) for a safe number back. (changelog)
  • Typed wrapper params and loader rows; strict mode — TypeScript only. A param the endpoint does not have, a missing required path param or a non-boolean bool param is a type error; parser rows are Record<string, unknown>; loader rows are their generated row types. (changelog)

sdv.wnba — dataset loaders

34 loaders reading the published sportsdataverse-data releases (parquet) — the JS mirror of sportsdataverse-py's load_* functions. Each is a camelCase export plus its snake_case alias and resolves to an array of plain row objects (or { [column]: values[] } with format: "columns").

  • Size: row objects cost ~60-100 bytes per cell on the heap, so before decoding each season a loader adds its rows × columns (from the parquet footer) to a running total and checks it against maxCells — by default heap limit / 100 for rows (≈45M cells on Node's default 4 GB heap) and heap limit / 30 for format: "columns" — and throws a catchable SdvError instead of running out of memory. Play-by-play is the usual case: pass columns, use format: "columns", or raise the heap (node --max-old-space-size=8192).
  • Seasons: seasons takes one season or a list. A season with no published asset (HTTP 404) is skipped with a warning (loaders marked so in their seasons row — sdv-py's hand-written ones — throw NoDataError instead); any other failure raises AssetFetchError (a failed download is never an empty season); a season below the loader's floor raises SeasonNotFoundError before anything is fetched. Multi-season results union the columns, null-filling gaps, and cast a column whose type changed between seasons to the common type (an integer id that became a string → strings, "123" not "123.0"), as sdv-py's diagonal_relaxed concat does.
  • Integers: an id column (id, *_id, *_ids, game_pk, athlete_id_1, id_play, playerId, homeTeamId, start.team.id, …) of integers comes back as exact decimal strings in every row and every season, whatever width the release stores it with (INT32, INT64, or a DOUBLE holding integers: "401628579101849903", "39", never "39.0"), so ids join across seasons and across releases. Code-like id columns (type_id, status_id, …) are strings too. An id column that is not exact integers (a fraction, a DOUBLE past 2^53) is left as read with one warning. Any other INT64 column comes back as number when every value is a safe integer, otherwise as BigInt with one warning (code SDV_INT64) per column per process.
  • Runtime: Node only. Downloads go through the releases transport family (see Transport, auth & errors); each asset is downloaded whole, then decoded.
LoaderReleaseSeasons
loadWnbaPbpespn_wnba_pbp2002+
loadWnbaPlayerBoxscoreespn_wnba_player_boxscores2002+
loadWnbaScheduleespn_wnba_schedules2002+
loadWnbaTeamBoxscoreespn_wnba_team_boxscores2002+
loadWnbaDraftespn_wnba_draft2026+
loadWnbaGameRostersespn_wnba_game_rosters2024+
loadWnbaOfficialsespn_wnba_officials2024+
loadWnbaPlayerSeasonStatsespn_wnba_player_season_stats2024+
loadWnbaRostersespn_wnba_rosters2024+
loadWnbaShotsespn_wnba_shots2024+
loadWnbaStandingsespn_wnba_standings2024+
loadWnbaTeamSeasonStatsespn_wnba_team_season_stats2024+
loadWnbaPlayerCrosswalkwnba_crosswalk2026+
loadWnbaScheduleCrosswalkwnba_crosswalk2026+
loadWnbaTeamCrosswalkwnba_crosswalk2026+
loadWnbaPlayerCoreespn_wnba_player_core2003+
loadWnbaPlayerImpactwnba_player_impact1997+
loadWnbaStatsCoacheswnba_stats_coaches2026+
loadWnbaStatsDraftwnba_stats_draft2025+
loadWnbaStatsGameRosterswnba_stats_game_rosters2026+
loadWnbaStatsOfficialswnba_stats_officials2026+
loadWnbaStatsPbpwnba_stats_pbp1997+
loadWnbaStatsPossessionswnba_stats_possessions1997+
loadWnbaStatsGameLineupswnba_stats_game_lineups1997+
loadWnbaStatsPlayerBoxscoreswnba_stats_player_boxscores2026+
loadWnbaStatsPlayerGameLogswnba_stats_player_game_logs2025+
loadWnbaStatsRosterswnba_stats_rosters2026+
loadWnbaStatsScheduleswnba_stats_schedules1997+
loadWnbaStatsShotswnba_stats_shots2026+
loadWnbaStatsTeamBoxscoreswnba_stats_team_boxscores2026+
loadWnbaGroupswnba_groupsone asset
loadWnbaGroupSeasonswnba_groupsone asset
loadWnbaGroupAliaseswnba_groupsone asset
loadWnbaTeamGroupSeasonswnba_groups1997+

loadWnbaPbp​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaPbp({ seasons: 2024, columns: ['game_id', 'sequence_number', 'type_text', 'text', 'score_value'] });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_pbp(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaPbpRow (exported from the package root).

col_nametypedescription
game_play_numbernumberGame play number
idstringUnique play identification number
sequence_numbernumberSequence number representing a shot-possession (V3 PBP).
type_idstringType identifier (numeric).
type_textstringPlay type text, passed through verbatim from ESPN. ESPN labels the free-throw play type "MadeFreeThrow" for made AND missed free throws; filter makes vs. misses with scoring_play, not type_text.
textstringText description of the play / record.
away_scorenumberAway team score at the time of the play.
home_scorenumberHome team score at the time of the play.
period_numbernumberNumeric period (1-4 for quarters; 5+ for OT).
period_display_valuestringPeriod display label (e.g. '1st Quarter', 'OT').
clock_display_valuestringGame clock display string (e.g. '8:32').
scoring_playbooleanTRUE if the play resulted in points scored.
score_valuenumberPoint value of the attempt (1 / 2 / 3), carried even on misses (a missed free throw still shows 1); use scoring_play to identify points actually scored.
team_idstringUnique team identifier.
athlete_id_1stringPrimary athlete identifier (e.g. shooter).
athlete_id_2stringSecondary athlete identifier (e.g. assister / fouler).
athlete_id_3stringAthlete id 3.
wallclockstringWallclock.
shooting_playbooleanTRUE if the play was a shooting attempt.
coordinate_x_rawnumberX coordinate as returned by the API before any adjustment.
coordinate_y_rawnumberY coordinate as returned by the API before any adjustment.
points_attemptednumberPoint value at stake on the play's shot attempt (1, 2, or 3); 0 for non-shooting plays.
short_descriptionstringAbbreviated ESPN text description of the play.
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typenumberSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
home_team_idstringUnique identifier for the home team.
home_team_namestringHome team name.
home_team_mascotstringHome team mascot.
home_team_abbrevstringHome team three-letter abbreviation.
home_team_name_altstringAlternate versions of the home team abbreviation
away_team_idstringUnique identifier for the away team.
away_team_namestringAway team name.
away_team_mascotstringAway team mascot.
away_team_abbrevstringAway team three-letter abbreviation.
away_team_name_altstringAlternate versions of the away team abbreviation
game_spreadnumberGame spread in (-X Team) format. There are almost none, I would recommend not trusting any of these three columns
home_favoritebooleanLogical (TRUE/FALSE) indicating whether the home team is favored
game_spread_availablebooleanLogical (TRUE/FALSE) indicating whether the spread was available from ESPN. Basically, I would just not recommend using any of the spread information, I think I defaulted a lot of them to -2.5 for the home team. Most games probably do not have spread information. This column should really be listed first
home_team_spreadnumberThe game spread with respect to the home team
qtrnumberQuarter of the game
timestringTime left within the period
clock_minutesnumberClock minutes split from seconds for developer convenience
clock_secondsnumberClock seconds split from minutes for developer convenience
home_timeout_calledbooleanTrue when the play is a timeout charged to the home team.
away_timeout_calledbooleanTrue when the play is a timeout charged to the away team.
halfnumberHalf of the game
game_halfnumberHalf of the game
lag_qtrnumberA lag column on the quarter
lead_qtrnumberA lead column on the quarter
lag_halfnumberA lag column on the half
lead_halfnumberA lead column on the half
start_quarter_seconds_remainingnumberQuarter seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)
start_half_seconds_remainingnumberGame half seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)
start_game_seconds_remainingnumberGame seconds remaining at the start of the play (''')
end_quarter_seconds_remainingnumberQuarter seconds remaining at the end of the play (''')
end_half_seconds_remainingnumberGame half seconds remaining at the end of the play (''')
end_game_seconds_remainingnumberGame seconds remaining at the end of the play (''')
periodnumberPeriod of the game (1-4 quarters; 5+ for OT).
coordinate_xnumberX coordinate on the court (half-court layout).
coordinate_ynumberY coordinate on the court (half-court layout).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDateGame start date/time (ISO 8601).
athlete_name_1stringDisplay name of the primary athlete on the play (e.g. the shooter, rebounder, or fouler), per ESPN participant order.
athlete_name_2stringDisplay name of the secondary athlete on the play (e.g. the assister or fouled player), when present.
athlete_name_3stringDisplay name of the third athlete listed on the play, when present.
type_abbreviationstringPlay type abbreviation

loadWnbaPlayerBoxscore​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaPlayerBoxscore({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_player_boxscore(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaPlayerBoxscoreRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typenumberSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDateGame start date/time (ISO 8601).
athlete_idstringUnique athlete identifier (ESPN).
athlete_display_namestringAthlete display name (full).
team_idstringUnique team identifier.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_locationstringTeam city or location string.
team_short_display_namestringShort team display name (e.g. 'Aces').
minutesnumberMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madenumberField goals made (2-pt + 3-pt).
field_goals_attemptednumberField goal attempts (2-pt + 3-pt).
three_point_field_goals_madenumberThree-point field goals made.
three_point_field_goals_attemptednumberThree-point field goal attempts.
free_throws_madenumberFree throws made.
free_throws_attemptednumberFree throw attempts.
offensive_reboundsnumberOffensive rebounds.
defensive_reboundsnumberDefensive rebounds.
reboundsnumberTotal rebounds.
assistsnumberTotal assists.
stealsnumberTotal steals.
blocksnumberTotal blocks.
turnoversnumberTotal turnovers.
foulsnumberPersonal fouls.
plus_minusstringPlus/minus point differential while on court.
pointsnumberPoints scored.
starterbooleanTRUE if the player was in the starting lineup; FALSE otherwise.
ejectedbooleanTRUE if the player was ejected from the game.
did_not_playbooleanTRUE if the player did not appear in the game.
reasonstringReason.
activebooleanTRUE if the row represents an active record (player / team / season).
athlete_jerseystringAthlete jersey number.
athlete_short_namestringAthlete short display name.
athlete_headshot_hrefstringAthlete headshot image URL.
athlete_position_namestringAthlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviationstringAthlete position abbreviation (G / F / C).
team_display_namestringFull team display name.
team_uidstringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logostringTeam logo image URL.
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
home_awaystringGame venue label ('home' or 'away').
team_winnerbooleanTRUE if the team won this game.
team_scorenumberTeam's score / final score.
opponent_team_idstringUnique identifier for the opponent team.
opponent_team_namestringOpponent team display name.
opponent_team_locationstringOpponent team city / location.
opponent_team_display_namestringOpponent team full display name.
opponent_team_abbreviationstringOpponent team abbreviation.
opponent_team_logostringOpponent team logo URL.
opponent_team_colorstringOpponent team primary color (hex).
opponent_team_alternate_colorstringOpponent team alternate color (hex).
opponent_team_scorenumberOpponent team's score.

loadWnbaSchedule​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaSchedule({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_schedule(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaScheduleRow (exported from the package root).

col_nametypedescription
idstringUnique play identification number
uidstringESPN UID string.
datestringDate in YYYY-MM-DD format.
attendancenumberReported attendance.
time_validbooleanTime valid.
neutral_sitebooleanNeutral site.
conference_competitionbooleanConference competition.
play_by_play_availableboolean
recentbooleanRecent.
start_datestringStart date (YYYY-MM-DD).
broadcaststringBroadcast information string.
highlightsstring
notes_typestringNotes type.
notes_headlinestringNotes headline.
broadcast_marketstringBroadcast market label (e.g. 'national', 'home').
broadcast_namestringBroadcast name.
type_idstringType identifier (numeric).
type_abbreviationstringPlay type abbreviation
venue_idstringUnique venue identifier.
venue_full_namestringVenue full name.
venue_address_citystringVenue address city.
venue_address_statestringVenue address state / region.
venue_indoorbooleanTRUE if the venue is indoors.
status_clocknumberStatus clock.
status_display_clockstringStatus display clock.
status_periodnumberStatus period.
status_type_idstringUnique identifier for status type.
status_type_namestringStatus type name.
status_type_statestringStatus type state.
status_type_completedbooleanStatus type completed.
status_type_descriptionstringStatus type description.
status_type_detailstringStatus type detail.
status_type_short_detailstringStatus type short detail.
format_regulation_periodsnumberFormat regulation periods.
home_idstringUnique identifier for home.
home_uidstringHome team's uid.
home_locationstringHome team's location.
home_namestringHome name.
home_abbreviationstringHome team's abbreviation.
home_display_namestringHome display name.
home_short_display_namestringHome short display name.
home_colorstringColor code (hex) for home.
home_alternate_colorstringColor code (hex) for home alternate.
home_is_activebooleanHome team's is active.
home_venue_idstringUnique identifier for home venue.
home_logostringHome team logo URL.
home_scorenumberHome team score at the time of the play.
home_winnerbooleanHome team's winner.
home_linescoresstringStringified list of the home team's period-by-period scores from the ESPN schedule feed.
home_recordsstringStringified list of the home team's record summaries (overall/home/away) from the ESPN schedule feed.
away_idstringUnique identifier for away.
away_uidstringAway team's uid.
away_locationstringAway team's location.
away_namestringAway name.
away_abbreviationstringAway team's abbreviation.
away_display_namestringAway display name.
away_short_display_namestringAway short display name.
away_colorstringColor code (hex) for away.
away_alternate_colorstringColor code (hex) for away alternate.
away_is_activebooleanAway team's is active.
away_venue_idstringUnique identifier for away venue.
away_logostringAway team logo URL.
away_scorenumberAway team score at the time of the play.
away_winnerbooleanAway team's winner.
away_linescoresstringStringified list of the away team's period-by-period scores from the ESPN schedule feed.
away_recordsstringStringified list of the away team's record summaries (overall/home/away) from the ESPN schedule feed.
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typenumberSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
status_type_alt_detailstringStatus type alt detail.
game_jsonboolean
game_json_urlstring
game_date_timeDateGame start date/time (ISO 8601).
game_dateDateGame date (YYYY-MM-DD).
PBPboolean
team_boxbooleanTeam box.
player_boxbooleanPlayer box.

loadWnbaTeamBoxscore​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2002)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaTeamBoxscore({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_team_boxscore(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaTeamBoxscoreRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typenumberSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
game_date_timeDateGame start date/time (ISO 8601).
team_idstringUnique team identifier.
team_uidstringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationstringTeam city or location string.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.
team_home_awaystringTeam home away.
team_scorenumberTeam's score / final score.
team_winnerbooleanTRUE if the team won this game.
assistsnumberTotal assists.
blocksnumberTotal blocks.
defensive_reboundsnumberDefensive rebounds.
fast_break_pointsstringFast-break points scored.
field_goal_pctnumberField goal percentage (0-1).
field_goals_madenumberField goals made (2-pt + 3-pt).
field_goals_attemptednumberField goal attempts (2-pt + 3-pt).
flagrant_foulsnumberTotal flagrant fouls.
foulsnumberPersonal fouls.
free_throw_pctnumberFree throw percentage (0-1).
free_throws_madenumberFree throws made.
free_throws_attemptednumberFree throw attempts.
largest_leadstringLargest lead during the game.
lead_changesstringLead changes.
lead_percentagestringShare of game time the team spent in the lead, as reported by ESPN.
offensive_reboundsnumberOffensive rebounds.
points_in_paintstringPoints scored in the paint.
stealsnumberTotal steals.
team_turnoversnumberTeam turnovers (turnovers credited to the team rather than a player).
technical_foulsnumberTotal technical fouls.
three_point_field_goal_pctnumberThree-point field goal percentage (0-1).
three_point_field_goals_madenumberThree-point field goals made.
three_point_field_goals_attemptednumberThree-point field goal attempts.
total_reboundsnumberTotal rebounds.
total_technical_foulsnumberTotal technical fouls (player + team).
total_turnoversnumberTotal turnovers (player + team).
turnover_pointsstringTurnover points.
turnoversnumberTotal turnovers.
opponent_team_idstringUnique identifier for the opponent team.
opponent_team_uidstringOpponent team uid.
opponent_team_slugstringOpponent team slug.
opponent_team_locationstringOpponent team city / location.
opponent_team_namestringOpponent team display name.
opponent_team_abbreviationstringOpponent team abbreviation.
opponent_team_display_namestringOpponent team full display name.
opponent_team_short_display_namestringOpponent team short display name.
opponent_team_colorstringOpponent team primary color (hex).
opponent_team_alternate_colorstringOpponent team alternate color (hex).
opponent_team_logostringOpponent team logo URL.
opponent_team_scorenumberOpponent team's score.

loadWnbaDraft​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaDraft({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_draft(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaDraftRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
roundnumberTournament / playoff round.
round_display_namestringHuman-readable label for the draft round, read from the ESPN round object's displayName falling back to its name; null whenever ESPN ships the modern flat picks array with no round objects, which is the case for every published season.
picknumberPick.
overall_picknumberOverall pick.
pick_tradedstringESPN's pick-level traded flag stringified as TRUE or FALSE, marking selections made with a pick that had changed hands (17 of the 45 published 2026 picks are TRUE).
pick_notesstringFree-text annotation ESPN attaches to a pick, taken from notes and falling back to note; empty for every pick published so far.
athlete_idstringUnique athlete identifier (ESPN).
athlete_uidstringESPN athlete UID (universal identifier).
athlete_guidstringESPN athlete GUID.
athlete_first_namestring
athlete_last_namestring
athlete_full_namestring
athlete_display_namestringAthlete display name (full).
athlete_short_namestringAthlete short display name.
athlete_heightstring
athlete_weightstring
athlete_position_abbreviationstringAthlete position abbreviation (G / F / C).
athlete_position_namestringAthlete position ('Guard', 'Forward', 'Center').
athlete_headshot_hrefstringAthlete headshot image URL.
college_idstringUnique identifier for college.
college_namestringCollege name.
college_short_namestring
college_abbreviationstringShort code for the drafted player's school, read from the athlete's ESPN college block; null throughout the published data because ESPN ships no college block on these picks.
team_idstringUnique team identifier.
team_uidstringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationstringTeam city or location string.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.

loadWnbaGameRosters​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2024)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaGameRosters({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_game_rosters(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaGameRostersRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
game_idstringUnique game identifier.
team_idstringUnique team identifier.
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
home_awaystringGame venue label ('home' or 'away').
athlete_idstringUnique athlete identifier (ESPN).
athlete_uidstringESPN athlete UID (universal identifier).
athlete_guidstringESPN athlete GUID.
athlete_display_namestringAthlete display name (full).
athlete_short_namestringAthlete short display name.
athlete_first_namestring
athlete_last_namestring
athlete_jerseystringAthlete jersey number.
athlete_positionstringAthlete position.
athlete_headshotstringDirect link to the player's ESPN headshot image, always of the form https://a.espncdn.com/i/headshots/wnba/players/full/\{athlete_id\}.png, and null for the few players ESPN has no photo for.
starterbooleanTRUE if the player was in the starting lineup; FALSE otherwise.
did_not_playbooleanTRUE if the player did not appear in the game.
activebooleanTRUE if the row represents an active record (player / team / season).
ejectedbooleanTRUE if the player was ejected from the game.
reasonstringReason.

loadWnbaOfficials​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2024)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaOfficials({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_officials(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaOfficialsRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
game_idstringUnique game identifier.
official_idstringUnique official / referee identifier.
official_uidstringESPN's global uid string for the official, carried straight through from the officials payload; the Core v2 items ESPN serves omit it, so it is null in every published season.
official_full_namestringThe official's full name, taken from ESPN fullName and falling back to displayName; it equals first plus last name on every published row.
official_display_namestringESPN's display rendering of the official's name, which is byte-identical to official_full_name on every published row and therefore adds nothing.
official_first_namestringGiven name of the official as ESPN splits it out, the leading token of official_full_name.
official_last_namestringFamily name of the official as ESPN splits it out, the trailing token of official_full_name, with hyphenated surnames kept intact.
official_ordernumberESPN's 1-based position of the official within that game's crew; most games run 1 through 3 for a three-person crew and 40 of 573 games in 2024-2025 add a fourth.
position_namestringListed roster position ('Guard', 'Forward', 'Center').
position_display_namestringPosition display name.

loadWnbaPlayerSeasonStats​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2024)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaPlayerSeasonStats({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_player_season_stats(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaPlayerSeasonStatsRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
athlete_idstringUnique athlete identifier (ESPN).
athlete_display_namestringAthlete display name (full).
athlete_first_namestring
athlete_last_namestring
athlete_position_abbreviationstringAthlete position abbreviation (G / F / C).
athlete_jerseystringAthlete jersey number.
team_idstringUnique team identifier.
team_display_namestringFull team display name.
categorystringCategory label.
stat_labelstring
stat_namestringInternal stat key.
stat_display_namestringStat display name.
stat_descriptionstringESPN's prose definition of the statistic on this row, for example The average number of points scored per game for avgPoints; combined made-attempted stats carry both halves joined by a hyphen.
display_valuestringDisplay-formatted value.
valuenumberNumeric or string value field.

loadWnbaRosters​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2024)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaRosters({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_rosters(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaRostersRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idstringUnique team identifier.
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.
athlete_idstringUnique athlete identifier (ESPN).
uidstringESPN UID string.
guidstringStable cross-league team GUID.
full_namestringPlayer's full name.
display_namestringDisplay name.
short_namestringShort display name.
first_namestringPlayer's first name.
last_namestringPlayer's last name.
jerseystringJersey number worn by the player.
position_abbreviationstringPosition abbreviation ('G' / 'F' / 'C').
position_namestringListed roster position ('Guard', 'Forward', 'Center').
position_idstringUnique position identifier.
heightstringPlayer height (string e.g. '6-2' or inches).
weightstringPlayer weight in pounds.
agestringPlayer age (in years).
date_of_birthstringDate of birth (YYYY-MM-DD).
birth_place_citystringBirth place city.
birth_place_statestringBirth place state.
birth_place_countrystringBirth place country.
experience_yearsstringExperience years.
experience_display_valuestringExperience display value.
headshot_hrefstringHeadshot image URL.
headshot_altstringAlternative-text label for the headshot.
link_webstringWeb link / URL.
status_idstringStatus identifier.
status_namestringStatus label.
status_typestringStatus type.

loadWnbaShots​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2024)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaShots({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_shots(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaShotsRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
period_numbernumberNumeric period (1-4 for quarters; 5+ for OT).
clock_display_valuestringGame clock display string (e.g. '8:32').
team_idstringUnique team identifier.
athlete_id_1stringPrimary athlete identifier (e.g. shooter).
athlete_id_2stringSecondary athlete identifier (e.g. assister / fouler).
type_idstringType identifier (numeric).
type_textstringDisplay text for the type field.
scoring_playbooleanTRUE if the play resulted in points scored.
score_valuenumberPoint value of the play (2 / 3 / 1).
coordinate_xnumberX coordinate on the court (half-court layout).
coordinate_ynumberY coordinate on the court (half-court layout).
coordinate_x_rawnumberX coordinate as returned by the API before any adjustment.
coordinate_y_rawnumberY coordinate as returned by the API before any adjustment.
athlete_name_1stringDisplay name of the shooter, per ESPN participant order.
athlete_name_2stringDisplay name of the secondary athlete on the shot (typically the assister), when present.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_mascotstringESPN mascot (nickname) of the shooting team.
team_abbrevstringAbbreviation for team.

loadWnbaStandings​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2024)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStandings({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_standings(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStandingsRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
group_idstringESPN group id.
group_namestring
group_abbreviationstring
group_short_namestringShort label of the standings group node the team sits under, read from ESPN shortName; the WNBA conference nodes ship only name and abbreviation, so it is null on every published row.
team_idstringUnique team identifier.
team_uidstringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationstringTeam city or location string.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.
stat_namestringInternal stat key.
stat_display_namestringStat display name.
stat_short_display_namestring
stat_descriptionstringESPN's long-form explanation of the standings stat, such as Clinched Best League Record for clincher or Record last 10 games for lasttengames.
stat_abbreviationstringESPN's abbreviation for the standings stat, which can differ from stat_short_display_name (playoffSeed is SEED here but POS there) and is null on the record-split rows such as Home and vs. Conf.
stat_typestringStat type code (e.g. "win", "loss").
display_valuestringDisplay-formatted value.
valuenumberNumeric or string value field.

loadWnbaTeamSeasonStats​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2024)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaTeamSeasonStats({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_team_season_stats(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaTeamSeasonStatsRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idstringUnique team identifier.
team_slugstringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_display_namestringFull team display name.
team_short_display_namestringShort team display name (e.g. 'Aces').
team_colorstringTeam primary color (hex without leading '#').
team_alternate_colorstringTeam alternate color (hex without leading '#').
team_logostringTeam logo image URL.
categorystringCategory label.
stat_labelstring
stat_namestringInternal stat key.
stat_display_namestringStat display name.
stat_descriptionstringHuman-readable description of the statistic the row reports.
display_valuestringDisplay-formatted value.
valuenumberNumeric or string value field.

loadWnbaPlayerCrosswalk​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaPlayerCrosswalk({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_player_crosswalk(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaPlayerCrosswalkRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
espn_team_idstringESPN team id (canonical key).
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
player_namestringPlayer name.
espn_athlete_idstringESPN athlete id.
espn_full_namestringESPN full name.
espn_jerseystringESPN jersey number.
espn_positionstringESPN position abbreviation.
wnba_player_idstringPlayer identifier on stats.wnba.com matched to the ESPN player.
wnba_player_namestringPlayer display name on the stats.wnba.com side of the crosswalk.
wnba_jersey_numstringJersey number listed on the stats.wnba.com side of the crosswalk.
wnba_positionstringPosition listed on the stats.wnba.com side of the crosswalk.
fox_athlete_idstringFox athlete id (NA if unmatched).
fox_playerstringFox player name (NA if unmatched).
fox_jerseystringFox jersey number (NA if unmatched).
fox_position_groupstringFox position group label (NA if unmatched).
yahoo_player_idstringYahoo player id (NA placeholder).
yahoo_player_namestringYahoo player name (NA placeholder).
match_methodstringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidencenumberJaro-Winkler score or 1 for exact (NA if none).
match_keysstringNA (reserved for future use).

loadWnbaScheduleCrosswalk​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaScheduleCrosswalk({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_schedule_crosswalk(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaScheduleCrosswalkRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typestringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
home_espn_team_idstringESPN home team id (NA for bart-only rows).
away_espn_team_idstringESPN away team id (NA for bart-only rows).
espn_game_idstringESPN game id (NA for bart-only rows).
wnba_game_idstringGame identifier on stats.wnba.com matched to the ESPN game.
wnba_game_codestringstats.wnba.com game code (date/matchup slug) for the matched game.
wnba_home_team_idstringHome team identifier on stats.wnba.com for the matched game.
wnba_away_team_idstringAway team identifier on stats.wnba.com for the matched game.
fox_game_idstringFox game id (NA placeholder).
fox_home_team_idstringHome team identifier on Fox Sports for the matched game.
fox_away_team_idstringAway team identifier on Fox Sports for the matched game.
yahoo_game_idstringYahoo game id (NA placeholder).
match_methodstringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidencenumberJaro-Winkler score or 1 for exact (NA if none).

loadWnbaTeamCrosswalk​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaTeamCrosswalk({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_team_crosswalk(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaTeamCrosswalkRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
espn_team_idstringESPN team id (canonical key).
espn_abbreviationstringESPN abbreviation.
espn_display_namestringESPN display name (school + mascot).
espn_short_namestringESPN short name.
espn_locationstringESPN school/location only.
espn_mascotstringESPN team mascot/nickname.
wnba_team_idstringWNBA Stats team id.
wnba_team_tricodestringWNBA Stats tricode.
wnba_team_namestringWNBA Stats team name.
wnba_team_citystringWNBA Stats team city.
wnba_team_slugstringWNBA Stats team slug.
fox_team_idstringFox Bifrost team id (NA if unmatched).
fox_team_namestringFox team name (NA if unmatched).
yahoo_team_idstringYahoo team id (NA placeholder).
yahoo_team_abbreviationstringYahoo abbreviation (NA placeholder).
yahoo_team_namestringYahoo team name (NA placeholder).
match_methodstringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidencenumberJaro-Winkler score or 1 for exact (NA if none).

loadWnbaPlayerCore​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2003)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaPlayerCore({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_player_core(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaPlayerCoreRow (exported from the package root).

col_nametypedescription
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
athlete_idstringUnique athlete identifier (ESPN).
guidstringStable cross-league team GUID.
uidstringESPN UID string.
slugstringURL-safe identifier.
typestringRecord type / category.
first_namestringPlayer's first name.
last_namestringPlayer's last name.
full_namestringPlayer's full name.
display_namestringDisplay name.
short_namestringShort display name.
heightnumberPlayer height (string e.g. '6-2' or inches).
display_heightstringPlayer height in display format (e.g. '6-2').
weightnumberPlayer weight in pounds.
display_weightstringPlayer weight in display format (e.g. '180 lbs').
agenumberPlayer age (in years).
date_of_birthstringDate of birth (YYYY-MM-DD).
birth_citystringBirth city.
birth_statestringBirth state / region.
birth_countrystring
jerseystringJersey number worn by the player.
position_idstringUnique position identifier.
position_namestringListed roster position ('Guard', 'Forward', 'Center').
position_abbreviationstringPosition abbreviation ('G' / 'F' / 'C').
position_display_namestringPosition display name.
college_idstringUnique identifier for college.
current_team_idstring
headshot_hrefstringHeadshot image URL.
experience_yearsnumberExperience years.
status_idstringStatus identifier.
status_namestringStatus label.
status_typestringStatus type.
draft_yearnumberDraft year (4-digit).
draft_roundnumberRound of the draft selection.
draft_selectionnumberDraft selection.
activebooleanTRUE if the row represents an active record (player / team / season).

loadWnbaPlayerImpact​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 1997)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaPlayerImpact({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_player_impact(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaPlayerImpactRow (exported from the package root).

col_nametypedescription
player_idstringUnique player identifier.
player_namestringPlayer name.
team_idstringUnique team identifier.
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_namestringFull team display name (e.g. 'Las Vegas Aces').
teamsstringNested list of member-team membership spans.
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typestringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
o_rapmnumberOffensive RAPM: ridge-regularized on/off impact on team offense, in points per 100 possessions.
d_rapmnumberDefensive RAPM: ridge-regularized on/off impact on team defense, in points per 100 possessions.
rapmnumberTotal RAPM: offensive plus defensive regularized on/off impact, in points per 100 possessions.
off_possnumber | bigintOffensive possessions the player was on the floor for in the RAPM sample.
def_possnumber | bigintDefensive possessions the player was on the floor for in the RAPM sample.
o_adj_rapmnumberOffensive prior-informed RAPM: ridge shrunk toward a box-score prior, in points per 100 possessions.
d_adj_rapmnumberDefensive prior-informed RAPM: ridge shrunk toward a box-score prior, in points per 100 possessions.
adj_rapmnumberTotal prior-informed RAPM (offense plus defense), in points per 100 possessions.
ospmnumberOffensive statistical plus-minus: box-score features regressed onto the offensive RAPM target, per 100 possessions.
dspmnumberDefensive statistical plus-minus: box-score features regressed onto the defensive RAPM target, per 100 possessions.
spmnumberStatistical plus-minus: offensive plus defensive box-score estimate of the RAPM target, per 100 possessions.
minnumberMinutes played.
gpnumber | bigintGames played.
obpmnumberOffensive box plus/minus.
dbpmnumberDefensive box plus/minus.
bpmnumberCareer box plus/minus.
warnumberWins above replacement implied by the player's impact and playing time, calibrated from team points-per-win.
darko_filtered_skillnumberDARKO-style Kalman-filtered estimate of the player's current skill level.
darko_projected_ratingnumberDARKO-style projected forward rating, including the empirical aging-curve drift.
darko_projected_sdnumberPosterior standard deviation of the DARKO-style projected rating.

loadWnbaStatsCoaches​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsCoaches({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_coaches(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsCoachesRow (exported from the package root).

col_nametypedescription
team_idstringUnique team identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
coach_idstringUnique identifier for coach.
first_namestringPlayer's first name.
last_namestringPlayer's last name.
coach_namestringFull name of the staff member as the feed renders it, exactly first_name plus a space plus last_name on every published row.
is_assistantnumber | bigintNumeric staff-role code rather than a boolean flag: 1 head coach, 2 assistant coach, 3 trainer, 9 associate head coach, mapping one-to-one onto coach_type.
coach_typestringJob title of the staff member, one of Head Coach, Associate Head Coach, Assistant Coach or Trainer in the published data.
sort_sequenceunknownOrdering field passed through unchanged from the stats.wnba.com coaches result set; it arrives empty, so every published row is null.
sub_sort_sequencenumber | bigintSecondary display-ordering rank that tracks coach_type exactly: 1 head coach, 2 associate head coach, 5 assistant coach, 7 trainer.
season_typestringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).

loadWnbaStatsDraft​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2025)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsDraft({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_draft(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsDraftRow (exported from the package root).

col_nametypedescription
person_idstringUnique player identifier (V3 endpoints).
player_namestringPlayer name.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
round_numbernumber | bigintNumeric round.
round_picknumber | bigintRound pick.
overall_picknumber | bigintOverall pick.
draft_typestringCONSTANT in the published asset: every row reads 'Draft', so it does not currently distinguish the main draft from any other selection event.
team_idstringUnique team identifier.
team_citystringTeam city or region (e.g. 'Las Vegas').
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
organizationstringOrganization.
organization_typestringOrganization type.
player_profile_flagnumber | bigintPlayer profile flag.

loadWnbaStatsGameRosters​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsGameRosters({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_game_rosters(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsGameRostersRow (exported from the package root).

col_nametypedescription
player_idstringUnique player identifier.
first_namestringPlayer's first name.
last_namestringPlayer's last name.
jersey_numstringJersey number worn by the player.
team_idstringUnique team identifier.
team_citystringTeam city or region (e.g. 'Las Vegas').
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
game_idstringUnique game identifier.

loadWnbaStatsOfficials​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsOfficials({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_officials(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsOfficialsRow (exported from the package root).

col_nametypedescription
official_idstringUnique official / referee identifier.
first_namestringPlayer's first name.
last_namestringPlayer's last name.
jersey_numstringJersey number worn by the player.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
game_idstringUnique game identifier.

loadWnbaStatsPbp​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 1997)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsPbp({ seasons: 2025, columns: ['game_id', 'period', 'clock', 'event_type', 'description'] });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_pbp(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsPbpRow (exported from the package root).

col_nametypedescription
order_indexnumber | bigintStable ordering index of the event within the game's stats.wnba.com play-by-play.
action_numbernumber | bigintSequential action number within a game (V3 PBP).
clockstringGame clock value.
periodnumber | bigintPeriod of the game (1-4 quarters; 5+ for OT).
team_idstringUnique team identifier.
team_tricodestringThree-letter team code (e.g. 'LAS' / 'NYL').
person_idstringUnique player identifier (V3 endpoints).
player_namestringPlayer name.
player_name_istringPlayer name i.
x_legacynumber | bigintV2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacynumber | bigintV2-format Y coordinate (preserved for V3-to-V2 compatibility).
shot_distancenumber | bigintShot distance from the basket, in feet.
shot_resultstringShot result ('Made' / 'Missed').
is_field_goalnumber | bigint1 if the action was a field goal; 0 otherwise.
score_homestringScore home.
score_awaystringScore away.
points_totalnumber | bigintRunning total of points scored.
locationstringFilter results by game location.
descriptionstringLong-form description text.
action_typestringAction type label (e.g. 'Made Shot', 'Substitution').
sub_typestringAction sub-type label.
video_availablenumber | bigintVideo available.
shot_valuenumber | bigintPoint value of the shot (2 or 3).
action_idstringUnique action identifier within a game (V3 PBP).
game_idstringUnique game identifier.
seconds_remainingnumberSeconds remaining in the period.
event_typestringEvent / play type code (V2 PBP).
is_made_shotbooleanTrue when the event is a made field goal.
is_missed_shotbooleanTrue when the event is a missed field goal.
is_free_throwbooleanTrue when the event is a free throw attempt.
is_reboundbooleanTrue when the event is a rebound (player or team).
is_turnoverboolean
is_foulbooleanTrue when the event is a foul.
is_substitutionbooleanTrue when the event is a substitution.
is_jump_ballbooleanTrue when the event is a jump ball.
is_timeoutbooleanTrue when the event is a timeout.
is_periodbooleanTrue for period-start and period-end marker events.
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadWnbaStatsPossessions​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 1997)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsPossessions({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_possessions(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsPossessionsRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
periodnumber | bigintPeriod of the game (1-4 quarters; 5+ for OT).
possession_numbernumber | bigintPossession number.
offense_team_idstringUnique identifier for offense team.
defense_team_idstringstats.wnba.com identifier of the defending team for the possession.
start_order_indexnumber | bigintorder_index of the first event in the possession; joins to the wnba_stats_pbp table.
end_order_indexnumber | bigintorder_index of the last event in the possession; joins to the wnba_stats_pbp table.
start_seconds_remainingnumberSeconds remaining in the period when the possession began.
end_seconds_remainingnumberSeconds remaining in the period when the possession ended.
pointsnumber | bigintPoints scored.
is_second_chancebooleanTrue when the possession continued after an offensive rebound (contains a second-chance segment).
number_in_periodnumber | bigintPossession number within the period, resetting to 1 at each period start.
possession_start_typestringHow the possession began: OffDeadball, OffTimeout, OffMadeShot, OffMissedShot, or OffLiveBallTurnover.
count_as_possessionbooleanFalse only for a possession starting with 2 seconds or less left in the period and no made basket before the period ends.
fg2anumber | bigintTwo-point field goals attempted by the offense during the possession.
fg2mnumber | bigintTwo-point field goals made by the offense during the possession.
fg3anumber | bigintThree-point field goal attempts.
fg3mnumber | bigintThree-point field goals made.
ftanumber | bigintFree throw attempts.
ftmnumber | bigintFree throws made.
orebnumber | bigintOffensive rebounds.
drebnumber | bigintDefensive rebounds.
tovnumber | bigintTurnovers.
off_player_1number | bigintstats.wnba.com identifier of offensive on-court player 1 of 5 for the possession (unordered slot).
off_player_2number | bigintstats.wnba.com identifier of offensive on-court player 2 of 5 for the possession (unordered slot).
off_player_3number | bigintstats.wnba.com identifier of offensive on-court player 3 of 5 for the possession (unordered slot).
off_player_4number | bigintstats.wnba.com identifier of offensive on-court player 4 of 5 for the possession (unordered slot).
off_player_5number | bigintstats.wnba.com identifier of offensive on-court player 5 of 5 for the possession (unordered slot).
def_player_1number | bigintstats.wnba.com identifier of defensive on-court player 1 of 5 for the possession (unordered slot).
def_player_2number | bigintstats.wnba.com identifier of defensive on-court player 2 of 5 for the possession (unordered slot).
def_player_3number | bigintstats.wnba.com identifier of defensive on-court player 3 of 5 for the possession (unordered slot).
def_player_4number | bigintstats.wnba.com identifier of defensive on-court player 4 of 5 for the possession (unordered slot).
def_player_5number | bigintstats.wnba.com identifier of defensive on-court player 5 of 5 for the possession (unordered slot).
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadWnbaStatsGameLineups​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 1997)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsGameLineups({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_game_lineups(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsGameLineupsRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
action_numbernumber | bigintSequential action number within a game (V3 PBP).
periodnumber | bigintPeriod of the game (1-4 quarters; 5+ for OT).
home_player_1number | bigintstats.wnba.com identifier of home on-court player 1 of 5 for the lineup stint.
home_player_2number | bigintstats.wnba.com identifier of home on-court player 2 of 5 for the lineup stint.
home_player_3number | bigintstats.wnba.com identifier of home on-court player 3 of 5 for the lineup stint.
home_player_4number | bigintstats.wnba.com identifier of home on-court player 4 of 5 for the lineup stint.
home_player_5number | bigintstats.wnba.com identifier of home on-court player 5 of 5 for the lineup stint.
away_player_1number | bigintstats.wnba.com identifier of away on-court player 1 of 5 for the lineup stint.
away_player_2number | bigintstats.wnba.com identifier of away on-court player 2 of 5 for the lineup stint.
away_player_3number | bigintstats.wnba.com identifier of away on-court player 3 of 5 for the lineup stint.
away_player_4number | bigintstats.wnba.com identifier of away on-court player 4 of 5 for the lineup stint.
away_player_5number | bigintstats.wnba.com identifier of away on-court player 5 of 5 for the lineup stint.
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadWnbaStatsPlayerBoxscores​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsPlayerBoxscores({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_player_boxscores(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsPlayerBoxscoresRow (exported from the package root).

col_nametypedescription
team_idstringUnique team identifier.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_tricodestringThree-letter team code (e.g. 'LAS' / 'NYL').
sidestringSide label (e.g. 'home', 'away', or 'overUnder').
person_idstringUnique player identifier (V3 endpoints).
first_namestringPlayer's first name.
family_namestringPlayer's family / last name.
name_istringInitialed name (e.g. 'A. Wilson').
player_slugstringURL-safe player identifier.
positionstringListed roster position (G, F, C, etc.).
commentstringPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numstringJersey number worn by the player.
minutesstringMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madenumber | bigintField goals made (2-pt + 3-pt).
field_goals_attemptednumber | bigintField goal attempts (2-pt + 3-pt).
field_goals_percentagenumberField goal percentage (0-1 decimal).
three_pointers_madenumber | bigintThree-point field goals made.
three_pointers_attemptednumber | bigintThree-point field goal attempts.
three_pointers_percentagenumberThree-point field goal percentage (0-1 decimal).
free_throws_madenumber | bigintFree throws made.
free_throws_attemptednumber | bigintFree throw attempts.
free_throws_percentagenumberFree throw percentage (0-1 decimal).
rebounds_offensivenumber | bigintOffensive rebounds.
rebounds_defensivenumber | bigintDefensive rebounds.
rebounds_totalnumber | bigintTotal rebounds.
assistsnumber | bigintTotal assists.
stealsnumber | bigintTotal steals.
blocksnumber | bigintTotal blocks.
turnoversnumber | bigintTotal turnovers.
fouls_personalnumber | bigintPersonal fouls.
pointsnumber | bigintPoints scored.
plus_minus_pointsnumberPlus/minus point differential while on court.
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadWnbaStatsPlayerGameLogs​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2025)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsPlayerGameLogs({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_player_game_logs(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsPlayerGameLogsRow (exported from the package root).

col_nametypedescription
season_idstringUnique season identifier.
team_idstringUnique team identifier.
team_abbreviationstringShort team abbreviation (e.g. 'LAS').
team_namestringFull team display name (e.g. 'Las Vegas Aces').
game_idstringUnique game identifier.
game_datestringGame date (YYYY-MM-DD).
matchupstringMatchup.
wlstringWl.
minnumber | bigintMinutes played.
fgmnumber | bigintField goals made.
fganumber | bigintField goals attempted.
fg_pctnumberField-goal percentage.
fg3mnumber | bigintThree-point field goals made.
fg3anumber | bigintThree-point field goals attempted.
fg3_pctnumberThree-point percentage.
ftmnumber | bigintFree throws made.
ftanumber | bigintFree throws attempted.
ft_pctnumberFree-throw percentage.
orebnumber | bigintOffensive rebounds collected.
drebnumber | bigintDefensive rebounds collected.
rebnumber | bigintTotal rebounds collected.
astnumber | bigintAssists credited.
stlnumber | bigintSteals recorded.
blknumber | bigintTotal shots blocked.
tovnumber | bigintTurnovers committed.
pfnumber | bigintPersonal fouls committed.
ptsnumber | bigintTotal points scored.
plus_minusnumber | bigintPlus-minus point differential.
video_availablenumber | bigintVideo available.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typestringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
player_idstringUnique player identifier.
player_namestringPlayer name.
fantasy_ptsnumberFantasy points.
measure_typestringStats API measure-type slice the row was pulled from (e.g. 'Base').

loadWnbaStatsRosters​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsRosters({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_rosters(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsRostersRow (exported from the package root).

col_nametypedescription
team_idstringUnique team identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
league_idstringLeague identifier ('10' = WNBA).
playerstringPlayer name.
nicknamestringTeam or athlete nickname.
player_slugstringURL-safe player identifier.
numstringJersey number worn by the player.
positionstringListed roster position (G, F, C, etc.).
heightstringPlayer height (string e.g. '6-2' or inches).
weightstringPlayer weight in pounds.
birth_datestringDate of birth (YYYY-MM-DD).
agenumberPlayer age (in years).
expstringYears of WNBA playing experience entering the season ('R' = rookie).
schoolstringPlayer's school / college (when distinct from 'college').
player_idstringUnique player identifier.
how_acquiredstringHow the team acquired the player (draft, trade, free agency).
supplemental_statusnumber | bigintNumeric supplemental roster-status code from the stats.wnba.com roster feed.
season_typestringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).

loadWnbaStatsSchedules​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 1997)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsSchedules({ seasons: 2025 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_schedules(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsSchedulesRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
seasonnumber | bigintSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typestringSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_datestringGame date (YYYY-MM-DD).
matchupstringMatchup.
home_team_idstringUnique identifier for the home team.
home_team_abbreviationstring
home_team_namestringHome team name.
home_ptsnumber | bigintFinal points scored by the home team.
home_wlstringResult for the home team ('W' or 'L'); null before the game is final.
away_team_idstringUnique identifier for the away team.
away_team_abbreviationstring
away_team_namestringAway team name.
away_ptsnumber | bigintFinal points scored by the away team.
away_wlstringResult for the away team ('W' or 'L'); null before the game is final.

loadWnbaStatsShots​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsShots({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_shots(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsShotsRow (exported from the package root).

col_nametypedescription
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
periodnumber | bigintPeriod of the game (1-4 quarters; 5+ for OT).
clockstringGame clock value.
team_idstringUnique team identifier.
team_tricodestringThree-letter team code (e.g. 'LAS' / 'NYL').
person_idstringUnique player identifier (V3 endpoints).
player_namestringPlayer name.
action_typestringAction type label (e.g. 'Made Shot', 'Substitution').
sub_typestringAction sub-type label.
shot_resultstringShot result ('Made' / 'Missed').
shot_valuenumber | bigintPoint value of the shot (2 or 3).
shot_distancenumber | bigintShot distance from the basket, in feet.
x_legacynumber | bigintV2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacynumber | bigintV2-format Y coordinate (preserved for V3-to-V2 compatibility).
descriptionstringLong-form description text.
score_homestringScore home.
score_awaystringScore away.

loadWnbaStatsTeamBoxscores​

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

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 2026)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaStatsTeamBoxscores({ seasons: 2026 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_stats_team_boxscores(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaStatsTeamBoxscoresRow (exported from the package root).

col_nametypedescription
team_idstringUnique team identifier.
team_namestringFull team display name (e.g. 'Las Vegas Aces').
team_tricodestringThree-letter team code (e.g. 'LAS' / 'NYL').
sidestringSide label (e.g. 'home', 'away', or 'overUnder').
minutesstringMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madenumber | bigintField goals made (2-pt + 3-pt).
field_goals_attemptednumber | bigintField goal attempts (2-pt + 3-pt).
field_goals_percentagenumberField goal percentage (0-1 decimal).
three_pointers_madenumber | bigintThree-point field goals made.
three_pointers_attemptednumber | bigintThree-point field goal attempts.
three_pointers_percentagenumberThree-point field goal percentage (0-1 decimal).
free_throws_madenumber | bigintFree throws made.
free_throws_attemptednumber | bigintFree throw attempts.
free_throws_percentagenumberFree throw percentage (0-1 decimal).
rebounds_offensivenumber | bigintOffensive rebounds.
rebounds_defensivenumber | bigintDefensive rebounds.
rebounds_totalnumber | bigintTotal rebounds.
assistsnumber | bigintTotal assists.
stealsnumber | bigintTotal steals.
blocksnumber | bigintTotal blocks.
turnoversnumber | bigintTotal turnovers.
fouls_personalnumber | bigintPersonal fouls.
pointsnumber | bigintPoints scored.
plus_minus_pointsnumberPlus/minus point differential while on court.
game_idstringUnique game identifier.
seasonnumberSeason as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

loadWnbaGroups​

Release: wnba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wnba_groups/wnba_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. wnba:east) 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 calendar year.

optiontyperequireddescription
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaGroups();
// snake_case alias (py/R parity): sdv.wnba.load_wnba_groups(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaGroupsRow (exported from the package root).

col_nametypedescription
leaguestringLeague code of the table ("wnba"); the prefix of every group_id in it.
group_idstringSDV 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.
levelstringHierarchy level of the group: "league", "subdivision", "conference" or "division".
first_seasonnumberFirst season in which the group had at least one member (calendar year).
last_seasonnumberLast season in which the group had at least one member (calendar year).
notesstringBuilder notes on the group: the lineage decisions behind its group_id and any source caveats.

loadWnbaGroupSeasons​

Release: wnba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wnba_groups/wnba_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 calendar year.

optiontyperequireddescription
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaGroupSeasons();
// snake_case alias (py/R parity): sdv.wnba.load_wnba_group_seasons(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaGroupSeasonsRow (exported from the package root).

col_nametypedescription
leaguestringLeague code of the table ("wnba"); the prefix of every group_id in it.
group_idstringSDV 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.
seasonnumberSeason the row describes (calendar year).
levelstringHierarchy level of the group: "league", "subdivision", "conference" or "division".
namestringFull name of the group as of that season -- the label in use then, not today's name.
short_namestringShort display name of the group as of that season.
abbreviationstringAbbreviation of the group as of that season.
parent_group_idstringgroup_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_teamsnumberNumber of member teams in the group that season.

loadWnbaGroupAliases​

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

Coverage

One season-less file: every name, abbreviation, slug and source id that a source (espn, sdv, wnba_stats) 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.

optiontyperequireddescription
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaGroupAliases();
// snake_case alias (py/R parity): sdv.wnba.load_wnba_group_aliases(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaGroupAliasesRow (exported from the package root).

col_nametypedescription
leaguestringLeague code of the table ("wnba"); the prefix of every group_id in it.
group_idstringSDV 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.
sourcestringSource that uses this label or id (in this table: espn, sdv, wnba_stats); "sdv" marks SDV's own labels.
source_idstringThe 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_kindstringKind of label in value: "name", "short_name", "abbreviation", "slug" or "code".
valuestringThe label exactly as the source writes it; match a source's conference or division label against it to reach group_id.
valid_fromnumberFirst season the alias is valid for, inclusive (calendar year); null = unbounded.
valid_tonumberLast season the alias is valid for, inclusive (calendar year); null = unbounded (still in use).

loadWnbaTeamGroupSeasons​

Release: wnba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wnba_groups/wnba_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 calendar year; seasons 1997-2026.

optiontyperequireddescription
seasonsnumber | number[]yesseason(s) to load (>= 1997)
columnsstring[]noread only these columns
format"rows" | "columns"norow objects (default) or column arrays
maxCellsnumbernosize guard; default scales with the heap, Infinity disables
timeoutMsnumbernodownload timeout in ms (default 300000)
const rows = await sdv.wnba.loadWnbaTeamGroupSeasons({ seasons: 2024 });
// snake_case alias (py/R parity): sdv.wnba.load_wnba_team_group_seasons(...)

Returns (one row per record; every column optional and nullable):

Row type: LoadWnbaTeamGroupSeasonsRow (exported from the package root).

col_nametypedescription
leaguestringLeague code of the table ("wnba"); the prefix of every group_id in it.
seasonnumberSeason of the membership (calendar year).
team_idstringTeam 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_sourcestringId space of team_id (in this table: espn).
team_namestringTeam name as of that season, not today's.
subdivision_idstringSDV group_id of the team's subdivision that season (e.g. FBS / FCS, Division I); null where the league has no subdivision level.
conference_idstringSDV 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_idstringSDV group_id of the team's division that season; null where the level does not apply.
sourcestringSource the membership was taken from -- the most reliable per-season source for that era.
sources_agreebooleanWhether a second source agreed on the membership; null when only one source covers the season.
notesstringBuilder notes on the team-season, such as a source disagreement or which of several listed memberships was kept.

Generated by tools/codegen/generate.mjs from tools/codegen/endpoints/releases.yaml (vendored from sdv-py) — see How this library is built.