Skip to contents

Get ESPN MLB current team roster

Usage

espn_mlb_team_current_roster(team_id)

Arguments

team_id

Either numeric or character (YYYY)

Value

A teams data frame

col_nametypesdescription
team_idintegerUnique ESPN team identifier.
team_uidcharacterESPN universal team identifier (UID).
team_slugcharacterURL-safe team identifier.
team_locationcharacterTeam city / location.
team_namecharacterTeam nickname (e.g. 'Yankees').
team_abbreviationcharacterShort team abbreviation (e.g. 'NYY').
team_display_namecharacterFull team display name (e.g. 'New York Yankees').
team_short_namecharacterTeam short name.
team_colorcharacterTeam primary color (hex, no leading '#').
team_alternate_colorcharacterTeam alternate color (hex).
team_is_activelogicalTeam is active.
franchise..refcharacterFranchise..ref.
franchise.idcharacterFranchise.id.
franchise.uidcharacterFranchise.uid.
franchise.slugcharacterFranchise.slug.
franchise.locationcharacterFranchise.location.
franchise.namecharacterFranchise.name.
franchise.abbreviationcharacterFranchise.abbreviation.
franchise.displayNamecharacterFranchise.displayName.
franchise.shortDisplayNamecharacterFranchise.shortDisplayName.
franchise.colorcharacterFranchise.color.
franchise.isActivelogicalFranchise.isActive.
franchise.venue..refcharacterFranchise.venue..ref.
franchise.venue.idcharacterFranchise.venue.id.
franchise.venue.fullNamecharacterFranchise.venue.fullName.
franchise.venue.shortNamecharacterFranchise.venue.shortName.
franchise.venue.address.citycharacterFranchise.venue.address.city.
franchise.venue.address.statecharacterFranchise.venue.address.state.
franchise.venue.address.zipCodecharacterFranchise.venue.address.zipCode.
franchise.venue.grasslogicalFranchise.venue.grass.
franchise.venue.indoorlogicalFranchise.venue.indoor.
franchise.venue.images.hrefcharacterFranchise.venue.images.href.
franchise.venue.images.widthintegerFranchise.venue.images.width.
franchise.venue.images.heightintegerFranchise.venue.images.height.
franchise.venue.images.altcharacterFranchise.venue.images.alt.
franchise.venue.images.rellistFranchise.venue.images.rel.
franchise..ref.1characterFranchise..ref.1.
franchise..ref.2characterFranchise..ref.2.
standingSummarycharacterStandingSummary.
logocharacterLogo image URL.
logo_darkcharacterDark-mode logo image URL.
group_idintegerGroup id.
parent_group_idintegerParent group id.
group_is_conferencelogicalGroup is conference.
conference_idintegerConference id.
athlete_idintegerUnique ESPN athlete identifier.
athlete_uidcharacterAthlete uid.
athlete_guidcharacterAthlete guid.
athlete_typecharacterAthlete type.
athlete_first_namecharacterAthlete first name.
athlete_last_namecharacterAthlete last name.
athlete_full_namecharacterAthlete full name.
athlete_display_namecharacterAthlete display name (full).
athlete_short_namecharacterAthlete short display name.
athlete_weightintegerAthlete weight.
athlete_display_weightcharacterAthlete display weight.
athlete_heightintegerAthlete height.
athlete_display_heightcharacterAthlete display height.
athlete_ageintegerAthlete age.
athlete_date_of_birthcharacterAthlete date of birth.
athlete_slugcharacterAthlete slug.
athlete_jerseycharacterAthlete jersey.
athlete_linkedlogicalAthlete linked.
athlete_activelogicalAthlete active.
athlete_positionslistAthlete positions.
athlete_hot_zoneslistAthlete hot zones.
athlete_debut_yearintegerAthlete debut year.
athlete_nicknamecharacterAthlete nickname.
athlete_middle_namecharacterAthlete middle name.
athlete_citizenshipcharacterAthlete citizenship.
athlete_alternate_ids_sdrcharacterAthlete alternate ids sdr.
athlete_birth_place_citycharacterAthlete birth place city.
athlete_birth_place_statecharacterAthlete birth place state.
athlete_birth_place_countrycharacterAthlete birth place country.
athlete_position_idcharacterAthlete position id.
athlete_position_namecharacterAthlete fielding position (e.g. 'Shortstop', 'Pitcher').
athlete_position_display_namecharacterAthlete position display name.
athlete_position_abbreviationcharacterPosition abbreviation (e.g. 'SS', 'P').
athlete_position_leaflogicalAthlete position leaf.
athlete_experience_yearsintegerAthlete experience years.
athlete_debut_year_2integerAthlete debut year 2.
athlete_status_idcharacterAthlete status id.
athlete_status_namecharacterAthlete status name.
athlete_status_typecharacterAthlete status type.
athlete_status_abbreviationcharacterAthlete status abbreviation.
athlete_bats_typecharacterAthlete bats type.
athlete_bats_abbreviationcharacterAthlete bats abbreviation.
athlete_bats_display_valuecharacterAthlete bats display value.
athlete_throws_typecharacterAthlete throws type.
athlete_throws_abbreviationcharacterAthlete throws abbreviation.
athlete_throws_display_valuecharacterAthlete throws display value.
athlete_headshot_hrefcharacterAthlete headshot href.
athlete_draft_display_textcharacterAthlete draft display text.
athlete_draft_roundintegerAthlete draft round.
athlete_draft_yearintegerAthlete draft year.
athlete_draft_selectionintegerAthlete draft selection.

See also

Other ESPN MLB Functions: espn_mlb, espn_mlb_athletes_index(), espn_mlb_award(), espn_mlb_betting(), espn_mlb_calendar(), espn_mlb_coach(), espn_mlb_coach_record(), espn_mlb_coach_season(), espn_mlb_coaches(), espn_mlb_conferences(), espn_mlb_draft(), espn_mlb_draft_athlete_detail(), espn_mlb_draft_athletes(), espn_mlb_draft_pick(), espn_mlb_draft_rounds(), espn_mlb_draft_status(), espn_mlb_franchise(), espn_mlb_franchises(), espn_mlb_freeagents(), espn_mlb_futures(), espn_mlb_game_all(), espn_mlb_game_broadcasts(), espn_mlb_game_endpoints, espn_mlb_game_info(), espn_mlb_game_odds(), espn_mlb_game_official_detail(), espn_mlb_game_officials(), espn_mlb_game_play(), espn_mlb_game_play_personnel(), espn_mlb_game_player_box(), espn_mlb_game_powerindex(), espn_mlb_game_predictor(), espn_mlb_game_probabilities(), espn_mlb_game_probables(), espn_mlb_game_propbets(), espn_mlb_game_rosters(), espn_mlb_game_situation(), espn_mlb_game_team_leaders(), espn_mlb_game_team_linescores(), espn_mlb_game_team_records(), espn_mlb_game_team_roster(), espn_mlb_game_team_roster_entry(), espn_mlb_game_team_score(), espn_mlb_game_team_statistics(), espn_mlb_injuries(), espn_mlb_leaders(), espn_mlb_news(), espn_mlb_pbp(), espn_mlb_player_awards(), espn_mlb_player_box(), espn_mlb_player_career_stats(), espn_mlb_player_contract(), espn_mlb_player_contracts(), espn_mlb_player_endpoints, espn_mlb_player_eventlog(), espn_mlb_player_eventlog_v2(), espn_mlb_player_gamelog(), espn_mlb_player_info(), espn_mlb_player_overview(), espn_mlb_player_seasons(), espn_mlb_player_splits(), espn_mlb_player_statisticslog(), espn_mlb_player_stats(), espn_mlb_player_stats_v3(), espn_mlb_position(), espn_mlb_positions(), espn_mlb_powerindex(), espn_mlb_scoreboard(), espn_mlb_season_awards(), espn_mlb_season_draft(), espn_mlb_season_group(), espn_mlb_season_group_children(), espn_mlb_season_group_teams(), espn_mlb_season_groups(), espn_mlb_season_info(), espn_mlb_season_leaders(), espn_mlb_season_ranking(), espn_mlb_season_rankings(), espn_mlb_season_type(), espn_mlb_season_types(), espn_mlb_season_week(), espn_mlb_season_weeks(), espn_mlb_seasons(), espn_mlb_standings(), espn_mlb_team(), espn_mlb_team_box(), espn_mlb_team_depthchart(), espn_mlb_team_endpoints, espn_mlb_team_injuries(), espn_mlb_team_leaders(), espn_mlb_team_news(), espn_mlb_team_odds_records(), espn_mlb_team_record(), espn_mlb_team_record_detail(), espn_mlb_team_roster(), espn_mlb_team_schedule(), espn_mlb_team_season_profile(), espn_mlb_team_season_roster(), espn_mlb_team_season_statistics(), espn_mlb_team_stats(), espn_mlb_teams(), espn_mlb_tournament(), espn_mlb_tournament_season(), espn_mlb_tournament_seasons(), espn_mlb_tournaments(), espn_mlb_transactions(), espn_mlb_venues(), espn_mlb_week_ranking(), espn_mlb_week_rankings(), espn_mlb_wp()

Author

Saiem Gilani

Examples

# \donttest{
try(espn_mlb_team_current_roster(team_id = 13))
#> ── ESPN MLB Team Current Roster Information from ESPN.com ──────────────
#>  Data updated: 2026-06-08 11:08:04 UTC
#> # A tibble: 283 × 96
#>    team_id team_uid  team_slug team_location team_name team_abbreviation
#>      <int> <chr>     <chr>     <chr>         <chr>     <chr>            
#>  1      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#>  2      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#>  3      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#>  4      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#>  5      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#>  6      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#>  7      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#>  8      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#>  9      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#> 10      13 s:1~l:10… texas-ra… Texas         Rangers   TEX              
#> # ℹ 273 more rows
#> # ℹ 90 more variables: team_display_name <chr>, team_short_name <chr>,
#> #   team_color <chr>, team_alternate_color <chr>, team_is_active <lgl>,
#> #   franchise..ref <chr>, franchise.id <chr>, franchise.uid <chr>,
#> #   franchise.slug <chr>, franchise.location <chr>,
#> #   franchise.name <chr>, franchise.abbreviation <chr>,
#> #   franchise.displayName <chr>, franchise.shortDisplayName <chr>, …
# }