espn_mlb_player_contract: *Get ESPN MLB Athlete Contract (Single Season)*

In baseballr: Acquiring and Analyzing Baseball Data

Get ESPN MLB Athlete Contract (Single Season)

Description

Returns the full contract record for one MLB athlete in one season, including salary, cap-rule flags, option type, Bird status, and trade protections. Backed by sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/contracts/{season}.

Usage

espn_mlb_player_contract(athlete_id, season = most_recent_mlb_season(), ...)

Arguments

athlete_id	ESPN athlete identifier (character or numeric).
season	Season year (numeric). Defaults to the most recent MLB season.
...	Additional arguments; currently unused.

Value

A single-row tibble.

col_name	types	description
athlete_id	character	ESPN athlete identifier.
season	integer	Contract season year.
bird_status	integer	Bird-rights tier (0 = Non, 1 = Early, 2 = Full).
salary	numeric	Total cap-counting salary for the season ($).
salary_remaining	numeric	Remaining salary owed.
years_remaining	integer	Years left on the contract.
incoming_trade_value	numeric	Trade value if receiving this contract ($).
outgoing_trade_value	numeric	Trade value if sending out this contract ($).
option_type	integer	Option type code (e.g. team / player option).
minimum_salary_exception	logical	Signed under the minimum-salary exception.
trade_restriction	logical	Whether a trade restriction is active.
unsigned_foreign_pick	logical	Unsigned-foreign-pick flag.
active	logical	Whether the contract is currently active.
base_year_compensation_active	logical	Base-year-compensation rule active.
poison_pill_provision_active	logical	Poison-pill provision active.
trade_kicker_active	logical	Trade kicker active.
trade_kicker_percentage	numeric	Trade kicker percentage of salary.
trade_kicker_value	numeric	Trade kicker dollar value.
trade_kicker_trade_value	numeric	Trade kicker post-trade dollar value.
season_ref	character	⁠$ref⁠ to the season resource.
team_ref	character	⁠$ref⁠ to the team-in-season resource.
team_id	character	ESPN team id parsed from team_ref.
league	character	League slug ("mlb").

Author(s)

Saiem Gilani

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_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()

Examples

  # Aaron Judge 2025 contract
  espn_mlb_player_contract(athlete_id = 33192, season = 2025)

baseballr documentation built on Aug. 27, 2026, 1:07 a.m.