Get ESPN NBA Team Roster (Per-Season, core-v2)
Source:R/espn_nba_team_deep.R
espn_nba_team_season_roster.RdReturns the per-season team roster as a tibble of athlete IDs from
seasons/{y}/teams/{id}/athletes. Distinct from espn_nba_team_roster()
which targets a site-v2 endpoint optimized for the current season; this
core-v2 variant is era-correct and available back to ESPN's earliest
season for each league.
Usage
espn_nba_team_season_roster(team_id, season = most_recent_nba_season(), ...)Value
A tibble with one row per athlete on the season roster.
| col_name | types | description |
| league | character | League slug. |
| team_id | character | ESPN team id. |
| season | integer | Season year. |
| athlete_id | character | ESPN athlete id. |
| ref | character | $ref URL to athlete-in-season detail. |
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_franchise(),
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_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_team_season_roster(team_id = 13, season = 2025)
#> ── ESPN NBA Team Season Roster ────────────────────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-05-19 01:34:18 UTC
#> # A tibble: 17 × 5
#> league team_id season athlete_id ref
#> <chr> <chr> <int> <chr> <chr>
#> 1 nba 13 2025 4278129 http://sports.core.api.espn.com/v2/sports/b…
#> 2 nba 13 2025 3945274 http://sports.core.api.espn.com/v2/sports/b…
#> 3 nba 13 2025 4066648 http://sports.core.api.espn.com/v2/sports/b…
#> 4 nba 13 2025 4397077 http://sports.core.api.espn.com/v2/sports/b…
#> 5 nba 13 2025 4683774 http://sports.core.api.espn.com/v2/sports/b…
#> 6 nba 13 2025 1966 http://sports.core.api.espn.com/v2/sports/b…
#> 7 nba 13 2025 3913174 http://sports.core.api.espn.com/v2/sports/b…
#> 8 nba 13 2025 2960236 http://sports.core.api.espn.com/v2/sports/b…
#> 9 nba 13 2025 4897943 http://sports.core.api.espn.com/v2/sports/b…
#> 10 nba 13 2025 4592691 http://sports.core.api.espn.com/v2/sports/b…
#> 11 nba 13 2025 4702972 http://sports.core.api.espn.com/v2/sports/b…
#> 12 nba 13 2025 4066457 http://sports.core.api.espn.com/v2/sports/b…
#> 13 nba 13 2025 2990992 http://sports.core.api.espn.com/v2/sports/b…
#> 14 nba 13 2025 4683686 http://sports.core.api.espn.com/v2/sports/b…
#> 15 nba 13 2025 5060631 http://sports.core.api.espn.com/v2/sports/b…
#> 16 nba 13 2025 4431695 http://sports.core.api.espn.com/v2/sports/b…
#> 17 nba 13 2025 4278077 http://sports.core.api.espn.com/v2/sports/b…
# }