Skip to contents

Era-correct team identity for an NBA franchise in a specific season, plus the available $ref URLs for deeper resources (record, statistics, leaders, coaches, etc.). Backed by the core-v2 endpoint sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/teams/{team_id}.

Historical depth goes back to 1947 (NBA founding). Older seasons return fewer $ref keys; missing refs become NA.

Usage

espn_nba_team_season_profile(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent NBA season.

...

Additional arguments; currently unused.

Value

A single-row tibble with team identity scalars and _ref URL columns. Selected columns:

col_nametypesdescription
idcharacterESPN team identifier.
guidcharacterStable cross-league team GUID.
uidcharacterESPN UID string.
slugcharacterURL-safe identifier.
locationcharacterTeam city/region (e.g. "Los Angeles").
namecharacterTeam name (e.g. "Lakers").
abbreviationcharacterShort abbreviation (e.g. "LAL").
display_namecharacterFull display name.
short_display_namecharacterShort display name.
colorcharacterPrimary color (hex, no leading '#').
alternate_colorcharacterAlternate color (hex, no leading '#').
is_activelogicalWhether the team was active in this season.
seasonintegerSeason year.
logocharacterPrimary logo URL.
logo_darkcharacterDark-mode logo URL.
record_refcharacter$ref to team record resource (if present).
statistics_refcharacter$ref to team statistics resource (if present).
leaders_refcharacter$ref to team leaders resource (if present).
coaches_refcharacter$ref to team coaches resource (if present).
depth_charts_refcharacter$ref to depth chart resource (NBA-only).
events_refcharacter$ref to team events resource (if present).
transactions_refcharacter$ref to team transactions resource (if present).
franchise_refcharacter$ref to franchise resource.

See also

Other ESPN NBA Functions: espn_nba_athlete_awards(), espn_nba_athlete_career_stats(), espn_nba_athlete_contract(), espn_nba_athlete_contracts(), espn_nba_athlete_eventlog(), espn_nba_athlete_eventlog_v2(), espn_nba_athlete_gamelog(), espn_nba_athlete_info(), espn_nba_athlete_overview(), espn_nba_athlete_seasons(), espn_nba_athlete_splits(), espn_nba_athlete_statisticslog(), espn_nba_athlete_stats(), espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_event_broadcasts(), espn_nba_event_odds(), espn_nba_event_officials(), espn_nba_event_powerindex(), espn_nba_event_predictor(), espn_nba_event_probabilities(), espn_nba_event_propbets(), espn_nba_event_situation(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_rosters(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_box(), espn_nba_player_stats(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_roster(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Author

Saiem Gilani

Examples

# \donttest{
  espn_nba_team_season_profile(team_id = "13", season = 2025)
#> ── ESPN NBA Team Season Profile from ESPN.com ─────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-19 01:34:18 UTC
#> # A tibble: 1 × 35
#>   id    guid       uid   slug  location name  nickname abbreviation display_name
#>   <chr> <chr>      <chr> <chr> <chr>    <chr> <lgl>    <chr>        <chr>       
#> 1 13    2876e98b-… s:40… los-… Los Ang… Lake… NA       LAL          Los Angeles…
#> # ℹ 26 more variables: short_display_name <chr>, color <chr>,
#> #   alternate_color <chr>, is_active <lgl>, is_all_star <lgl>, season <int>,
#> #   logo <chr>, logo_dark <chr>, record_ref <chr>, venue_ref <chr>,
#> #   groups_ref <chr>, ranks_ref <chr>, statistics_ref <chr>, leaders_ref <chr>,
#> #   injuries_ref <chr>, notes_ref <chr>, against_the_spread_records_ref <chr>,
#> #   awards_ref <chr>, franchise_ref <chr>, depth_charts_ref <chr>,
#> #   events_ref <chr>, transactions_ref <chr>, coaches_ref <chr>, …
# }