Skip to contents

Get ESPN MLB Free Agents

Get ESPN MLB Free Agents

Usage

espn_mlb_freeagents(season = most_recent_mlb_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent MLB season.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(baseballr.proxy = ...).

Value

A baseballr_data tibble with one row per free agent:

col_nametypesdescription
seasonintegerSeason identifier (4-digit year or 'YYYY-YY' string).
athlete_idcharacterUnique athlete identifier (ESPN).
athlete_namecharacterAthlete display name (ESPN).
positioncharacterListed roster position (G, F, C, etc.).
prior_team_idcharacter
statuscharacterStatus label.
signed_team_idcharacter
signed_datecharacter
contract_valuecharacter
contract_term_yearscharacter

Details

Calls the ESPN core-v2 endpoint https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/seasons/{year}/freeagents. As of 2026-05, this endpoint returns HTTP 500 for every season tested and there is no documented replacement; the function consequently returns an empty tibble and emits a CLI error message. It is retained so that downstream code does not break if ESPN restores the endpoint, but should not be relied on in the meantime.

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_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_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{
  espn_mlb_freeagents(season = 2025)
#> ── ESPN MLB Free Agents from ESPN.com ─────────────── baseballr 2.0.0 ──
#>  Data updated: 2026-06-08 11:07:39 UTC
#> # A tibble: 0 × 0
# }