Returns franchise-level metadata for an NBA franchise. Franchise IDs are stable across relocations and rebrands — useful for tracking franchise history independent of current team identity.
Value
A single-row tibble.
| col_name | types | description |
| id | character | ESPN franchise identifier. |
| uid | character | ESPN UID string. |
| slug | character | URL-safe identifier. |
| location | character | Franchise location. |
| name | character | Franchise name. |
| nickname | character | Common nickname (often same as name). |
| abbreviation | character | Short abbreviation. |
| display_name | character | Full display name. |
| short_display_name | character | Short display name. |
| color | character | Primary color (hex, no leading '#'). |
| is_active | logical | Whether franchise is currently active. |
| league | character | League slug ("nba"). |
| logo | character | Primary logo URL. |
| logo_dark | character | Dark-mode logo URL. |
| venue_ref | character | $ref to franchise's primary venue. |
| team_ref | character | $ref to the current team for franchise. |
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_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_profile(),
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()
Examples
# \donttest{
espn_nba_franchise(franchise_id = 13)
#> ── ESPN NBA Franchise from ESPN.com ───────────────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-05-19 01:33:51 UTC
#> # A tibble: 1 × 16
#> id uid slug location name nickname abbreviation display_name
#> <chr> <chr> <chr> <chr> <chr> <lgl> <chr> <chr>
#> 1 13 s:40~l:46~f:13 los-an… Los Ang… Lake… NA LAL Los Angeles…
#> # ℹ 8 more variables: short_display_name <chr>, color <chr>, is_active <lgl>,
#> # league <chr>, logo <chr>, logo_dark <chr>, venue_ref <chr>, team_ref <chr>
# }