Skip to contents

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.

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_mbb_team(team_id, season = most_recent_mbb_season(), ...)

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

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

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

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

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

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

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, e.g. 2025). Defaults to the most recent MBB season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A named list of hoopR_data tibbles: Info, Record, NextEvent, StandingSummary, Coaches.

Info

col_nametypesdescription
idcharacterId.
uidcharacterESPN UID string (universal identifier).
slugcharacterURL-safe identifier.
abbreviationcharacterShort abbreviation.
display_namecharacterDisplay name.
short_display_namecharacterShort display name.
namecharacterDisplay name.
nicknamecharacterTeam or athlete nickname.
locationcharacterLocation.
colorcharacterPrimary color (hex without leading '#').
alternate_colorcharacterAlternate color (hex without leading '#').
logocharacterTeam or league logo URL.

Record

col_nametypesdescription
typecharacterRecord type / category.
summarycharacter
statslist

NextEvent

col_nametypesdescription
idcharacterId.
datecharacterDate in YYYY-MM-DD format.
namecharacterDisplay name.
short_namecharacterShort display name.

StandingSummary

col_nametypesdescription
standing_summarycharacter

Coaches

col_nametypesdescription
idcharacterId.
first_namecharacterPlayer's first name.
last_namecharacterPlayer's last name.
experienceintegerYears of professional experience.

A hoopR_data tibble with one row per athlete.

col_nametypesdescription
athlete_idcharacterUnique athlete identifier (ESPN).
full_namecharacterPlayer's full name.
jerseycharacterJersey number worn by the player.
position_abbrevcharacter
position_namecharacterListed roster position ('Guard', 'Forward', 'Center').
heightcharacterPlayer height (string e.g. '6-2' or inches).
weightcharacterPlayer weight in pounds.
agecharacterPlayer age (in years).
birth_datecharacterDate of birth (YYYY-MM-DD).
birth_placecharacterPlace of birth.
headshotcharacterHeadshot image URL.
link_webcharacterWeb link / URL.
statuscharacterStatus label.
team_idcharacterUnique team identifier.
seasonintegerSeason identifier (4-digit year or 'YYYY-YY' string).

ESPN's roster endpoint ignores the season, so a season before the current one is built from that season's published player box scores (name, jersey, position and headshot from the athlete's last game; bio columns NA), and errors when none are published.

A hoopR_data tibble with one row per category-rank-athlete.

col_nametypesdescription
team_idcharacterUnique team identifier.
seasonintegerSeason identifier (4-digit year or 'YYYY-YY' string).
categorycharacterCategory label.
display_namecharacterDisplay name.
athlete_idcharacterUnique athlete identifier (ESPN).
athlete_namecharacterAthlete display name (ESPN).
valuenumericNumeric or string value field.
rankintegerRank.

A hoopR_data tibble with one row per team-season.

col_nametypesdescription
idcharacterESPN team identifier.
guidcharacterStable cross-league team GUID.
uidcharacterESPN UID string.
slugcharacterURL-safe identifier.
locationcharacterSchool/program location (e.g. "Duke").
namecharacterTeam name (e.g. "Blue Devils").
nicknamecharacterCommon nickname (often same as location).
abbreviationcharacterShort abbreviation (e.g. "DUKE").
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.
statistics_refcharacter$ref to team statistics resource.
athletes_refcharacter$ref to team roster resource (college-only).
college_refcharacter$ref to college (institution) resource.
coaches_refcharacter$ref to team coaches resource.
franchise_refcharacter$ref to franchise resource.

The table lists selected columns: team identity scalars and _ref URL columns.

A named list of hoopR_data tibbles: Info, Record, NextEvent, StandingSummary, Coaches.

Info

col_nametypesdescription
idcharacterId.
uidcharacterESPN UID string (universal identifier).
slugcharacterURL-safe identifier.
abbreviationcharacterShort abbreviation.
display_namecharacterDisplay name.
short_display_namecharacterShort display name.
namecharacterDisplay name.
nicknamecharacterTeam or athlete nickname.
locationcharacterLocation.
colorcharacterPrimary color (hex without leading '#').
alternate_colorcharacterAlternate color (hex without leading '#').
logocharacterTeam or league logo URL.

Record

col_nametypesdescription
typecharacterRecord type / category.
summarycharacter
statslist

NextEvent

col_nametypesdescription
idcharacterId.
datecharacterDate in YYYY-MM-DD format.
namecharacterDisplay name.
short_namecharacterShort display name.

StandingSummary

col_nametypesdescription
standing_summarycharacter

Coaches

col_nametypesdescription
idcharacterId.
first_namecharacterPlayer's first name.
last_namecharacterPlayer's last name.
experienceintegerYears of professional experience.

A hoopR_data tibble with one row per athlete.

col_nametypesdescription
athlete_idcharacterUnique athlete identifier (ESPN).
full_namecharacterPlayer's full name.
jerseycharacterJersey number worn by the player.
position_abbrevcharacter
position_namecharacterListed roster position ('Guard', 'Forward', 'Center').
heightcharacterPlayer height (string e.g. '6-2' or inches).
weightcharacterPlayer weight in pounds.
agecharacterPlayer age (in years).
birth_datecharacterDate of birth (YYYY-MM-DD).
birth_placecharacterPlace of birth.
headshotcharacterHeadshot image URL.
link_webcharacterWeb link / URL.
statuscharacterStatus label.
team_idcharacterUnique team identifier.
seasonintegerSeason identifier (4-digit year or 'YYYY-YY' string).

ESPN's roster endpoint ignores the season, so a season before the current one is built from that season's published player box scores (name, jersey, position and headshot from the athlete's last game; bio columns NA), and errors when none are published.

A hoopR_data tibble with one row per category-rank-athlete.

col_nametypesdescription
team_idcharacterUnique team identifier.
seasonintegerSeason identifier (4-digit year or 'YYYY-YY' string).
categorycharacterCategory label.
display_namecharacterDisplay name.
athlete_idcharacterUnique athlete identifier (ESPN).
athlete_namecharacterAthlete display name (ESPN).
valuenumericNumeric or string value field.
rankintegerRank.

A hoopR_data tibble with one row per team-season.

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.

The table lists selected columns: team identity scalars and _ref URL columns.

See also

family_espn_mbb lists every function in this family.

family_espn_nba lists every function in this family.

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_team(team_id = "150", season = 2025)
#> $Info
#> ── ESPN MENS-COLLEGE-BASKETBALL Team Info from ESPN.com ───────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:36 UTC
#> # A tibble: 1 × 13
#>   id    uid    slug  abbreviation display_name short_display_name name  nickname
#>   <chr> <chr>  <chr> <chr>        <chr>        <chr>              <chr> <chr>   
#> 1 150   s:40~… duke… DUKE         Duke Blue D… Duke               Blue… Duke    
#> # ℹ 5 more variables: location <chr>, color <chr>, alternate_color <chr>,
#> #   logo <chr>, logo_dark <chr>
#> 
#> $Record
#> ── ESPN MENS-COLLEGE-BASKETBALL Team Record from ESPN.com ─────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:36 UTC
#> # A tibble: 1 × 4
#>   description    stats         summary type 
#>   <chr>          <list>        <chr>   <chr>
#> 1 Overall Record <df [30 × 2]> 31-3    total
#> 
#> $NextEvent
#> data frame with 0 columns and 0 rows
#> 
#> $StandingSummary
#> ── ESPN MENS-COLLEGE-BASKETBALL Team Standing Summary from ESPN.com ────────────
#> ℹ Data updated: 2026-11-13 21:12:36 UTC
#> # A tibble: 1 × 1
#>   standing_summary
#>   <chr>           
#> 1 1st in ACC      
#> 
#> $Coaches
#> data frame with 0 columns and 0 rows
#> 
# }
# \donttest{
  espn_mbb_team_roster(team_id = "150", season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Team Roster from ESPN.com player box scores ────
#> ℹ Data updated: 2026-11-13 21:12:39 UTC
#> # A tibble: 15 × 15
#>    athlete_id full_name jersey position_abbrev position_name height weight age  
#>    <chr>      <chr>     <chr>  <chr>           <chr>         <chr>  <chr>  <chr>
#>  1 4431753    Mason Gi… 18     F               Forward       NA     NA     NA   
#>  2 4431890    Neal Beg… 20     F               Forward       NA     NA     NA   
#>  3 4432321    Cameron … 13     G               Guard         NA     NA     NA   
#>  4 4602025    Sion Jam… 14     G               Guard         NA     NA     NA   
#>  5 4711256    Caleb Fo… 1      G               Guard         NA     NA     NA   
#>  6 4873107    Darren H… 8      G               Guard         NA     NA     NA   
#>  7 4873209    Patrick … 21     C               Center        NA     NA     NA   
#>  8 4897107    Stanley … 52     C               Center        NA     NA     NA   
#>  9 4897108    Spencer … 55     G               Guard         NA     NA     NA   
#> 10 5023693    Tyrese P… 5      G               Guard         NA     NA     NA   
#> 11 5041939    Cooper F… 2      F               Forward       NA     NA     NA   
#> 12 5061575    Kon Knue… 7      G               Guard         NA     NA     NA   
#> 13 5061585    Isaiah E… 3      G               Guard         NA     NA     NA   
#> 14 5105337    Maliq Br… 6      F               Forward       NA     NA     NA   
#> 15 5203685    Khaman M… 9      C               Center        NA     NA     NA   
#> # ℹ 7 more variables: birth_date <chr>, birth_place <chr>, headshot <chr>,
#> #   link_web <chr>, status <chr>, team_id <chr>, season <int>
# }
# \donttest{
  espn_mbb_team_leaders(team_id = "150", season = 2025)
#> # A tibble: 0 × 0
# }
# \donttest{
  espn_mbb_team_season_profile(team_id = "150", season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Team Season Profile from ESPN.com ──────────────
#> ℹ Data updated: 2026-11-13 21:12:39 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>, …
# }
# \donttest{
  espn_nba_team(team_id = "13", season = 2025)
#> $Info
#> ── ESPN NBA Team Info from ESPN.com ───────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:39 UTC
#> # A tibble: 1 × 12
#>   id    uid    slug  abbreviation display_name short_display_name name  location
#>   <chr> <chr>  <chr> <chr>        <chr>        <chr>              <chr> <chr>   
#> 1 13    s:40~… los-… LAL          Los Angeles… Lakers             Lake… Los Ang…
#> # ℹ 4 more variables: color <chr>, alternate_color <chr>, logo <chr>,
#> #   logo_dark <chr>
#> 
#> $Record
#> ── ESPN NBA Team Record from ESPN.com ─────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:39 UTC
#> # A tibble: 3 × 4
#>   description    stats         summary type 
#>   <chr>          <list>        <chr>   <chr>
#> 1 Overall Record <df [20 × 2]> 50-32   total
#> 2 Home Record    <df [5 × 2]>  31-10   home 
#> 3 Away Record    <df [5 × 2]>  19-22   road 
#> 
#> $NextEvent
#> data frame with 0 columns and 0 rows
#> 
#> $StandingSummary
#> ── ESPN NBA Team Standing Summary from ESPN.com ───────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:39 UTC
#> # A tibble: 1 × 1
#>   standing_summary       
#>   <chr>                  
#> 1 1st in Pacific Division
#> 
#> $Coaches
#> data frame with 0 columns and 0 rows
#> 
# }
# \donttest{
  espn_nba_team_roster(team_id = "13", season = 2025)
#> ── ESPN NBA Team Roster from ESPN.com player box scores ───────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:40 UTC
#> # A tibble: 26 × 15
#>    athlete_id full_name jersey position_abbrev position_name height weight age  
#>    <chr>      <chr>     <chr>  <chr>           <chr>         <chr>  <chr>  <chr>
#>  1 1966       LeBron J… 23     F               Forward       NA     NA     NA   
#>  2 6461       Markieff… 88     PF              Power Forward NA     NA     NA   
#>  3 6583       Anthony … 3      F               Forward       NA     NA     NA   
#>  4 2578185    Dorian F… 17     F               Forward       NA     NA     NA   
#>  5 2596107    Alex Len  27     C               Center        NA     NA     NA   
#>  6 2960236    Maxi Kle… 14     F               Forward       NA     NA     NA   
#>  7 3058254    Christia… 35     F               Forward       NA     NA     NA   
#>  8 3136776    D'Angelo… 1      G               Guard         NA     NA     NA   
#>  9 3137259    Gabe Vin… 7      G               Guard         NA     NA     NA   
#> 10 3915195    Shake Mi… 20     SG              Shooting Gua… NA     NA     NA   
#> # ℹ 16 more rows
#> # ℹ 7 more variables: birth_date <chr>, birth_place <chr>, headshot <chr>,
#> #   link_web <chr>, status <chr>, team_id <chr>, season <int>
# }
# \donttest{
  espn_nba_team_leaders(team_id = "13", season = 2025)
#> # A tibble: 0 × 0
# }
# \donttest{
  espn_nba_team_season_profile(team_id = "13", season = 2025)
#> ── ESPN NBA Team Season Profile from ESPN.com ─────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:12:40 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>, …
# }