Breaking in 4.0.0

• Public names are sportsdataverse-py's — athlete → player, event → game on every ESPN league; sdv-py's name_pattern on the native families (nhlApiWeb* → nhl*, nflApi* → nfl*, CBS's 16 shorts, the 3.0.0 file-stem names). Every pre-v4 name still works as a deprecated alias that warns once. (changelog)
• 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)
• 400 / 422 raise InvalidParameterError — For every family (it was AssetFetchError), never retried; the message names host, path and status with a redacted excerpt of the body. (changelog)
• Typed returns — generated row types for parsed: true — TypeScript only. A wrapper's raw payload resolves to unknown (was any); verified endpoints resolve to their row interfaces; the summary dispatchers to ParsedTables. Narrow or cast a raw payload. (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)
• Wrapper failures raise NoDataError / AssetFetchError — Instead of raw axios errors. NoDataError = the fetch worked and there is nothing there (404, ESPN { code: 404 }); AssetFetchError = the fetch failed (403 / 429 / 5xx after retries, network). Retries follow DEFAULT_RETRY_STATUSES with backoff. (changelog)

nbasl_ut — Site API

24 endpoints on sdv.nbasl_ut. Each is exposed under a camelCase canonical name and a snake_case alias (py/R parity), accepts snake_case or camelCase params, and returns raw ESPN JSON by default ({ parsed: true } for tidy rows).

espnNbaslUtPlayerBio

NBASL_UT — player bio (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/athletes/{athlete_id}/bio

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league and payload, so no fixed table is published. This endpoint is exposed on 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtPlayerBio({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_player_bio(...)

espnNbaslUtPlayerInfo

NBASL_UT — player info (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/athletes/{athlete_id}

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league and payload, so no fixed table is published. This endpoint is exposed on 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtPlayerInfo({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_player_info(...)

espnNbaslUtPlayerNews

NBASL_UT — player news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/athletes/{athlete_id}/news

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_news):

col_name	type	description
id	integer	ESPN numeric identifier for the article.
now_id	character	ESPN 'now' feed id.
content_key	character	Internal content key.
data_source_identifier	character	Source-system identifier.
type	character	Article type (Story, Media, HeadlineNews, etc.).
headline	character	Article headline.
description	character	Article summary/description.
last_modified	character	Last-modified timestamp (ISO 8601).
published	character	Publish timestamp (ISO 8601).
images	character	Article images (list, stringified).
categories	character	Article categories (list, stringified).
premium	logical	Whether the article is premium/paywalled.
links_web_href	character	Web article URL.
links_mobile_href	character	Mobile article URL.
links_api_self_href	character	ESPN API canonical self-link for the article resource.
links_app_sportscenter_href	character	SportsCenter app deep link.
byline	character	Author byline string as published by ESPN.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtPlayerNews({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_player_news(...)

espnNbaslUtCalendar

NBASL_UT — calendar (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/calendar

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtCalendar({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_calendar(...)

espnNbaslUtConferences

NBASL_UT — conferences (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/groups

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_groups); the column set varies by league and payload, so no fixed table is published. This endpoint is exposed on 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_groups for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtConferences({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_conferences(...)

espnNbaslUtDraft

NBASL_UT — draft (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/draft

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtDraft({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_draft(...)

espnNbaslUtInjuries

NBASL_UT — injuries (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/injuries

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_injuries):

col_name	type	description
id	character	ESPN numeric identifier for the athlete.
display_name	character	Athlete's full display name as shown on ESPN.
injuries	character	Injury entries for the athlete (list of dicts, stringified): status, type, details, dates.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtInjuries({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_injuries(...)

espnNbaslUtNews

NBASL_UT — news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/news

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 50
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_news):

col_name	type	description
id	integer	ESPN numeric identifier for the article.
now_id	character	ESPN 'now' feed id.
content_key	character	Internal content key.
data_source_identifier	character	Source-system identifier.
type	character	Article type (Story, Media, HeadlineNews, etc.).
headline	character	Article headline.
description	character	Article summary/description.
last_modified	character	Last-modified timestamp (ISO 8601).
published	character	Publish timestamp (ISO 8601).
images	character	Article images (list, stringified).
categories	character	Article categories (list, stringified).
premium	logical	Whether the article is premium/paywalled.
links_web_href	character	Web article URL.
links_mobile_href	character	Mobile article URL.
links_api_self_href	character	ESPN API canonical self-link for the article resource.
links_app_sportscenter_href	character	SportsCenter app deep link.
byline	character	Author byline string as published by ESPN.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtNews({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_news(...)

espnNbaslUtScoreboard

NBASL_UT — scoreboard (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/scoreboard

API param	JS	required	description
dates	dates	no	number | string — a date YYYYMMDD, a range YYYYMMDD-YYYYMMDD or a season year YYYY
week	week	no	number | string — the week of the season (football)
seasontype	season_type	no	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
groups	groups	no	number | string — an ESPN group (conference / division) id, e.g. 50 for all of men's college basketball
limit	limit	no	number | string — the maximum number of items to return; default 500
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_scoreboard):

col_name	type	description
game_id	character	Unique game identifier.
uid	character	ESPN UID string.
date	character	Match start timestamp (ISO 8601, UTC).
name	character	Full event name (e.g. 'Team A at Team B').
short_name	character	Abbreviated event name (e.g. 'TA @ TB').
season_year	integer	Integer season year ESPN assigns the event (e.g. 2025 for the 2025-26 season).
season_type	integer	ESPN season-type id of the event's season: 1 preseason, 2 regular season, 3 postseason, 4 offseason for the US leagues; soccer competitions carry their own competition-specific ids (e.g. 13481).
season_slug	character	ESPN slug of the event's season type (e.g. 'regular-season', 'post-season'; soccer competitions use their own, such as 'final' or 'torneo-apertura').
status_type_id	character	Unique identifier for status type.
status_type_name	character	Status type name.
status_type_state	character	Status type state.
status_type_completed	logical	Status type completed.
status_type_description	character	Status type description.
status_type_detail	character	Status type detail.
status_type_short_detail	character	Status type short detail.
status_clock	integer	Game clock in seconds as ESPN reports it: time remaining in the period for clock sports, elapsed seconds for soccer (e.g. 5400.0 at full time); 0.0 once a game has ended.
status_display_clock	character	Status display clock.
status_period	integer	Current or final period number (quarter, half, inning or period, depending on the sport).
neutral_site	logical	Whether the match is played at a neutral venue.
conference_competition	logical	Conference competition.
attendance	integer	Reported attendance.
venue_id	character	Unique venue identifier.
venue_full_name	character	Venue full name.
venue_city	character	Venue city.
venue_state	character	Venue state / region.
venue_indoor	logical	TRUE if the venue is indoors.
broadcast	character	Every network name of the competition in feed order, deduped and ", "-joined (an entry with no names gives its market); "" when the game lists no broadcast.
note	character	Event note text from the competition (e.g. a series or game label such as 'World Series - Game 1', or a shootout result); an empty string when there is none.
home_id	character	Unique identifier for home.
home_name	character	Home name.
home_abbreviation	character	Home team's abbreviation.
home_display_name	character	Home display name.
home_location	character	Home team's location.
home_color	character	Color code (hex) for home.
home_alternate_color	character	Color code (hex) for home alternate.
home_logo	character	Home team logo URL.
home_score	character	Home team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)').
home_winner	logical	Home team's winner.
home_rank	character
away_id	character	Unique identifier for away.
away_name	character	Away name.
away_abbreviation	character	Away team's abbreviation.
away_display_name	character	Away display name.
away_location	character	Away team's location.
away_color	character	Color code (hex) for away.
away_alternate_color	character	Color code (hex) for away alternate.
away_logo	character	Away team logo URL.
away_score	character	Away team's score. For cricket, the innings string.
away_winner	logical	Away team's winner.
away_rank	character

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtScoreboard({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_scoreboard(...)

espnNbaslUtStandings

NBASL_UT — standings (ESPN site.api.espn.com (v2)).

Endpoint URL: GET https://site.api.espn.com/apis/v2/sports/basketball/nba-summer-utah/standings

API param	JS	required	description
season	season	no	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
group	group	no	number | string — an ESPN group (conference / division) id
type	standings_type	no	number | string — the type ESPN query parameter
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_standings):

col_name	type	description
group_name	character
group_abbreviation	character
team_id	character	ESPN team id
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Team abbreviation
team_display_name	character	Team display name
team_location	character	Team city or location string.
team_logo	character	Team logo image URL.
avg_points_against	number
avg_points_for	number
clincher	integer	Clincher.
differential	integer	Differential.
division_win_percent	number
games_behind	integer
league_win_percent	number
losses	integer	Number of matches the team has lost.
playoff_seed	integer
point_differential	integer	Goal difference (for minus against).
points	integer	Competition points.
points_against	integer	Goals conceded.
points_for	integer	Goals (or runs) scored by the team.
streak	integer	Current streak (e.g. 'W3' for three-game win streak).
win_percent	number	Win percent.
wins	integer	Number of matches the team has won.
games_ahead	integer
overall	character	Overall record summary as published by ESPN.
home	character	Home.
road	character	Road.
vs_div	character
vs_conf	character
last_ten_games	character

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtStandings({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_standings(...)

espnNbaslUtStatisticsLeague

NBASL_UT — statistics league (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/statistics

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtStatisticsLeague({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_statistics_league(...)

espnNbaslUtSummary

NBASL_UT — summary (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/summary

API param	JS	required	description
event	event_id	no	number | string — the ESPN event (game) id
—	parsed	no	boolean — return tidy rows instead of raw JSON
—	section	no	with parsed, return one named sub-frame (e.g. boxscore, plays, winprobability) instead of all

Returns: raw ESPN Dict by default. With { parsed: true } the summary dispatcher returns an object of 21 sub-frames keyed by section ({ parsed: true, section: '<name>' } for one); see ESPN parsed returns.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtSummary({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_summary(...)

espnNbaslUtTeam

NBASL_UT — team (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league and payload, so no fixed table is published. This endpoint is exposed on 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeam({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team(...)

espnNbaslUtTeamDepthcharts

NBASL_UT — team depthcharts (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/depthcharts

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamDepthcharts({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_depthcharts(...)

espnNbaslUtTeamHistory

NBASL_UT — team history (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/history

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamHistory({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_history(...)

espnNbaslUtTeamInjuries

NBASL_UT — team injuries (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/injuries

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_injuries):

col_name	type	description
id	character	ESPN numeric identifier for the athlete.
display_name	character	Athlete's full display name as shown on ESPN.
injuries	character	Injury entries for the athlete (list of dicts, stringified): status, type, details, dates.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamInjuries({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_injuries(...)

espnNbaslUtTeamLeaders

NBASL_UT — team leaders (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/leaders

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamLeaders({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_leaders(...)

espnNbaslUtTeamNews

NBASL_UT — team news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/news

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
limit	limit	no	number | string — the maximum number of items to return; default 50
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_news):

col_name	type	description
id	integer	ESPN numeric identifier for the article.
now_id	character	ESPN 'now' feed id.
content_key	character	Internal content key.
data_source_identifier	character	Source-system identifier.
type	character	Article type (Story, Media, HeadlineNews, etc.).
headline	character	Article headline.
description	character	Article summary/description.
last_modified	character	Last-modified timestamp (ISO 8601).
published	character	Publish timestamp (ISO 8601).
images	character	Article images (list, stringified).
categories	character	Article categories (list, stringified).
premium	logical	Whether the article is premium/paywalled.
links_web_href	character	Web article URL.
links_mobile_href	character	Mobile article URL.
links_api_self_href	character	ESPN API canonical self-link for the article resource.
links_app_sportscenter_href	character	SportsCenter app deep link.
byline	character	Author byline string as published by ESPN.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamNews({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_news(...)

espnNbaslUtTeamRecord

NBASL_UT — team record (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/record

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamRecord({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_record(...)

espnNbaslUtTeamRoster

NBASL_UT — team roster (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/roster

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
limit	limit	no	number | string — the maximum number of items to return; default 500
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_team_roster):

col_name	type	description
id	character	Id.
uid	character	ESPN universal id for the athlete.
guid	character	Stable cross-league team GUID.
alternate_ids_sdr	character
first_name	character	Athlete's first (given) name.
last_name	character	Athlete's last (family) name.
full_name	character	Player's full name.
display_name	character	Athlete's full display name as shown on ESPN.
short_name	character	Athlete's abbreviated display name (e.g. 'L. James').
weight	integer	Athlete weight in pounds.
display_weight	character	Athlete weight, formatted for display.
height	integer	Athlete height in inches.
display_height	character	Athlete height, formatted for display.
age	integer	Athlete age in years.
date_of_birth	character	Athlete date of birth (ISO 8601).
debut_year	integer	Year of professional debut.
links	character
birth_place_city	character	Birth place city.
birth_place_country	character	Birth place country.
college_id	character	Unique identifier for college.
college_guid	character
college_mascot	character
college_name	character	College / pre-draft team.
college_short_name	character
college_abbrev	character
college_logos	character
slug	character	URL slug for the athlete.
headshot_href	character	Headshot image URL.
headshot_alt	character	Alternative-text label for the headshot.
jersey	character	Athlete's jersey number as a string.
position_id	character	Unique position identifier.
position_name	character	Full position name (e.g. 'Point Guard', 'Goalkeeper').
position_display_name	character	Position display name.
position_abbreviation	character	Position abbreviation ('G' / 'F' / 'C').
position_leaf	logical	Position leaf.
injuries	character
teams	character	Nested list of member-team membership spans.
contracts	character
experience_years	integer	Experience years.
contract_bird_status	integer	Contract bird status.
contract_base_year_compensation_active	logical	Contract base year compensation active.
contract_poison_pill_provision_active	logical
contract_incoming_trade_value	integer	Contract incoming trade value.
contract_outgoing_trade_value	integer	Contract outgoing trade value.
contract_minimum_salary_exception	logical	Contract minimum salary exception.
contract_option_type	integer	Contract option type.
contract_salary	integer	Contract salary.
contract_salary_remaining	integer	Contract salary remaining.
contract_years_remaining	integer	Contract years remaining.
contract_season_year	integer
contract_season_start_date	character
contract_season_end_date	character
contract_trade_kicker_active	logical	Contract trade kicker active.
contract_trade_kicker_percentage	integer	Contract trade kicker percentage (0-1 decimal).
contract_trade_kicker_value	integer	Contract trade kicker value.
contract_trade_kicker_trade_value	integer	Contract trade kicker trade value.
contract_trade_restriction	logical	Contract trade restriction.
contract_unsigned_foreign_pick	logical	Contract unsigned foreign pick.
contract_active	logical	Contract active.
status_id	character	Status identifier.
status_name	character	Status label.
status_type	character	Status type.
status_abbreviation	character	Status abbreviation.
citizenship	character	Athlete citizenship.
birth_place_state	character	Birth place state.
hand_type	character	Hand type.
hand_abbreviation	character	Hand abbreviation.
hand_display_value	character	Hand display value.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamRoster({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_roster(...)

espnNbaslUtTeamSchedule

NBASL_UT — team schedule (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/schedule

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
season	season	no	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_team_schedule); the column set varies by league and payload, so no fixed table is published. This endpoint is exposed on 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_team_schedule for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamSchedule({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_schedule(...)

espnNbaslUtTeamTransactions

NBASL_UT — team transactions (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams/{team_id}/transactions

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamTransactions({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_team_transactions(...)

espnNbaslUtTeamsSite

NBASL_UT — teams site (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/teams

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 1000
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_teams); the column set varies by league and payload, so no fixed table is published. This endpoint is exposed on 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_teams for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTeamsSite({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_teams_site(...)

espnNbaslUtTransactions

NBASL_UT — transactions (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-utah/transactions

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 500
—	parsed	no	boolean — return tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_items):

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.nbasl_ut.espnNbaslUtTransactions({});
// snake_case alias (py/R parity): sdv.nbasl_ut.espn_nbasl_ut_transactions(...)

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