Baseball-MLB API v2 Documentation

Quick Guide

LEAGUE_ID

CONTRACT_SEASON_ID

SEASON_ID

SEASON_ID & TEAM_ID

API MLB Unlimited Access To Seasons, Teams, and Players

API Demo * Limited Results

MLB Contracts

Includes contract terms, expanded salary details, and additional player attributes
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2021
    LEAGUE_ID: mlb
    TEAM_ID: oakland-athletics
    TEAM_NAME: Oakland Athletics
    TEAM_CODE: OAK
    TEAM_CONFERENCE: AL
    TEAM_DIVISION: West

    PLAYER_NAME: Matt Chapman
    PLAYER_ID: matt-chapman
    PLAYER_AGE: 28
    PLAYER_YOS: 3.109
    PLAYER_POSITION: Third Baseman
    PLAYER_POSITION_CODE: 3B
    PLAYER_GROUP: Infield
    PLAYER_GROUP_CODE: IF

    CONTRACT_TOTAL: 6490000
    CONTRACT_YEARS: 1-yr
    CONTRACT_FREEAGENT: 2024
    CONTRACT_STATUS: Arb 1

    SALARY: 6490000
    SALARY_BASE: 6490000
    SALARY_ADJUSTMENT: 6490000
    SALARY_SIGNING: 0
    SALARY_INCENTIVE: 0
    SALARY_LUXURYTAX: 0
    SALARY_PCT: 7.27
    SALARY_AVG: 6490000
    SALARY_Y1: 6490000
    SALARY_Y2: 0
    SALARY_Y3: 0
    SALARY_Y4: 0
    SALARY_Y5: 0

MLB Salaries

Includes basic salary details and player attributes
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2018
    LEAGUE_ID: mlb
    TEAM_ID: oakland-athletics
    TEAM_NAME: Oakland Athletics
    TEAM_CODE: OAK

    PLAYER_NAME: Matt Chapman
    PLAYER_ID: matt-chapman
    PLAYER_AGE: 25
    PLAYER_POSITION: Third Baseman
    PLAYER_POSITION_CODE: 3B
    PLAYER_GROUP: Infield
    PLAYER_GROUP_CODE: IF

    CONTRACT_STATUS: Pre-Arb

    SALARY: 547500
    SALARY_BASE: 547500
    SALARY_ADJUSTMENT: 547500
    SALARY_SIGNING: 0
    SALARY_INCENTIVE: 0
    SALARY_LUXURYTAX: 547500
    SALARY_PCT: 0.68

    ADJUSTED_SALARY: 564298
    ADJUSTED_SALARY_BASE: 564298

MLB Payrolls

Includes overall figures and breakdowns by position groups
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2020
    LEAGUE_ID: mlb
    TEAM_ID: oakland-athletics
    TEAM_NAME: Oakland Athletics
    TEAM_CODE: OAK
    TEAM_COLOR: 0,56,49

    PAYROLL: 93198933
    PAYROLL_PITCHING: 42041000
    PAYROLL_PITCHING_PCT: 0.451
    PAYROLL_INFIELD: 15956100
    PAYROLL_INFIELD_PCT: 0.171
    PAYROLL_OUTFIELD: 18451833
    PAYROLL_OUTFIELD_PCT: 0.198
    PAYROLL_DH: 16750000
    PAYROLL_DH_PCT: 0.18

    ADJUSTED_PAYROLL: 93198933
    ADJUSTED_PITCHING: 42041000
    ADJUSTED_INFIELD: 15956100
    ADJUSTED_OUTFIELD: 18451833
    ADJUSTED_DH: 16750000

MLB Team_ID

Find all IDs and additional information for teams in this league
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2020
    LEAGUE_ID: mlb
    TEAM_ID: arizona-diamondbacks
    TEAM_NAME: Arizona Diamondbacks
    TEAM_CODE: ARI

MLB Player_ID

Find all IDs and additional information for players in this league
  • CLICK HERE TO VIEW DATA SAMPLE

    PLAYER_ID: aaron-altherr
    PLAYER_NAME: Aaron Altherr