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.
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(), ...)
A named list of data frames: Info, Record, NextEvent,
StandingSummary, Coaches.
Info
Columns as documented in the shared espn_mbb_team_info_schema table.
Record
| col_name | types | description |
| type | character | Record type / category. |
| summary | character | |
| stats | list |
NextEvent
| col_name | types | description |
| id | character | Id. |
| date | character | Date in YYYY-MM-DD format. |
| name | character | Display name. |
| short_name | character | Short display name. |
StandingSummary
| col_name | types | description |
| standing_summary | character |
Coaches
| col_name | types | description |
| id | character | Id. |
| first_name | character | Player's first name. |
| last_name | character | Player's last name. |
| experience | integer | Years of professional experience. |
A single tibble with one row per athlete.
Columns as documented in the shared espn_mbb_team_roster_schema table.
A single long-format tibble (one row per category-rank-athlete).
Columns as documented in the shared espn_mbb_team_leaders_schema table.
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. |
A named list of data frames: Info, Record, NextEvent,
StandingSummary, Coaches.
Info
Columns as documented in the shared espn_mbb_team_info_schema table.
Record
| col_name | types | description |
| type | character | Record type / category. |
| summary | character | |
| stats | list |
NextEvent
| col_name | types | description |
| id | character | Id. |
| date | character | Date in YYYY-MM-DD format. |
| name | character | Display name. |
| short_name | character | Short display name. |
StandingSummary
| col_name | types | description |
| standing_summary | character |
Coaches
| col_name | types | description |
| id | character | Id. |
| first_name | character | Player's first name. |
| last_name | character | Player's last name. |
| experience | integer | Years of professional experience. |
A single tibble with one row per athlete.
Columns as documented in the shared espn_mbb_team_roster_schema table.
A single long-format tibble (one row per category-rank-athlete).
Columns as documented in the shared espn_mbb_team_leaders_schema table.
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 | Team city/region (e.g. "Los Angeles"). |
| name | character | Team name (e.g. "Lakers"). |
| abbreviation | character | Short abbreviation (e.g. "LAL"). |
| 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 (if present). |
| statistics_ref | character | $ref to team statistics resource (if present). |
| leaders_ref | character | $ref to team leaders resource (if present). |
| coaches_ref | character | $ref to team coaches resource (if present). |
| depth_charts_ref | character | $ref to depth chart resource (NBA-only). |
| events_ref | character | $ref to team events resource (if present). |
| transactions_ref | character | $ref to team transactions resource (if present). |
| franchise_ref | character | $ref to franchise resource. |
ESPN team identifier (character or numeric).
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.
Saiem Gilani
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
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_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
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_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
# \donttest{
espn_mbb_team(team_id = "150", season = 2025)
# }
# \donttest{
espn_mbb_team_roster(team_id = "150", season = 2025)
# }
# \donttest{
espn_mbb_team_leaders(team_id = "150", season = 2025)
# }
# \donttest{
espn_mbb_team_season_profile(team_id = "150", season = 2025)
# }
# \donttest{
espn_nba_team(team_id = "13", season = 2025)
# }
# \donttest{
espn_nba_team_roster(team_id = "13", season = 2025)
# }
# \donttest{
espn_nba_team_leaders(team_id = "13", season = 2025)
# }
# \donttest{
espn_nba_team_season_profile(team_id = "13", season = 2025)
# }
Run the code above in your browser using DataLab