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.
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
Yes
The TeamID of the team this player is employed by.
Team
string
10
Yes
No
Yes
The key/abbreviation of the team this player is employed by.
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
Yes
The player's primary position. Possible values: 1B, 2B, 3B, C, CF, DH, IF, LF, OF, P, PH, PR, RF, RP, SP, SS
FirstName
string
50
Yes
No
Yes
The player's first name.
LastName
string
50
Yes
No
Yes
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
Yes
The player's height in inches.
Weight
integer
32
Yes
No
Yes
The player's weight in pounds (lbs).
BirthDate
datetime
Yes
No
Yes
The player's date of birth.
BirthCity
string
50
Yes
No
Yes
The city in which the player was born.
BirthState
string
50
Yes
No
Yes
The state in which the player was born.
BirthCountry
string
50
Yes
No
Yes
The country in which the player was born.
PhotoUrl
string
250
Yes
No
Yes
This field is deprecated. Photos are no longer available through it. Headshots are now delivered through IMAGN. Please see our Headshots products for further information.
InjuryStatus
string
50
Yes
Yes
Yes
Indicates the player's injury status. Possible values include: Probable, Questionable, Doubtful, Out, 7 Day Disabled List, 15 Day Disabled List, 60 Day Disabled List
FanDuelPlayerID
integer
32
Yes
No
Yes
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
Yes
The SlateID that this SlatePlayer refers to.
SlateGameID
integer
32
Yes
No
Yes
The SlateGameID that this SlatePlayer refers to.
PlayerID
integer
32
Yes
No
Yes
The SportsDataIO PlayerID that this SlatePlayer refers to. This points to data in the respective sports' player feeds.
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
Yes
Unique ID of the Player (assigned by the operator).
OperatorSlatePlayerID
string
50
Yes
No
Yes
Unique ID of the SlatePlayer (assigned by the operator).
OperatorPlayerName
string
50
Yes
No
Yes
The player's name (assigned by the operator).
OperatorPosition
string
10
Yes
No
Yes
The player's eligible positions for the contest (assigned by the operator).
OperatorSalary
integer
32
Yes
No
Yes
The player's salary for the contest (assigned by the operator).
OperatorRosterSlots
string[]
Yes
No
Yes
The player's eligible positions to be played in the contest (assigned by the operator). This would include UTIL, etc plays for those that are eligible.
RemovedByOperator
boolean
Yes
Yes
Yes
Indicates whether this player was removed/deleted by the operator.
Team
string
10
Yes
No
Yes
Indicates the team this player plays for
TeamID
integer
32
Yes
No
Yes
Indicates the team id of the team the player plays for
The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Status
string
20
Yes
No
Yes
Indicates the game's status. Possible values include: Scheduled, InProgress, Final, Suspended, Delayed, Postponed, Canceled, Forfeit, NotNecessary
Day
date
Yes
No
Yes
The date of the game
DateTime
datetime
Yes
No
Yes
The date and time of the game
AwayTeam
string
10
No
No
Yes
The abbreviation of the Away Team
HomeTeam
string
10
No
No
Yes
The abbreviation of the Home Team
AwayTeamID
integer
32
No
No
Yes
The unique ID of the away team
HomeTeamID
integer
32
No
No
Yes
The unique ID of the home team
StadiumID
integer
32
Yes
No
Yes
The unique ID of the stadium
AwayTeamRuns
integer
32
Yes
Yes
Yes
Number of runs the away team scored in this game
HomeTeamRuns
integer
32
Yes
Yes
Yes
Number of runs the home team scored in this 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
Yes
The PlayerID of the away team's starting pitcher
HomeTeamStartingPitcherID
integer
32
Yes
No
Yes
The PlayerID of the home team's starting pitcher
PointSpread from 2016
decimal
32
Yes
Yes
Yes
The oddsmaker Point Spread at game start from the perspective of the HomeTeam (negative numbers indicate the HomeTeam is favored, positive numbers indicate the AwayTeam is favored). This is updated once daily at 4:00 AM ET.
OverUnder from 2016
decimal
32
Yes
Yes
Yes
The oddsmaker Over/Under at game start. This is updated once daily at 4:00 AM ET.
AwayTeamMoneyLine from 2016
integer
32
Yes
Yes
Yes
Money line from the perspective of the away team. This is updated once daily at 4:00 AM ET.
HomeTeamMoneyLine from 2016
integer
32
Yes
Yes
Yes
Money line from the perspective of the home team. This is updated once daily at 4:00 AM ET.
ForecastTempLow from 2016
integer
32
Yes
Yes
Yes
The forecasted low temperature on game day at this venue (Fahrenheit).
ForecastTempHigh from 2016
integer
32
Yes
Yes
Yes
The forecasted high temperature on game day at this venue (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
Yes
Indicates the away team starting pitcher's name
HomeTeamStartingPitcher
string
50
Yes
Yes
Yes
Indicates the home team starting pitcher's name
Innings
Inning[]
Yes
No
Yes
The details of the innings associated with this 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
Yes
Indicates whether this game is played in a neutral venue
OverPayout from 2021
integer
32
Yes
Yes
Yes
The payout when betting the Over of the Over/Under
UnderPayout from 2021
integer
32
Yes
Yes
Yes
The payout when betting the Under of the Over/Under
HomeTeamOpener
boolean
Yes
No
Yes
Indicates whether the home team will utilize their bullpen instead of a dedicated starting pitcher
AwayTeamOpener
boolean
Yes
No
Yes
Indicated whether the away team will utilize their bullpen instead of a dedicated starting pitcher
Unique ID assigned to each player that stays with them throughout their career
SeasonType
integer
32
Yes
No
Yes
The season type of the timeframe (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star)
Season
integer
32
Yes
No
Yes
The MLB season of the game
Name
string
50
Yes
No
Yes
Player's name
Team
string
10
Yes
No
Yes
The abbreviation of the Team
Position
string
10
Yes
No
Yes
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
PositionCategory
string
10
Yes
No
Yes
The category (P, C, 1B, OF, SS) of the players position
Started
integer
32
Yes
No
Yes
Whether the player started
InjuryStatus from 2016
string
50
Yes
Yes
Yes
Indicates the player's injury status. Possible values include: Probable, Questionable, Doubtful, Out, 7 Day Disabled List, 15 Day Disabled List, 60 Day Disabled List
GameID
integer
32
Yes
No
Yes
The unique ID of this game
OpponentID
integer
32
Yes
No
Yes
The unique ID of the team's opponent
Opponent
string
10
Yes
No
Yes
The name of the opponent
Day
date
Yes
No
Yes
The day of the game
DateTime
datetime
Yes
No
Yes
The date and time of the game
HomeOrAway
string
4
Yes
No
Yes
Whether the team is home or away
Games
integer
32
Yes
No
Yes
The number of games played.
FantasyPoints
decimal
32
Yes
Yes
Yes
Total fantasy points
AtBats
decimal
32
Yes
Yes
Yes
At bats while hitting
Runs
decimal
32
Yes
Yes
Yes
Total runs scored.
Hits
decimal
32
Yes
Yes
Yes
Total hits
Singles
decimal
32
Yes
Yes
Yes
Total singles
Doubles
decimal
32
Yes
Yes
Yes
Total doubles
Triples
decimal
32
Yes
Yes
Yes
Total triples
HomeRuns
decimal
32
Yes
Yes
Yes
Total home runs
RunsBattedIn
decimal
32
Yes
Yes
Yes
Total runs batted in
BattingAverage
decimal
32
Yes
Yes
Yes
Total batting average
Outs
decimal
32
Yes
Yes
Yes
Total outs
Strikeouts
decimal
32
Yes
Yes
Yes
Total strikeouts
Walks
decimal
32
Yes
Yes
Yes
Total walks
HitByPitch
decimal
32
Yes
Yes
Yes
Total times hit by pitch
Sacrifices
decimal
32
Yes
Yes
Yes
Total sacrifices
SacrificeFlies
decimal
32
Yes
Yes
Yes
Total sacrifice flies
GroundIntoDoublePlay
decimal
32
Yes
Yes
Yes
Total times grounded into double play
StolenBases
decimal
32
Yes
Yes
Yes
Total stolen bases
CaughtStealing
decimal
32
Yes
Yes
Yes
Total caught stealing
OnBasePercentage
decimal
32
Yes
Yes
Yes
Total on base percentage
SluggingPercentage
decimal
32
Yes
Yes
Yes
Total slugging percentage
OnBasePlusSlugging
decimal
32
Yes
Yes
Yes
Total on base plus percentage
Wins
decimal
32
Yes
Yes
Yes
Total wins by the team/player
Losses
decimal
32
Yes
Yes
Yes
Total losses by the team/player
Saves
decimal
32
Yes
Yes
Yes
Total saves by team/player
InningsPitchedDecimal
decimal
32
Yes
Yes
Yes
Decimal representation of total innings pitched (e.g. 1.33, 7.66, etc)
Unique ID assigned to each player that stays with them throughout their career
SeasonType
integer
32
Yes
No
Yes
The season type of the timeframe (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star)
Season
integer
32
Yes
No
Yes
The MLB season of the game
Name
string
50
Yes
No
Yes
Player's name
Team
string
10
Yes
No
Yes
The abbreviation of the Team
Position
string
10
Yes
No
Yes
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
PositionCategory
string
10
Yes
No
Yes
The category (P, C, 1B, OF, SS) of the players position
Started
integer
32
Yes
No
Yes
Whether the player started
InjuryStatus from 2016
string
50
Yes
Yes
Yes
Indicates the player's injury status. Possible values include: Probable, Questionable, Doubtful, Out, 7 Day Disabled List, 15 Day Disabled List, 60 Day Disabled List
GameID
integer
32
Yes
No
Yes
The unique ID of this game
OpponentID
integer
32
Yes
No
Yes
The unique ID of the team's opponent
Opponent
string
10
Yes
No
Yes
The name of the opponent
Day
date
Yes
No
Yes
The day of the game
DateTime
datetime
Yes
No
Yes
The date and time of the game
HomeOrAway
string
4
Yes
No
Yes
Whether the team is home or away
Games
integer
32
Yes
No
Yes
The number of games played.
FantasyPoints
decimal
32
Yes
Yes
Yes
Total fantasy points
AtBats
decimal
32
Yes
Yes
Yes
At bats while hitting
Runs
decimal
32
Yes
Yes
Yes
Total runs scored.
Hits
decimal
32
Yes
Yes
Yes
Total hits
Singles
decimal
32
Yes
Yes
Yes
Total singles
Doubles
decimal
32
Yes
Yes
Yes
Total doubles
Triples
decimal
32
Yes
Yes
Yes
Total triples
HomeRuns
decimal
32
Yes
Yes
Yes
Total home runs
RunsBattedIn
decimal
32
Yes
Yes
Yes
Total runs batted in
BattingAverage
decimal
32
Yes
Yes
Yes
Total batting average
Outs
decimal
32
Yes
Yes
Yes
Total outs
Strikeouts
decimal
32
Yes
Yes
Yes
Total strikeouts
Walks
decimal
32
Yes
Yes
Yes
Total walks
HitByPitch
decimal
32
Yes
Yes
Yes
Total times hit by pitch
Sacrifices
decimal
32
Yes
Yes
Yes
Total sacrifices
SacrificeFlies
decimal
32
Yes
Yes
Yes
Total sacrifice flies
GroundIntoDoublePlay
decimal
32
Yes
Yes
Yes
Total times grounded into double play
StolenBases
decimal
32
Yes
Yes
Yes
Total stolen bases
CaughtStealing
decimal
32
Yes
Yes
Yes
Total caught stealing
OnBasePercentage
decimal
32
Yes
Yes
Yes
Total on base percentage
SluggingPercentage
decimal
32
Yes
Yes
Yes
Total slugging percentage
OnBasePlusSlugging
decimal
32
Yes
Yes
Yes
Total on base plus percentage
Wins
decimal
32
Yes
Yes
Yes
Total wins by the team/player
Losses
decimal
32
Yes
Yes
Yes
Total losses by the team/player
Saves
decimal
32
Yes
Yes
Yes
Total saves by team/player
InningsPitchedDecimal
decimal
32
Yes
Yes
Yes
Decimal representation of total innings pitched (e.g. 1.33, 7.66, etc)
The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Status
string
20
Yes
No
Yes
Indicates the game's status. Possible values include: Scheduled, InProgress, Final, Suspended, Delayed, Postponed, Canceled, Forfeit, NotNecessary
Day
date
Yes
No
Yes
The date of the game
DateTime
datetime
Yes
No
Yes
The date and time of the game
AwayTeam
string
10
No
No
Yes
The abbreviation of the Away Team
HomeTeam
string
10
No
No
Yes
The abbreviation of the Home Team
AwayTeamID
integer
32
No
No
Yes
The unique ID of the away team
HomeTeamID
integer
32
No
No
Yes
The unique ID of the home team
StadiumID
integer
32
Yes
No
Yes
The unique ID of the stadium
AwayTeamRuns
integer
32
Yes
Yes
Yes
Number of runs the away team scored in this game
HomeTeamRuns
integer
32
Yes
Yes
Yes
Number of runs the home team scored in this 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
Yes
The PlayerID of the away team's starting pitcher
HomeTeamStartingPitcherID
integer
32
Yes
No
Yes
The PlayerID of the home team's starting pitcher
PointSpread from 2016
decimal
32
Yes
Yes
Yes
The oddsmaker Point Spread at game start from the perspective of the HomeTeam (negative numbers indicate the HomeTeam is favored, positive numbers indicate the AwayTeam is favored). This is updated once daily at 4:00 AM ET.
OverUnder from 2016
decimal
32
Yes
Yes
Yes
The oddsmaker Over/Under at game start. This is updated once daily at 4:00 AM ET.
AwayTeamMoneyLine from 2016
integer
32
Yes
Yes
Yes
Money line from the perspective of the away team. This is updated once daily at 4:00 AM ET.
HomeTeamMoneyLine from 2016
integer
32
Yes
Yes
Yes
Money line from the perspective of the home team. This is updated once daily at 4:00 AM ET.
ForecastTempLow from 2016
integer
32
Yes
Yes
Yes
The forecasted low temperature on game day at this venue (Fahrenheit).
ForecastTempHigh from 2016
integer
32
Yes
Yes
Yes
The forecasted high temperature on game day at this venue (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
Yes
Indicates the away team starting pitcher's name
HomeTeamStartingPitcher
string
50
Yes
Yes
Yes
Indicates the home team starting pitcher's name
Innings
Inning[]
Yes
No
Yes
The details of the innings associated with this 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
Yes
Indicates whether this game is played in a neutral venue
OverPayout from 2021
integer
32
Yes
Yes
Yes
The payout when betting the Over of the Over/Under
UnderPayout from 2021
integer
32
Yes
Yes
Yes
The payout when betting the Under of the Over/Under
HomeTeamOpener
boolean
Yes
No
Yes
Indicates whether the home team will utilize their bullpen instead of a dedicated starting pitcher
AwayTeamOpener
boolean
Yes
No
Yes
Indicated whether the away team will utilize their bullpen instead of a dedicated starting pitcher
The timestamp of when these odds were first created, based on US Eatern Time (EST/EDT).
Updated
datetime
No
No
Yes
The timestamp of when these odds were last updated, based on US Eatern Time (EST/EDT). 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
Yes
The sportsbook's money line for the home team
AwayMoneyLine
integer
32
Yes
Yes
Yes
The sportsbook's money line for the away team
HomePointSpread
decimal
32
Yes
Yes
Yes
The sportsbook's point spread for the home team
AwayPointSpread
decimal
32
Yes
Yes
Yes
The sportsbook's point spread for the away team
HomePointSpreadPayout
integer
32
Yes
Yes
Yes
The sportsbook's point spread payout for the home team
AwayPointSpreadPayout
integer
32
Yes
Yes
Yes
The sportsbook's point spread payout for the away team
OverUnder
decimal
32
Yes
Yes
Yes
The sportsbook's total points scored over under for the game
The stadium will be set to Active if it exists. Expect available stadiums to be set to Active. For finding a team's current home stadium, Teams endpoints should be used.
Name
string
100
No
No
Yes
The full name of the stadium
City
string
50
Yes
No
Yes
The city where the stadium is located
State
string
10
Yes
No
Yes
The US state where the stadium is located (if Stadium is outside US, this value is NULL)
Country
string
10
Yes
No
Yes
The 2-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
Yes
The estimated distance between home plate and the left field wall.
MidLeftField
integer
32
Yes
No
Yes
The estimated distance between home plate and the mid left field wall.
LeftCenterField
integer
32
Yes
No
Yes
The estimated distance between home plate and the left center field wall.
MidLeftCenterField
integer
32
Yes
No
Yes
The estimated distance between home plate and the mid left center field wall.
CenterField
integer
32
Yes
No
Yes
The estimated distance between home plate and the center field wall.
MidRightCenterField
integer
32
Yes
No
Yes
The estimated distance between home plate and the mid right center field wall.
RightCenterField
integer
32
Yes
No
Yes
The estimated distance between home plate and the right center field wall.
MidRightField
integer
32
Yes
No
Yes
The estimated distance between home plate and the mid right field wall.
RightField
integer
32
Yes
No
Yes
The estimated distance between home plate and the right field wall.
GeoLat
decimal
32
Yes
No
Yes
The geographic latitude coordinate of this venue.
GeoLong
decimal
32
Yes
No
Yes
The geographic longitude coordinate of this venue.
Altitude
integer
32
Yes
No
Yes
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)