Returns the long-format record breakdown for an MLB 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/baseball/leagues/mlb/seasons/{season}/types/{season_type}/teams/{team_id}/record.
Usage
espn_mlb_team_record(
team_id,
season = most_recent_mlb_season(),
season_type = c(2L, 3L),
...
)Value
A tibble with one row per record category.
| col_name | types | description |
| league | character | League slug ("mlb"). |
| 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 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_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()
Examples
# \donttest{
espn_mlb_team_record(team_id = 13, season = 2025)
#> ── ESPN MLB Team Record ───────────────────────────── baseballr 2.0.0 ──
#> ℹ Data updated: 2026-06-08 11:08:07 UTC
#> # A tibble: 8 × 14
#> league team_id season season_type record_id name abbreviation
#> <chr> <chr> <int> <int> <chr> <chr> <chr>
#> 1 mlb 13 2025 2 0 overall Total
#> 2 mlb 13 2025 2 33 Home Home
#> 3 mlb 13 2025 2 34 Road AWAY
#> 4 mlb 13 2025 2 614 Last Ten Gam… Last Ten
#> 5 mlb 13 2025 3 0 overall Total
#> 6 mlb 13 2025 3 33 Home Home
#> 7 mlb 13 2025 3 34 Road AWAY
#> 8 mlb 13 2025 3 614 Last Ten Gam… Last Ten
#> # ℹ 7 more variables: display_name <chr>, short_display_name <chr>,
#> # description <chr>, type <chr>, summary <chr>, display_value <chr>,
#> # value <dbl>
# }