Skip to contents

Era-correct team identity for an MLB 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/baseball/leagues/mlb/seasons/{season}/teams/{team_id}.

Historical depth goes back to 1947 (MLB founding). Older seasons return fewer $ref keys; missing refs become NA.

Usage

espn_mlb_team_season_profile(team_id, season = most_recent_mlb_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent MLB season.

...

Additional arguments; currently unused.

Value

A single-row tibble with team identity scalars and _ref URL columns. Selected columns:

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. "Yankees").
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 (MLB-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.

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_current_roster(), 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_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{
  espn_mlb_team_season_profile(team_id = "13", season = 2025)
#> ── ESPN MLB Team Season Profile from ESPN.com ─────── baseballr 2.0.0 ──
#>  Data updated: 2026-06-08 11:08:08 UTC
#> # A tibble: 1 × 35
#>   id    guid            uid   slug  location name  nickname abbreviation
#>   <chr> <chr>           <chr> <chr> <chr>    <chr> <lgl>    <chr>       
#> 1 13    4fa2cf46-09fc-… s:1~… texa… Texas    Rang… NA       TEX         
#> # ℹ 27 more variables: display_name <chr>, 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>, …
# }