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

36 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_schedules1997+
loadWnbaTeamBoxscoreespn_wnba_team_boxscores2002+
loadWnbaDraftespn_wnba_draft2018+
loadWnbaGameRostersespn_wnba_game_rosters2002+
loadWnbaOfficialsespn_wnba_officials2003+
loadWnbaPlayerSeasonStatsespn_wnba_player_season_stats2002+
loadWnbaRostersespn_wnba_rosters2024+
loadWnbaShotsespn_wnba_shots2002+
loadWnbaStandingsespn_wnba_standings2002+
loadWnbaTeamSeasonStatsespn_wnba_team_season_stats2002+
loadWnbaPlayerCrosswalkwnba_crosswalk2002+
loadWnbaScheduleCrosswalkwnba_crosswalk2002+
loadWnbaTeamCrosswalkwnba_crosswalk2002+
loadWnbaPlayerCoreespn_wnba_player_core2003+
loadWnbaPlayerImpactwnba_player_impact1997+
loadWnbaStatsCoacheswnba_stats_coaches1997+
loadWnbaStatsDraftwnba_stats_draft1997+
loadWnbaStatsGameRosterswnba_stats_game_rosters1997+
loadWnbaStatsOfficialswnba_stats_officials2004+
loadWnbaStatsPbpwnba_stats_pbp1997+
loadWnbaStatsPossessionswnba_stats_possessions1997+
loadWnbaStatsGameLineupswnba_stats_game_lineups1997+
loadWnbaStatsPlayerBoxscoreswnba_stats_player_boxscores2026+
loadWnbaStatsPlayerGameLogswnba_stats_player_game_logs1997+
loadWnbaStatsRosterswnba_stats_rosters1997+
loadWnbaStatsScheduleswnba_stats_schedules1997+
loadWnbaStatsShotswnba_stats_shots1997+
loadWnbaStatsTeamBoxscoreswnba_stats_team_boxscores2026+
loadWnbaGroupswnba_groupsone asset
loadWnbaGroupSeasonswnba_groupsone asset
loadWnbaGroupAliaseswnba_groupsone asset
loadWnbaTeamGroupSeasonswnba_groups1997+
loadWnbaTeamAliaseswnba_groupsone asset
loadWnbaPlayerAliaseswnba_groupsone asset

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's score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). Seasons published before the repair carry ESPN's per-play value.
home_scorenumberHome team's score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). Seasons published before the repair carry ESPN's per-play value.
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
score_sourcestringWhere this game's home_score/away_score come from: 'rebuilt' (summed from the scoring plays and equal to the official final on the last play) or 'espn' (ESPN's per-play values, kept when the rebuild misses the final or the game has no final). Absent from seasons published before the repair. Select it by name: it is the play-by-play builder's last column, but a release can carry columns after it.

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 (>= 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.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_idstringESPN's numeric game-status code, passed through unchanged. ESPN publishes no reference for these codes, so read status_type_name rather than hard-coding numbers.
status_type_namestringESPN's game-status enum (STATUS_FINAL, STATUS_SCHEDULED, STATUS_POSTPONED, STATUS_CANCELED, ...), passed through unchanged. ESPN does not document the full set, and no value certifies an ordinary final as distinct from a forfeit or an awarded result.
status_type_statestringESPN's coarse game state, passed through unchanged: pre, in or post. post covers every game that is over, whatever the reason.
status_type_completedbooleanESPN's completed flag, passed through unchanged: true once ESPN considers the game over. It does not separate an ordinary final from a forfeited, protested, replayed or awarded result; ESPN documents no such distinction.
status_type_descriptionstringESPN's display text for the game status (for example "Final" or "Postponed"), passed through unchanged.
status_type_detailstringESPN's longer status text, passed through unchanged; an overtime final reads like "Final/OT".
status_type_short_detailstringESPN's short status text for scoreboards, passed through unchanged.
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's points as ESPN reports them: once the game is final, the full-game total including every overtime period. ESPN corrects a score in place, so this is the value ESPN showed when the release was last built. Not a final score until status_type_completed is true.
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's points as ESPN reports them: once the game is final, the full-game total including every overtime period. ESPN corrects a score in place, so this is the value ESPN showed when the release was last built. Not a final score until status_type_completed is true.
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 (>= 2018)
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 (>= 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.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

Coverage

Published seasons: every season from the floor except 2022 and 2023, which the release has no asset for; a request for one is skipped with a warning.

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.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

Coverage

Published seasons: every season from the floor except 2022 and 2023, which the release has no asset for; a request for one is skipped with a warning.

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.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 (>= 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.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

Coverage

Published seasons: every season from the floor except 2022 and 2023, which the release has no asset for; a request for one is skipped with a warning.

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.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

Coverage

Published seasons: every season from the floor except 2022 and 2023, which the release has no asset for; a request for one is skipped with a warning.

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.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

Coverage

wnba_player_id is Int64, as WNBA Stats ships player_id / person_id, so the bridge joins without a cast.

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.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

Coverage

wnba_game_id stays String, the WNBA Stats game id's dtype; the wnba_*_team_id bridge ids are Int64, as WNBA Stats ships team_id.

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.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 Sports game id (string), filled when the crosswalk is built with fox=True from Fox's per-date scoreboard, matched on the US-Eastern date and the two teams in either home/away order; null otherwise and where Fox lists no matching game.
fox_home_team_idstringFox Sports team id of the side Fox calls home in fox_game_id, filled with fox=True; at a neutral site it can be the reverse of home_espn_team_id. Null when fox_game_id is.
fox_away_team_idstringFox Sports team id of the side Fox calls away in fox_game_id, filled with fox=True; at a neutral site it can be the reverse of away_espn_team_id. Null when fox_game_id is.
yahoo_game_idstringYahoo Sports game id, wnba.g.<YYYYMMDD US-Eastern date><home Yahoo team id, 3 digits>, filled when built with yahoo=True and checked against the ids Yahoo lists, so a neutral-site game carries the side Yahoo calls home; null otherwise and where Yahoo lists no such game (a non-Division-I home team).
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

Coverage

wnba_team_id is Int64, as WNBA Stats ships team_id, so the bridge joins without a cast.

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.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_idstringDotted Yahoo Sports team id (e.g. 'wnba.t.4'), filled when built with yahoo=True from Yahoo's team listing joined on full name, short name, then nickname; null otherwise and where no Yahoo team matched.
yahoo_team_abbreviationstringYahoo Sports team abbreviation for yahoo_team_id; null when yahoo_team_id is.
yahoo_team_namestringYahoo Sports full team name for yahoo_team_id; null when yahoo_team_id is.
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

Coverage

The BOBAN (Bayesian Online Box-Augmented Net) columns boban_filtered_skill, boban_projected_rating and boban_projected_sd were renamed from darko_; the loader returns both names for one release, so move to boban_ now (darko_* is deprecated and will be removed).

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, at the fixed WNBA penalty described under rapm.
d_rapmnumberDefensive RAPM: ridge-regularized on/off impact on team defense, in points per 100 possessions, at the fixed WNBA penalty described under rapm.
rapmnumberTotal RAPM: offensive plus defensive regularized on/off impact, in points per 100 possessions. The ridge penalty is one fixed WNBA value (1,931, sportsdataverse.nba.nba_rapm.RAPM_PENALTY) in every season and season type, so the scale compares across seasons (regular-season sd 1.47 to 2.13 per 100 over players with 200 possessions, 1997-2026; fewer possessions shrink harder, so part of a spread difference is sample size). Seasons published before November 2026 were fit at a per-season RidgeCV pick: 1,931 in 23 of 30 regular seasons, but 5,179 or 13,895 in 1999, 2001, 2002, 2004, 2011, 2014 and 2016 (sd 0.32 to 0.93 there) and 268 to 100,000 in the playoffs. Do not compare those seasons with others or with values fit at the fixed penalty.
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 per 100 possessions: the ridge fit shrunk toward the player's box-score (SPM) prior. In releases fit with sportsdataverse-py #1137 or later it is relative to an average player, up to any offset the SPM prior carries (possession-weighted league mean near 0: 2025 +0.45). A player with no prior (a rookie, or no previous-season SPM) is shrunk toward 0 instead. Releases fit before #1137, whatever their build date, fit no intercept, so the league's points per possession leaked into every coefficient: o_adj_rapm averaged about +10.97 and d_adj_rapm -9.60 (2025), a thinly-used player kept less of that offset, and only their sum, adj_rapm, read on a common scale.
d_adj_rapmnumberDefensive prior-informed RAPM per 100 possessions, positive for a defender who lowers opponent scoring. In releases fit with sportsdataverse-py #1137 or later it is relative to an average player, up to any offset the SPM prior carries (possession-weighted league mean near 0: 2025 +0.11). Releases fit before #1137, whatever their build date, averaged about -9.60 here (see o_adj_rapm).
adj_rapmnumberTotal prior-informed RAPM per 100 possessions, exactly the sum of o_adj_rapm and d_adj_rapm. Releases fit with sportsdataverse-py #1137 or later fit the ridge with an unpenalized intercept; releases fit before it (whatever their build date) fit none, which leaned this total toward heavy-minute players. Releases fit with #1150 or later also use one ridge penalty per league (NBA 3,728, WNBA 2,683) and the SPM prior doubled (nba_adj_rapm.ADJ_RAPM_PENALTY / ADJ_RAPM_PRIOR_SCALE); earlier ones took a per-season RidgeCV pick, whose spread collapsed in some seasons (WNBA 2004 sd 0.64 against plain RAPM's 1.47).
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 per 100 possessions for this season and season type only, team-adjusted on its own so a team's minute-weighted obpm is its offensive rating minus the league's, divided by 5 (a traded player counted with his first team; league minute-weighted mean near 0). Releases fit before sportsdataverse-py #1148 put the whole team adjustment here (regular-season league minute-weighted mean about -2.9).
dbpmnumberDefensive box plus-minus per 100 possessions for this season and season type only: bpm minus obpm, so a team's minute-weighted dbpm is (the league's offensive rating minus its defensive rating) / 5, positive for a good defense (league minute-weighted mean near 0). Releases fit before sportsdataverse-py #1148 left it unadjusted (regular-season league minute-weighted mean about +2.9, mostly positive).
bpmnumberBox plus-minus (BPM 2.0) per 100 possessions for this season and season type only, not a career value: the box-score estimate of total impact. The team adjustment makes a team's minute-weighted bpm its net rating per 100 divided by 5 (the five %Min slots sum to the net rating; a traded player's minutes count with the first team he appears for in the logs). Releases fit before sportsdataverse-py #1148 targeted the full net rating, five times BPM 2.0's team mean.
warnumberWins above replacement implied by the player's impact and playing time, calibrated from team points-per-win.
boban_filtered_skillnumberBOBAN Kalman-filtered estimate of the player's current skill level.
boban_projected_ratingnumberBOBAN projected forward rating, including the empirical aging-curve drift.
boban_projected_sdnumberPosterior standard deviation of the BOBAN projected rating.
darko_filtered_skillnumberDeprecated alias of boban_filtered_skill, kept for one release; use that column.
darko_projected_ratingnumberDeprecated alias of boban_projected_rating, kept for one release; use that column.
darko_projected_sdnumberDeprecated alias of boban_projected_sd, kept for one release; use that column.
o_rapm_nnumber | bigintPossessions o_rapm is measured over: off_poss, his offensive possessions. o_rapm_rank and o_rapm_pct are set only when it reaches 610, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
d_rapm_nnumber | bigintPossessions d_rapm is measured over: def_poss, his defensive possessions. d_rapm_rank and d_rapm_pct are set only when it reaches 1,200, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
rapm_nnumber | bigintPossessions rapm is measured over: off_poss + def_poss, his possessions at both ends. rapm_rank and rapm_pct are set only when it reaches 1,600, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
o_adj_rapm_nnumber | bigintPossessions o_adj_rapm is measured over: off_poss, his offensive possessions. o_adj_rapm_rank and o_adj_rapm_pct are set only when it reaches 610, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
d_adj_rapm_nnumber | bigintPossessions d_adj_rapm is measured over: def_poss, his defensive possessions. d_adj_rapm_rank and d_adj_rapm_pct are set only when it reaches 1,200, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
adj_rapm_nnumber | bigintPossessions adj_rapm is measured over: off_poss + def_poss, his possessions at both ends. adj_rapm_rank and adj_rapm_pct are set only when it reaches 1,600, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
ospm_nnumber | bigintPossessions ospm is measured over: off_poss, his offensive possessions. ospm_rank and ospm_pct are set only when it reaches 610, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
dspm_nnumber | bigintPossessions dspm is measured over: def_poss, his defensive possessions. dspm_rank and dspm_pct are set only when it reaches 1,200, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
spm_nnumber | bigintPossessions spm is measured over: off_poss + def_poss, his possessions at both ends. spm_rank and spm_pct are set only when it reaches 1,600, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
obpm_nnumber | bigintPossessions obpm is measured over: off_poss, his offensive possessions. obpm_rank and obpm_pct are set only when it reaches 610, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
dbpm_nnumber | bigintPossessions dbpm is measured over: def_poss, his defensive possessions. dbpm_rank and dbpm_pct are set only when it reaches 1,200, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
bpm_nnumber | bigintPossessions bpm is measured over: off_poss + def_poss, his possessions at both ends. bpm_rank and bpm_pct are set only when it reaches 1,600, the WNBA sample at which a player's on-court rating of the same side is half signal (sportsdataverse._common.rate_gates.ON_OFF_MIN_N); a regularized or box rating is less noisy, so the gate is conservative.
war_nnumber | bigintPossessions behind war: off_poss + def_poss. war is a count, not a rate, so its rank has no sample gate.
boban_filtered_skill_nnumber | bigintPossessions behind boban_filtered_skill: off_poss + def_poss, this season's possessions at both ends. The boban filtered skill is a multi-season Kalman estimate with no single-side sample, so it takes the net on-court gate, the closest existing one: boban_filtered_skill_rank and boban_filtered_skill_pct are set only when this reaches 1,600. Conservative, since the filter also carries earlier seasons.
boban_projected_rating_nnumber | bigintPossessions behind boban_projected_rating: off_poss + def_poss, this season's possessions at both ends. The boban next-season projection is a multi-season Kalman estimate with no single-side sample, so it takes the net on-court gate, the closest existing one: boban_projected_rating_rank and boban_projected_rating_pct are set only when this reaches 1,600. Conservative, since the filter also carries earlier seasons.
boban_projected_sd_nnumber | bigintPossessions behind boban_projected_sd: off_poss + def_poss, this season's possessions at both ends. The boban projection's standard deviation is a multi-season Kalman estimate with no single-side sample, so it takes the net on-court gate, the closest existing one: boban_projected_sd_rank and boban_projected_sd_pct are set only when this reaches 1,600. Conservative, since the filter also carries earlier seasons.
o_rapm_ranknumberRank of o_rapm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when o_rapm_n is under 610, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
d_rapm_ranknumberRank of d_rapm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when d_rapm_n is under 1,200, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
rapm_ranknumberRank of rapm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when rapm_n is under 1,600, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
o_adj_rapm_ranknumberRank of o_adj_rapm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when o_adj_rapm_n is under 610, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
d_adj_rapm_ranknumberRank of d_adj_rapm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when d_adj_rapm_n is under 1,200, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
adj_rapm_ranknumberRank of adj_rapm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when adj_rapm_n is under 1,600, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
ospm_ranknumberRank of ospm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when ospm_n is under 610, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
dspm_ranknumberRank of dspm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when dspm_n is under 1,200, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
spm_ranknumberRank of spm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when spm_n is under 1,600, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
obpm_ranknumberRank of obpm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when obpm_n is under 610, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
dbpm_ranknumberRank of dbpm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when dbpm_n is under 1,200, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
bpm_ranknumberRank of bpm among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when bpm_n is under 1,600, and null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal. Regular-season gates: a playoff run rarely reaches one.
war_ranknumberRank of war among the season and season type's ranked players, 1 = best (higher is better), ties averaged; ungated (every player with a finite war qualifies), null when its season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value in the group is equal.
boban_filtered_skill_ranknumberRank of boban_filtered_skill among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when boban_filtered_skill_n is under 1,600, when season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value is equal.
boban_projected_rating_ranknumberRank of boban_projected_rating among the season and season type's ranked players, 1 = best (higher is better), ties averaged; null when boban_projected_rating_n is under 1,600, when season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value is equal.
boban_projected_sd_ranknumberRank of boban_projected_sd among the season and season type's ranked players, ASCENDING: 1 = the smallest sd, the most certain projection; ties averaged; null when boban_projected_sd_n is under 1,600, when season or season_type is null, in a group of fewer than 10 ranked players, or when every ranked value is equal.
o_rapm_pctnumberPercentile of o_rapm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
d_rapm_pctnumberPercentile of d_rapm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
rapm_pctnumberPercentile of rapm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
o_adj_rapm_pctnumberPercentile of o_adj_rapm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
d_adj_rapm_pctnumberPercentile of d_adj_rapm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
adj_rapm_pctnumberPercentile of adj_rapm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
ospm_pctnumberPercentile of ospm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
dspm_pctnumberPercentile of dspm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
spm_pctnumberPercentile of spm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
obpm_pctnumberPercentile of obpm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
dbpm_pctnumberPercentile of dbpm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
bpm_pctnumberPercentile of bpm_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
war_pctnumberPercentile of war_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
boban_filtered_skill_pctnumberPercentile of boban_filtered_skill_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
boban_projected_rating_pctnumberPercentile of boban_projected_rating_rank, 100 * (n + 1 - rank) / (n + 1) over the n ranked players of the season and season type; null where the rank is.
boban_projected_sd_pctnumberPercentile of boban_projected_sd_rank, 100 * (n + 1 - rank) / (n + 1): high means a more certain projection (a smaller sd), not a larger one; null where the rank is.

loadWnbaStatsCoaches​

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

Coverage

Published seasons: every season from the floor except 2019, which the release has no asset for; a request for one is skipped with a warning.

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.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 (>= 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.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 (>= 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.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 (>= 2004)
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 the offense scored in the possession (its score step), plus any score it made while on defense since its previous possession (a technical free throw, say), credited here with its shots.
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 (>= 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.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 (>= 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.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 (>= 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.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.

loadWnbaTeamAliases​

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

Coverage

One season-less file: every id and name another source (fox, wnba_stats, yahoo) uses for a team, keyed on the ESPN team id (team_id, a string; team_id_source = espn), with the seasons the source shows it on that team (valid_from / valid_to, inclusive; both null for an undated curated map). id_kind says whether source_id is the source's id for this sport's team or one id for every sport of a school; a name-only row has a null source_id. A source id means something only within its source (Fox 25 is not ESPN 25), so filter on source before joining on source_id. 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.loadWnbaTeamAliases();
// snake_case alias (py/R parity): sdv.wnba.load_wnba_team_aliases(...)

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

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

col_nametypedescription
leaguestringLeague code of the table ("wnba").
team_idstringESPN team id the alias points to, as a string (e.g. "150"); the same id as team_id in load_wnba_team_group_seasons. Join on it to reach ESPN team data.
team_id_sourcestringId space of team_id; always "espn" in this table.
sourcestringProvider that uses this id or name (in this table: fox, wnba_stats, yahoo).
source_idstringThe source's own id for the team (e.g. Fox 25, Yahoo nba.t.1); null for a name-only row. It means something only within its source (Fox 25 is Ohio State, ESPN 25 is California), so filter on source first.
id_kindstring"team" when source_id is the source's id for this sport's team, or "school" when it is one id for every sport of a school (the stats.ncaa.org org id, 247Sports institutionKey, On3 orgKey).
name_kindstringKind of label in value: "name" or "abbreviation"; null when the row carries only an id. An id with both a name and an abbreviation is two rows.
valuestringThe source's own spelling of the team name or abbreviation; null when the row carries only an id.
valid_fromnumberFirst season the source shows this id or name on the team, inclusive (calendar year); null, with valid_to, for an undated curated map.
valid_tonumberLast season the source shows this id or name on the team, inclusive (calendar year); null, with valid_from, for an undated curated map. A gap in the source splits the window into two rows.
match_methodstringHow the row was tied to the ESPN team: "deterministic" (a formula or shared key, e.g. Yahoo {league}.t.{espn id}; CFBD ids are ESPN ids), "crosswalk" (carried from a published crosswalk leg), "curated" (a cited map), or for a hand-captured team directory row "alias", "exact_name" (normalized name) or "dict" (curated name dictionary).
evidencestringThe release asset or sportsdataverse/sdv-reference-data file the row came from.

loadWnbaPlayerAliases​

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

Coverage

One season-less file: every player id another source (fox, wnba_stats, yahoo) uses for an ESPN athlete (athlete_id, a string; athlete_id_source = espn), with the ESPN team the match was made on (team_id) and the seasons it held (valid_from / valid_to, inclusive). match_method and match_confidence carry the matching leg's own method and score. Filter on source before joining on source_player_id. 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.loadWnbaPlayerAliases();
// snake_case alias (py/R parity): sdv.wnba.load_wnba_player_aliases(...)

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

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

col_nametypedescription
leaguestringLeague code of the table ("wnba").
athlete_idstringESPN athlete id the provider id points to, as a string (e.g. "4433134"). Join on it to reach ESPN player data; the ESPN player loaders (load_wnba_player_core and its siblings) carry it as Int32, so cast first with pl.col("athlete_id").cast(pl.Int32).
athlete_id_sourcestringId space of athlete_id; always "espn" in this table.
sourcestringProvider whose player id this is (in this table: fox, wnba_stats, yahoo).
source_player_idstringThe source's own player id (e.g. Yahoo wnba.p.5010, Fox 76284). It means something only within its source, so filter on source first.
team_idstringESPN team id (a string) the athlete was on in these seasons: the team block the match was made in, an ESPN team-season of load_wnba_team_group_seasons.
source_team_idstringThe source's own team id when the matching leg gives one (the season's stats.ncaa.org team id; the Fox / Yahoo / CBS team for the NFL); null otherwise.
valid_fromnumberFirst season the id is on that team, inclusive (calendar year).
valid_tonumberLast season the id is on that team, inclusive (calendar year). A gap or a change of match method splits the window into two rows.
match_methodstringThe matching leg's own method (exact_name, fuzzy_jw, the NCAA tiers name_jersey / name / last_jersey / jaro_winkler, CFB rosters name); crosswalk for a leg that names none; propagated when a pair matched in another season was carried to this provider id; override for a hand-verified override.
match_confidencenumberThe leg's own match confidence where it gives one (the lowest in the window); the NCAA tiers score 1.0 / 0.95 / 0.9 / 0.85; null otherwise.
evidencestringThe release asset or sportsdataverse/sdv-reference-data file the row came from.

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