Get ESPN MBB Team-in-Season Profile

Era-correct team identity for a men's college basketball program in a specific season, plus the available $ref URLs for deeper resources (record, statistics, leaders, athletes/roster, coaches, college, etc.). Backed by the core-v2 endpoint sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/seasons/{season}/teams/{team_id}.

Historical depth goes back to 1939 at ESPN. Older seasons return fewer $ref keys; missing refs become NA.

Usage

espn_mbb_team_season_profile(team_id, season = most_recent_mbb_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).

season

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

...

Additional arguments; currently unused.

Value

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

col_name	types	description
id	character	ESPN team identifier.
guid	character	Stable cross-league team GUID.
uid	character	ESPN UID string.
slug	character	URL-safe identifier.
location	character	School/program location (e.g. "Duke").
name	character	Team name (e.g. "Blue Devils").
nickname	character	Common nickname (often same as location).
abbreviation	character	Short abbreviation (e.g. "DUKE").
display_name	character	Full display name.
short_display_name	character	Short display name.
color	character	Primary color (hex, no leading '#').
alternate_color	character	Alternate color (hex, no leading '#').
is_active	logical	Whether the team was active in this season.
season	integer	Season year.
logo	character	Primary logo URL.
logo_dark	character	Dark-mode logo URL.
record_ref	character	$ref to team record resource.
statistics_ref	character	$ref to team statistics resource.
athletes_ref	character	$ref to team roster resource (college-only).
college_ref	character	$ref to college (institution) resource.
coaches_ref	character	$ref to team coaches resource.
franchise_ref	character	$ref to franchise resource.

See also

Other ESPN MBB Functions: espn_mbb_athlete_awards(), espn_mbb_athlete_career_stats(), espn_mbb_athlete_eventlog(), espn_mbb_athlete_eventlog_v2(), espn_mbb_athlete_gamelog(), espn_mbb_athlete_info(), espn_mbb_athlete_overview(), espn_mbb_athlete_seasons(), espn_mbb_athlete_splits(), espn_mbb_athlete_statisticslog(), espn_mbb_athlete_stats(), espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_event_broadcasts(), espn_mbb_event_odds(), espn_mbb_event_officials(), espn_mbb_event_powerindex(), espn_mbb_event_predictor(), espn_mbb_event_probabilities(), espn_mbb_event_propbets(), espn_mbb_event_situation(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_rosters(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_box(), espn_mbb_player_stats(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_roster(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_team_season_profile(team_id = "150", season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Team Season Profile from ESPN.com ──────────────
#> ℹ Data updated: 2026-05-19 01:33:32 UTC
#> # A tibble: 1 × 35
#>   id    guid       uid   slug  location name  nickname abbreviation display_name
#>   <chr> <chr>      <chr> <chr> <chr>    <chr> <chr>    <chr>        <chr>       
#> 1 150   c4430c6c-… s:40… duke… Duke     Blue… Duke     DUKE         Duke Blue D…
#> # ℹ 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>, …
# }