Get ESPN MLB Athlete Contract (Single Season)
Source:R/espn_mlb_athlete_contracts.R
espn_mlb_player_contract.RdReturns 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(), ...)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"). |
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
# \donttest{
# Aaron Judge 2025 contract
espn_mlb_player_contract(athlete_id = 33192, season = 2025)
#> ✖ 2026-06-08 11:07:49.71791: Failed to retrieve ESPN mlb athlete contract for athlete_id=33192, season=2025
#> ✖ Args: league = "mlb", athlete_id = 33192, season = 2025
#> ✖ Error: The API returned an error, HTTP Response Code 404
#> ── ESPN MLB Athlete Contract from ESPN.com ────────── baseballr 2.0.0 ──
#> ℹ Data updated: 2026-06-08 11:07:49 UTC
#> # A tibble: 0 × 0
# }