The FantasyData MLB API has a new home over at SportsDataIO Discovery Lab,
a platform built to offer affordable sports data for students, hobbyists and personal projects.
If you're looking for a more extensive product to power your website or application, we encourage you to check out
SportsDataIO's commercial MLB API.
Below you will find a list of all data points that are contained within each feed that we offer.
If any of the information provided below is unclear, or if you have a specific question, please contact support.
Go to our developer portal for a full list of operations including deprecated, legacy and test endpoints.
The player's unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career
Status
string
50
Yes
No
Yes
Indicates the player's status of being on an Major League Active Roster. Possible values include: Active, 40 Man Active, Non-Roster Invitee, Minors, Inactive, 7 Day Injury List, 10 Day Injury List, 15 Day Injury List, 60 Day Injury List, Restricted List, Paternity List, Bereavement List, Military List
TeamID
integer
32
Yes
No
No
The team's unique TeamID as assigned by SportsDataIO
Team
string
10
Yes
No
No
The abbreviation [Key] of the team that the player belongs to
Jersey
integer
32
Yes
No
Yes
The player's jersey number.
PositionCategory
string
10
Yes
No
Yes
The player's position category. Possible values: DH, IF, OF, P, PH, PR
Position
string
10
Yes
No
No
The player's position associated with the given game or season. Possible values: 1B; 2B; 3B; C; CF; DH; IF; LF; OF; P; PH; PR; RF; RP; SP; SS
FirstName
string
50
Yes
No
No
The player's first name
LastName
string
50
Yes
No
No
The player's last name
BatHand
string
1
Yes
No
Yes
The player's batting hand. Possible values: R, L, S
ThrowHand
string
1
Yes
No
Yes
The player's throwing hand. Possible values: R, L, S
Height
integer
32
Yes
No
No
The player's height in inches
Weight
integer
32
Yes
No
No
The weight of the player in pounds (lbs).
BirthDate
datetime
Yes
No
No
The player's date of birth
BirthCity
string
50
Yes
No
No
The city in which the player was born
BirthState
string
50
Yes
No
No
The state in which the player was born. Note: State will be NULL for all countries outside of North America and Australia
BirthCountry
string
50
Yes
No
No
The country in which the player was born
PhotoUrl
string
250
Yes
No
No
Field is expected to be NULL
InjuryStatus
string
50
Yes
Yes
No
The player's current injury status; in the form of likelihood that player plays. Possible values: Probable; Questionable; Doubtful; Out
FanDuelPlayerID
integer
32
Yes
No
No
The player's unique PlayerID for cross reference use with FanDuel
DraftKingsPlayerID
integer
32
Yes
No
Yes
The player's unique PlayerID for cross reference use with DraftKings.
Unique ID of a SlatePlayer (assigned by SportsDataIO)
SlateID
integer
32
No
No
No
The SlateID that this SlatePlayer refers to
SlateGameID
integer
32
Yes
No
No
The SlateGameID that this SlatePlayer refers to
PlayerID
integer
32
Yes
No
No
The player's unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career
PlayerGameProjectionStatID
integer
32
Yes
No
Yes
The SportsDataIO StatID that this SlatePlayer refers to. This points to data in the respective sports' projected player game stats feeds.
OperatorPlayerID
string
25
Yes
No
No
Unique ID of the Player (assigned by the operator)
OperatorSlatePlayerID
string
50
Yes
No
No
Unique ID of the SlatePlayer (assigned by the operator)
OperatorPlayerName
string
50
Yes
No
No
The player's name (assigned by the operator)
OperatorPosition
string
10
Yes
No
No
The player's eligible positions for the contest (assigned by the operator)
OperatorSalary
integer
32
Yes
No
No
The player's salary for the contest (assigned by the operator)
OperatorRosterSlots
string[]
Yes
No
No
The player's eligible positions to be played in the contest (assigned by the operator). Note: this would include UTIL; etc plays for those that are eligible.
RemovedByOperator
boolean
Yes
Yes
No
Indicates whether this player was removed/deleted by the operator
Team
string
10
Yes
No
No
The abbreviation [Key] of the team
TeamID
integer
32
Yes
No
No
The team's unique TeamID as assigned by SportsDataIO
The type of season stage the game belongs to, e.g. Regular season, Post-season. For a description of possible values and how they work, see <a href="https://support.sportsdata.io/hc/en-us/articles/15196612633623-Process-Guide-Season-Types-and-Parameters" target="_blank">here.
Status
string
20
Yes
No
Yes
The status of the game. For a description of possible values, see <a href="https://support.sportsdata.io/hc/en-us/articles/14287629964567-Process-Guide-Game-Status" target="_blank">here.</a> For how suspended and postponed games are handled specifically, see <a href="https://support.sportsdata.io/hc/en-us/articles/4404845580567-Postponed-and-Rescheduled-Games" target="_blank">here</a>.
Day
date
Yes
No
Yes
The date of the game
DateTime
datetime
Yes
No
No
The date and time of the game (in US Eastern Time)
AwayTeam
string
10
No
No
No
The abbreviation [Key] of the away team
HomeTeam
string
10
No
No
No
The abbreviation [Key] of the home team
AwayTeamID
integer
32
No
No
No
The unique TeamID of the away team
HomeTeamID
integer
32
No
No
No
The unique ID of the home team
StadiumID
integer
32
Yes
No
Yes
The unique ID of the stadium
AwayTeamRuns
integer
32
Yes
Yes
No
Number of runs scored by the away team in the game
HomeTeamRuns
integer
32
Yes
Yes
No
Number of runs scored by the home team in the game
AwayTeamProbablePitcherID
integer
32
Yes
No
Yes
The PlayerID of the away team's probable pitcher
HomeTeamProbablePitcherID
integer
32
Yes
No
Yes
The PlayerID of the home team's probable pitcher
AwayTeamStartingPitcherID
integer
32
Yes
No
No
The PlayerID of the away team's starting pitcher
HomeTeamStartingPitcherID
integer
32
Yes
No
No
The PlayerID of the home team starting pitcher in the game
PointSpread from 2016
decimal
32
Yes
Yes
No
The consensus Run Line at game start from the perspective of the HomeTeam (in the Game table, the PointSpread field's negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored. Note that this rule does not hold in betting-related tables, where the run line is contingent on the bet line). Note: In MLB, Point Spread may also be referred to as Run Line
OverUnder from 2016
decimal
32
Yes
Yes
No
The oddsmaker total points line at game start
AwayTeamMoneyLine from 2016
integer
32
Yes
Yes
No
Moneyline from the perspective of the away team
HomeTeamMoneyLine from 2016
integer
32
Yes
Yes
No
Moneyline from the perspective of the home team
ForecastTempLow from 2016
integer
32
Yes
Yes
No
The forecasted low temperature on game day at this venue (in Fahrenheit)
ForecastTempHigh from 2016
integer
32
Yes
Yes
No
The forecasted high temperature on game day at this venue (in Fahrenheit)
ForecastDescription from 2016
string
50
Yes
Yes
Yes
The description of the weather forecast. Posible values include: Broken Clouds, Clear Sky, Few Clouds, Heavy Intensity Rain, Light Rain, Moderate Rain, Mostly Cloudy, Mostly Sunny, Overcast Clouds, Partly Cloudy, Scattered Clouds, Showers, Thunderstorms
ForecastWindChill from 2016
integer
32
Yes
Yes
Yes
The forecasted wind chill on game day at this venue.
ForecastWindSpeed from 2016
integer
32
Yes
Yes
Yes
The forecasted wind speed on game day at this venue.
ForecastWindDirection from 2016
integer
32
Yes
Yes
Yes
The wind direction isn't baseball specific. It refers to the direction that the wind is coming from. 90 would be wind coming from the east. 180 is wind from the south. 270 is a wind from the west ... and so on.
AwayTeamStartingPitcher
string
50
Yes
Yes
No
The first and last name of the away team's starting pitcher for the game
HomeTeamStartingPitcher
string
50
Yes
Yes
No
The first and last name of the home team starting pitcher for the game
Innings
Inning[]
Yes
No
No
The inning details associated with the game
HomeRotationNumber from 2019
integer
32
Yes
Yes
Yes
Rotation number of home team for this game
AwayRotationNumber from 2019
integer
32
Yes
Yes
Yes
Rotation number of away team for this game
NeutralVenue from 2020
boolean
Yes
No
No
Indicates whether this game is played in a neutral venue. Note: Neutral = True, not neutral = False
OverPayout from 2021
integer
32
Yes
Yes
No
The sportsbook's payout for the over
UnderPayout from 2021
integer
32
Yes
Yes
No
The sportsbook's payout for the under
HomeTeamOpener
boolean
Yes
No
No
Indicates whether the home team will use an opener as the starting pitcher. NOTE: An opener is a pitcher (typically a relief pitcher) that is only scheduled to pitch the first 1-3 innings of the game
AwayTeamOpener
boolean
Yes
No
No
Indicates whether the away team will use an opener as the starting pitcher.. NOTE: An opener is a pitcher (typically a relief pitcher) that is only scheduled to pitch the first 1-3 innings of the game
The type of season stage the game belongs to, e.g. Regular season, Post-season. For a description of possible values and how they work, see <a href="https://support.sportsdata.io/hc/en-us/articles/15196612633623-Process-Guide-Season-Types-and-Parameters" target="_blank">here.
Status
string
20
Yes
No
Yes
The status of the game. For a description of possible values, see <a href="https://support.sportsdata.io/hc/en-us/articles/14287629964567-Process-Guide-Game-Status" target="_blank">here.</a> For how suspended and postponed games are handled specifically, see <a href="https://support.sportsdata.io/hc/en-us/articles/4404845580567-Postponed-and-Rescheduled-Games" target="_blank">here</a>.
Day
date
Yes
No
Yes
The date of the game
DateTime
datetime
Yes
No
No
The date and time of the game (in US Eastern Time)
AwayTeam
string
10
No
No
No
The abbreviation [Key] of the away team
HomeTeam
string
10
No
No
No
The abbreviation [Key] of the home team
AwayTeamID
integer
32
No
No
No
The unique TeamID of the away team
HomeTeamID
integer
32
No
No
No
The unique ID of the home team
StadiumID
integer
32
Yes
No
Yes
The unique ID of the stadium
AwayTeamRuns
integer
32
Yes
Yes
No
Number of runs scored by the away team in the game
HomeTeamRuns
integer
32
Yes
Yes
No
Number of runs scored by the home team in the game
AwayTeamProbablePitcherID
integer
32
Yes
No
Yes
The PlayerID of the away team's probable pitcher
HomeTeamProbablePitcherID
integer
32
Yes
No
Yes
The PlayerID of the home team's probable pitcher
AwayTeamStartingPitcherID
integer
32
Yes
No
No
The PlayerID of the away team's starting pitcher
HomeTeamStartingPitcherID
integer
32
Yes
No
No
The PlayerID of the home team starting pitcher in the game
PointSpread from 2016
decimal
32
Yes
Yes
No
The consensus Run Line at game start from the perspective of the HomeTeam (in the Game table, the PointSpread field's negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored. Note that this rule does not hold in betting-related tables, where the run line is contingent on the bet line). Note: In MLB, Point Spread may also be referred to as Run Line
OverUnder from 2016
decimal
32
Yes
Yes
No
The oddsmaker total points line at game start
AwayTeamMoneyLine from 2016
integer
32
Yes
Yes
No
Moneyline from the perspective of the away team
HomeTeamMoneyLine from 2016
integer
32
Yes
Yes
No
Moneyline from the perspective of the home team
ForecastTempLow from 2016
integer
32
Yes
Yes
No
The forecasted low temperature on game day at this venue (in Fahrenheit)
ForecastTempHigh from 2016
integer
32
Yes
Yes
No
The forecasted high temperature on game day at this venue (in Fahrenheit)
ForecastDescription from 2016
string
50
Yes
Yes
Yes
The description of the weather forecast. Posible values include: Broken Clouds, Clear Sky, Few Clouds, Heavy Intensity Rain, Light Rain, Moderate Rain, Mostly Cloudy, Mostly Sunny, Overcast Clouds, Partly Cloudy, Scattered Clouds, Showers, Thunderstorms
ForecastWindChill from 2016
integer
32
Yes
Yes
Yes
The forecasted wind chill on game day at this venue.
ForecastWindSpeed from 2016
integer
32
Yes
Yes
Yes
The forecasted wind speed on game day at this venue.
ForecastWindDirection from 2016
integer
32
Yes
Yes
Yes
The wind direction isn't baseball specific. It refers to the direction that the wind is coming from. 90 would be wind coming from the east. 180 is wind from the south. 270 is a wind from the west ... and so on.
AwayTeamStartingPitcher
string
50
Yes
Yes
No
The first and last name of the away team's starting pitcher for the game
HomeTeamStartingPitcher
string
50
Yes
Yes
No
The first and last name of the home team starting pitcher for the game
Innings
Inning[]
Yes
No
No
The inning details associated with the game
HomeRotationNumber from 2019
integer
32
Yes
Yes
Yes
Rotation number of home team for this game
AwayRotationNumber from 2019
integer
32
Yes
Yes
Yes
Rotation number of away team for this game
NeutralVenue from 2020
boolean
Yes
No
No
Indicates whether this game is played in a neutral venue. Note: Neutral = True, not neutral = False
OverPayout from 2021
integer
32
Yes
Yes
No
The sportsbook's payout for the over
UnderPayout from 2021
integer
32
Yes
Yes
No
The sportsbook's payout for the under
HomeTeamOpener
boolean
Yes
No
No
Indicates whether the home team will use an opener as the starting pitcher. NOTE: An opener is a pitcher (typically a relief pitcher) that is only scheduled to pitch the first 1-3 innings of the game
AwayTeamOpener
boolean
Yes
No
No
Indicates whether the away team will use an opener as the starting pitcher.. NOTE: An opener is a pitcher (typically a relief pitcher) that is only scheduled to pitch the first 1-3 innings of the game
The date and time when these odds were first created in US Eastern Time
Updated
datetime
No
No
No
The date and time of when these odds were last updated (in US Eatern Time) If these are the latest odds for this game; and they have not been updated within the last few minutes; then it indicates that there were problems connecting to the sportsbook.
HomeMoneyLine
integer
32
Yes
Yes
No
The sportsbook's moneyline for the home team
AwayMoneyLine
integer
32
Yes
Yes
No
The sportsbook's moneyline for the away team
HomePointSpread
decimal
32
Yes
Yes
No
The sportsbook's run line for the home team
AwayPointSpread
decimal
32
Yes
Yes
No
The sportsbook's run line for the away team
HomePointSpreadPayout
integer
32
Yes
Yes
No
The sportsbook's run line payout for the home team
AwayPointSpreadPayout
integer
32
Yes
Yes
No
The sportsbook's run line payout for the away team
The state where the stadium is located (only US and Canadian stadiums will have values)
Country
string
10
Yes
No
No
The 3-digit country code where the stadium is located
Capacity
integer
32
Yes
No
Yes
The estimated seating capacity of the stadium
Surface
string
50
Yes
No
Yes
The playing surface of the stadium (Grass, Artificial or Dome)
LeftField
integer
32
Yes
No
No
The estimated distance between home plate and the left field wall
MidLeftField
integer
32
Yes
No
No
The estimated distance between home plate and the mid left field wall
LeftCenterField
integer
32
Yes
No
No
The estimated distance between home plate and the left center field wall
MidLeftCenterField
integer
32
Yes
No
No
The estimated distance between home plate and the mid left center field wall
CenterField
integer
32
Yes
No
No
The estimated distance between home plate and the center field wall
MidRightCenterField
integer
32
Yes
No
No
The estimated distance between home plate and the mid right center field wall
RightCenterField
integer
32
Yes
No
No
The estimated distance between home plate and the right center field wall
MidRightField
integer
32
Yes
No
No
The estimated distance between home plate and the mid right field wall
RightField
integer
32
Yes
No
No
The estimated distance between home plate and the right field wall
GeoLat
decimal
32
Yes
No
No
The geographic latitude coordinate of this venue
GeoLong
decimal
32
Yes
No
No
The geographic longitude coordinate of this venue
Altitude
integer
32
Yes
No
No
The altitude of the stadium in feet
HomePlateDirection
integer
32
Yes
No
Yes
The direction that the batter is facing while looking at the pitcher's mound. If the home plate is at the north of the stadium, the batter is facing south, so the value is given as 180 degrees. If home plate is at the east the batter faces west, so it's 270 degrees. If the home plate is at the south the batter faces north, so it's 0 degrees. If the home plate is at the west the batter faces east, so it's 90 degrees.
Type
string
50
Yes
No
Yes
The type of the stadium (possible values: Outdoor, Dome, RetractableDome)