Get ESPN MBB Team Record (Per Season Type)
Source:R/espn_mbb_team_record.R, R/espn_nba_team_record.R
espn_mbb_team_record.RdReturns the long-format record breakdown for an MBB team in one season and season-type. Each row is one record category.
Returns the long-format record breakdown for an NBA team in one season
and season-type. Each row is one record type (Overall, Home, Road,
vs Conference, vs Division, etc.). Backed by
sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/types/{season_type}/teams/{team_id}/record.
Usage
espn_mbb_team_record(
team_id,
season = most_recent_mbb_season(),
season_type = c(2L, 3L),
...
)
espn_nba_team_record(
team_id,
season = most_recent_nba_season(),
season_type = c(2L, 3L),
...
)Value
A tibble with one row per record category. See espn_nba_team_record()
for the full column schema.
A tibble with one row per record category.
| col_name | types | description |
| league | character | League slug ("nba"). |
| team_id | character | ESPN team identifier. |
| season | integer | Season year. |
| season_type | integer | Season type (1/2/3). |
| record_id | character | Record sub-id. |
| name | character | Internal record name (e.g. "overall"). |
| abbreviation | character | Abbreviation (e.g. "Total"). |
| display_name | character | Display name (e.g. "Overall"). |
| short_display_name | character | Short display (e.g. "OVER"). |
| description | character | Description (e.g. "Overall Record"). |
| type | character | Record type code (total, home, ...). |
| summary | character | W-L summary (e.g. "50-32"). |
| display_value | character | Same as summary in most cases. |
| value | numeric | Win percentage (0-1). |
See also
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(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
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(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
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()
Examples
# \donttest{
espn_mbb_team_record(team_id = 150, season = 2025)
#> ── ESPN MENS-COLLEGE-BASKETBALL Team Record ───────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-08-27 17:47:36 UTC
#> # A tibble: 12 × 14
#> league team_id season season_type record_id name abbreviation display_name
#> <chr> <chr> <int> <int> <chr> <chr> <chr> <chr>
#> 1 mens-co… 150 2025 2 0 over… Season Team Season…
#> 2 mens-co… 150 2025 2 2 Home Home Home
#> 3 mens-co… 150 2025 2 3 Road AWAY Away
#> 4 mens-co… 150 2025 2 4 vs A… VS AP NA
#> 5 mens-co… 150 2025 2 6 vs U… VS USA NA
#> 6 mens-co… 150 2025 2 9 vs. … VS CONF CONF
#> 7 mens-co… 150 2025 3 0 over… Season Team Season…
#> 8 mens-co… 150 2025 3 2 Home Home Home
#> 9 mens-co… 150 2025 3 3 Road AWAY Away
#> 10 mens-co… 150 2025 3 4 vs A… VS AP NA
#> 11 mens-co… 150 2025 3 6 vs U… VS USA NA
#> 12 mens-co… 150 2025 3 9 vs. … VS CONF CONF
#> # ℹ 6 more variables: short_display_name <chr>, description <chr>, type <chr>,
#> # summary <chr>, display_value <chr>, value <dbl>
# }
# \donttest{
espn_nba_team_record(team_id = 13, season = 2025)
#> ── ESPN NBA Team Record ───────────────────────────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-08-27 17:47:37 UTC
#> # A tibble: 12 × 14
#> league team_id season season_type record_id name abbreviation display_name
#> <chr> <chr> <int> <int> <chr> <chr> <chr> <chr>
#> 1 nba 13 2025 2 0 overall Total Overall
#> 2 nba 13 2025 2 33 Home NA Home
#> 3 nba 13 2025 2 34 Road NA Road
#> 4 nba 13 2025 2 60 vs. Di… NA DIV
#> 5 nba 13 2025 2 61 vs. Co… NA CONF
#> 6 nba 13 2025 2 901 Last T… L10 Last Ten Ga…
#> 7 nba 13 2025 3 0 overall Total Overall
#> 8 nba 13 2025 3 33 Home NA Home
#> 9 nba 13 2025 3 34 Road NA Road
#> 10 nba 13 2025 3 60 vs. Di… NA DIV
#> 11 nba 13 2025 3 61 vs. Co… NA CONF
#> 12 nba 13 2025 3 901 Last T… L10 Last Ten Ga…
#> # ℹ 6 more variables: short_display_name <chr>, description <chr>, type <chr>,
#> # summary <chr>, display_value <chr>, value <dbl>
# }