MLB API Documentation

This is the documentation for our MLB API. To get a more comprehensive understanding of what feeds we have to offer and the data points we deliver via our endpoints, we encourage you to explore the following resources:

Coverage
Workflow Guide
Data Dictionary
Help Center

All of our API endpoints can be accessed via an HTTP GET request using your API key. The API key can be passed either as a query parameter or using the following HTTP request header.
Ocp-Apim-Subscription-Key: {key}

  • JSON
  • XML

Competition Feeds

Standings, Rankings & Brackets

Available Endpoints
Subfeed
GET Standings
Standings, Rankings & Brackets
Returns regular season standings for all divisions and leagues, which is used to derive postseason seeding.
Standing

Standings

Returns regular season standings for all divisions and leagues, which is used to derive postseason seeding.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Standing[]
Included Data Tables:
Standing
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/Standings/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.

Teams, Players & Rosters

Available Endpoints
Subfeed
GET Player Profiles - by Active
Teams, Players & Rosters
Returns all players currently on a team, including biographical information, team, jersey number, position, bat hand, and throw hand.
PlayerBasic
GET Player Profiles - by Free Agents
Teams, Players & Rosters
Returns all players that are currently not on a team, including biographical information, position, bat hand, and throw hand.
PlayerBasic
GET Player Profiles - by Team
Teams, Players & Rosters
Returns all players with biographical information on the specified team.
PlayerBasic
GET Team Profiles - All
Teams, Players & Rosters
Returns all teams with information such as team name, city, league, division, colors, logos, head coach (manager), hitting coach, and pitching coach.
Team
GET Team Profiles - by Active
Teams, Players & Rosters
Returns all active teams with information such as team name, city, league, division, colors, logos, head coach (manager), hitting coach, and pitching coach.
Team
GET Team Profiles - by Season
Teams, Players & Rosters
Returns all active teams with information such as team name, city, league, division, colors, logos, head coach (manager), hitting coach, and pitching coach, for the specified season.
Team

Player Profiles - by Active

Returns all players currently on a team, including biographical information, team, jersey number, position, bat hand, and throw hand.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
PlayerBasic[]
Included Data Tables:
PlayerBasic
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/PlayersByActive
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Player Profiles - by Free Agents

Returns all players that are currently not on a team, including biographical information, position, bat hand, and throw hand.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
PlayerBasic[]
Included Data Tables:
PlayerBasic
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/PlayersByFreeAgents
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Player Profiles - by Team

Returns all players with biographical information on the specified team.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerBasic[]
Included Data Tables:
PlayerBasic
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/PlayersBasic/{team}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
team
string
true
The abbreviation of the requested team.
Examples: SF, NYY.

Team Profiles - All

Returns all teams with information such as team name, city, league, division, colors, logos, head coach (manager), hitting coach, and pitching coach.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
Team
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/AllTeams
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Team Profiles - by Active

Returns all active teams with information such as team name, city, league, division, colors, logos, head coach (manager), hitting coach, and pitching coach.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
Team
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/teams
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Team Profiles - by Season

Returns all active teams with information such as team name, city, league, division, colors, logos, head coach (manager), hitting coach, and pitching coach, for the specified season.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
Team
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/teams/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.

Venues & Officials

Available Endpoints
Subfeed
GET Stadiums
Venues & Officials
Returns all stadiums with capacity, surface, field dimensions, home plate direction, latitude/longitude, city and state (and country for stadiums outside of the United States).
Stadium

Stadiums

Returns all stadiums with capacity, surface, field dimensions, home plate direction, latitude/longitude, city and state (and country for stadiums outside of the United States).
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Stadium[]
Included Data Tables:
Stadium
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/Stadiums
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Utility Endpoints

Available Endpoints
Subfeed
GET Are Games In Progress
Utility Endpoints
Returns true if there is at least one game being played at the time of the request or false if there are none.
GET Betting Metadata
Utility Endpoints
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
BettingEntityMetadata BettingEntityMetadataCollection BettingResultingMetadata
GET Season - Current
Utility Endpoints
Returns the calendar year of the current season.
Season
GET Sportsbooks - by Active
Utility Endpoints
Returns a list of all available sportsbooks with their associated unique IDs.
Sportsbook

Are Games In Progress

Returns true if there is at least one game being played at the time of the request or false if there are none.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
boolean
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/AreAnyGamesInProgress
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Betting Metadata

Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingEntityMetadataCollection
Included Data Tables:
BettingEntityMetadata BettingEntityMetadataCollection BettingResultingMetadata
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMetadata
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Season - Current

Returns the calendar year of the current season.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Season
Included Data Tables:
Season
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/CurrentSeason
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Sportsbooks - by Active

Returns a list of all available sportsbooks with their associated unique IDs.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Sportsbook[]
Included Data Tables:
Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/ActiveSportsbooks
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Event Feeds

Schedules & Game Day Info

Available Endpoints
Subfeed
GET Schedules
Schedules & Game Day Info
Returns a full schedule of games for the specified season. Includes home and away teams, dates, start time, stadium, broadcast channel, game status, inning, pre-game lines (moneyline, spread, total runs), and gameday information like probable pitchers, current pitcher, current hitter, last play, etc.
Game Inning Series
GET Schedules (Basic)
Schedules & Game Day Info
Returns a full schedule of games for the specified season. Including home and away teams, date, start time, stadium, and game status.
ScheduleBasic Series

Schedules

Returns a full schedule of games for the specified season. Includes home and away teams, dates, start time, stadium, broadcast channel, game status, inning, pre-game lines (moneyline, spread, total runs), and gameday information like probable pitchers, current pitcher, current hitter, last play, etc.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Game[]
Included Data Tables:
Game Inning Series
Ideal For:
Populating calendar views, retrieving GameID’s to link to other feeds, and getting static game metadata
Not Ideal For:
Live scores or game status updates (Use Games - by Date instead.)
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/Games/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type).
Examples: 2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.

Schedules (Basic)

Returns a full schedule of games for the specified season. Including home and away teams, date, start time, stadium, and game status.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
ScheduleBasic[]
Included Data Tables:
ScheduleBasic Series
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/SchedulesBasic/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type).
Examples: 2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.

Scores & Game State

Available Endpoints
Subfeed
GET Games - by Date [Final]
Final Only (No Game State)
Returns final scores for games on the specified date. Including home and away teams, dates, start time, stadium, broadcast channel, game status, inning, pre-game lines (moneyline, spread, total runs), weather, and gameday information like probable pitchers, current pitcher, current hitter, last play, etc.
Game Inning Series
GET Games (Basic) - by Date [Final]
Final Only (No Game State)
Returns scores for games on the specified date. Includes home and away teams, date, start time, stadium, game status.
ScoreBasic Series
GET Games - by Date [Live & Final]
Live & Final (With Game State)
Returns scores for games on the specified date. Including home and away teams, dates, start time, stadium, broadcast channel, game status, inning, pre-game lines (moneyline, spread, total runs), weather, and gameday information like probable pitchers, current pitcher, current hitter, last play, etc.
Game Inning Series
GET Games (Basic) - by Date [Live & Final]
Live & Final (With Game State)
Returns scores for games on the specified date.
ScoreBasic Series

Games - by Date [Final]

This is the Final version of this endpoint. For live data, please use Games - by Date [Live & Final].
Returns final scores for games on the specified date. Including home and away teams, dates, start time, stadium, broadcast channel, game status, inning, pre-game lines (moneyline, spread, total runs), weather, and gameday information like probable pitchers, current pitcher, current hitter, last play, etc.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
Game Inning Series
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/GamesByDateFinal/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Games (Basic) - by Date [Final]

This is the Final version of this endpoint. For live data, please use Games (Basic) - by Date [Live & Final].
Returns scores for games on the specified date. Includes home and away teams, date, start time, stadium, game status.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
ScoreBasic[]
Included Data Tables:
ScoreBasic Series
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/ScoresBasicFinal/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Games - by Date [Live & Final]

Retrieving up-to-the-second high-level game information, such as scores and game status.
Returns scores for games on the specified date. Including home and away teams, dates, start time, stadium, broadcast channel, game status, inning, pre-game lines (moneyline, spread, total runs), weather, and gameday information like probable pitchers, current pitcher, current hitter, last play, etc.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
Game Inning Series
Ideal For:
Score tickers, live game dashboards, and retrieving high-level game information for a slate of games.
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/GamesByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Games (Basic) - by Date [Live & Final]

Returns scores for games on the specified date.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
ScoreBasic[]
Included Data Tables:
ScoreBasic Series
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/ScoresBasic/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Team & Player Stats

Available Endpoints
Subfeed
GET Box Score [Final]
Final Only
Returns all statistics for a game, including team and player stats, after the game has been completed. Box scores are subject to change after they are final. They are finalized once a game is closed.
BoxScore Game Inning PlayerGame Series TeamGame
GET Box Scores - by Date [Final]
Final Only
Returns all statistics for games on a specified date, including team and player stats, after the game has been completed.
BoxScore Game Inning PlayerGame Series TeamGame
GET Player Game Logs - by Season
Final Only
Returns a specified players box score logs for the specified season and number of games. Data is updated following the most recent games.
PlayerGame
GET Player Game Stats - by Date [Final]
Final Only
Returns box score stats for all players that participated across all games for the specified date. Data is added for players once their respective game concludes.
PlayerGame
GET Player Season Split Stats
Final Only
Returns all players' split stats for the season. Split stats are available for left, right, and switch-handed pitchers and hitters.
PlayerSeason
GET Player Season Stats
Final Only
Returns season-long stats for all players on a team for the specified season.
PlayerSeason
GET Player Season Stats - by Away
Final Only
Returns season-long stats for players based on their away games.
PlayerSeason
GET Player Season Stats - by Home
Final Only
Returns season-long stats for players based on their home games.
PlayerSeason
GET Player Season Stats - by Team
Final Only
Returns all season-long stats (i.e. the season total, not each individual game record) for the specified team's players in the specified season.
PlayerSeason
GET Player Season Stats Split - by Team
Final Only
Returns team's players' split stats for the season. Split stats are available for left, right, and switch-handed pitchers and hitters.
PlayerSeason
GET Team Game Logs - by Season
Final Only
Returns game by game logs for given team's total statistics in a specified season. And also for a specific number of games (either an integer or "all").
TeamGame
GET Team Game Stats - by Date [Final]
Final Only
Returns box score stats for each team for a specified date. Team stats are an aggregation of all player stats. Data is updated as each game is completed.
TeamGame
GET Team Season Stats
Final Only
Returns season-long stats for a specified team in a specified season.
TeamSeason
GET Box Score [Live & Final]
Live & Final
Returns all stats for the specified game, including team and player stats, during and after games.
BoxScore Game Inning PlayerGame Series TeamGame
GET Box Scores - by Date [Live & Final]
Live & Final
Returns all stats for all games on a specified date, including team and player stats, during and after games.
BoxScore Game Inning PlayerGame Series TeamGame
GET Box Scores Delta - by Date
Live & Final
Returns all stats for the specified date, only returning player stats that have changed in the last X minutes, as given in the API call. This is a live endpoint, not final, meaning that it will return data for games in progress.
BoxScore Game Inning PlayerGame Series TeamGame
GET Player Game Stats - by Date [Live & Final]
Live & Final
Returns box score stats for all players that participated across all games for the specified date during and after games.
PlayerGame
GET Team Game Stats - by Date [Live & Final]
Live & Final
Returns team stats for a specified team's game in a specific week. All of which is delivered during and after games.
TeamGame

Box Score [Final]

This is the Final version of this endpoint. For live data, please use Box Score [Live & Final].
Returns all statistics for a game, including team and player stats, after the game has been completed. Box scores are subject to change after they are final. They are finalized once a game is closed.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore
Included Data Tables:
BoxScore Game Inning PlayerGame Series TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/BoxScoreFinal/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905

Box Scores - by Date [Final]

This is the Final version of this endpoint. For live data, please use Box Scores - by Date [Live & Final].
Returns all statistics for games on a specified date, including team and player stats, after the game has been completed.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
BoxScore Game Inning PlayerGame Series TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/BoxScoresFinal/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Player Game Logs - by Season

Returns a specified players box score logs for the specified season and number of games. Data is updated following the most recent games.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
PlayerGame[]
Included Data Tables:
PlayerGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerGameStatsBySeason/{season}/{playerid}/{numberofgames}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Season to get games from. Example 2019POST, 2020
playerid
integer
true
Unique SportsDataIO Player ID. Example:10001365.
numberofgames
string
true
How many games to return. Example all, 10, 25

Player Game Stats - by Date [Final]

This is the Final version of this endpoint. For live data, please use Player Game Stats - by Date [Live & Final].
Returns box score stats for all players that participated across all games for the specified date. Data is added for players once their respective game concludes.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerGame[]
Included Data Tables:
PlayerGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerGameStatsByDateFinal/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Player Season Split Stats

Returns all players' split stats for the season. Split stats are available for left, right, and switch-handed pitchers and hitters.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
PlayerSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerSeasonSplitStats/{season}/{split}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.
split
string
true
  • L
  • R
  • S
The desired split of stats. Currently, we support vs. Left/Right/Switch handed pitchers/hitters. Possible values are: L, R and S

Player Season Stats

Returns season-long stats for all players on a team for the specified season.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
PlayerSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerSeasonStats/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.

Player Season Stats - by Away

Returns season-long stats for players based on their away games.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
PlayerSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerSeasonAwayStats/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.

Player Season Stats - by Home

Returns season-long stats for players based on their home games.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
PlayerSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerSeasonHomeStats/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.

Player Season Stats - by Team

Returns all season-long stats (i.e. the season total, not each individual game record) for the specified team's players in the specified season.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
PlayerSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerSeasonStatsByTeam/{season}/{team}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.
team
string
true
The abbreviation of the requested team.
Examples: SF, NYY.

Player Season Stats Split - by Team

Returns team's players' split stats for the season. Split stats are available for left, right, and switch-handed pitchers and hitters.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
PlayerSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerSeasonStatsSplitByTeam/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.

Team Game Logs - by Season

Returns game by game logs for given team's total statistics in a specified season. And also for a specific number of games (either an integer or "all").
Endpoint Notes
Call Interval:
1 Hour
Return Type:
TeamGame[]
Included Data Tables:
TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/TeamGameStatsBySeason/{season}/{teamid}/{numberofgames}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Season to get games from. Example 2019POST, 2020
teamid
integer
true
Unique ID of team. Example 12
numberofgames
string
true
How many games to return. Example all, 10, 25

Team Game Stats - by Date [Final]

This is the Final version of this endpoint. For live data, please use Team Game Stats - by Date [Live & Final].
Returns box score stats for each team for a specified date. Team stats are an aggregation of all player stats. Data is updated as each game is completed.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamGame[]
Included Data Tables:
TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/TeamGameStatsByDateFinal/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Team Season Stats

Returns season-long stats for a specified team in a specified season.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamSeason[]
Included Data Tables:
TeamSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/TeamSeasonStats/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.

Box Score [Live & Final]

Returns all stats for the specified game, including team and player stats, during and after games.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore
Included Data Tables:
BoxScore Game Inning PlayerGame Series TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/BoxScore/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905

Box Scores - by Date [Live & Final]

Returns all stats for all games on a specified date, including team and player stats, during and after games.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
BoxScore Game Inning PlayerGame Series TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/BoxScores/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Box Scores Delta - by Date

Returns all stats for the specified date, only returning player stats that have changed in the last X minutes, as given in the API call. This is a live endpoint, not final, meaning that it will return data for games in progress.
Endpoint Notes
Call Interval:
3 Seconds
Return Type:
BoxScore[]
Included Data Tables:
BoxScore Game Inning PlayerGame Series TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/BoxScoresDelta/{date}/{minutes}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.
minutes
string
true
Only returns player statistics that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries are: 1, 2 ... all.

Player Game Stats - by Date [Live & Final]

Returns box score stats for all players that participated across all games for the specified date during and after games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerGame[]
Included Data Tables:
PlayerGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerGameStatsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Team Game Stats - by Date [Live & Final]

Returns team stats for a specified team's game in a specific week. All of which is delivered during and after games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamGame[]
Included Data Tables:
TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/TeamGameStatsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Play by Play

Available Endpoints
Subfeed
GET Play By Play [Final]
Final Only
Returns all plays for the specified GameID, its type and outcomes, complete with player and team stats. All of which is delivered after the game.
Game Inning Pitch Play PlayByPlay Series
GET Play By Play [Live & Final]
Live & Final
Returns all plays for the specified GameID, its type and outcomes, complete with player and team stats. All of which is delivered during and after the game.
Game Inning Pitch Play PlayByPlay Series
GET Play By Play Delta
Live & Final
Returns all play-by-plays for the specified season and week, but only returns plays that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
Game Inning Pitch Play PlayByPlay Series

Play By Play [Final]

This is the Final version of this endpoint. For live data, please use Play By Play [Live & Final].
Returns all plays for the specified GameID, its type and outcomes, complete with player and team stats. All of which is delivered after the game.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
PlayByPlay
Included Data Tables:
Game Inning Pitch Play PlayByPlay Series
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/pbp/{format}/PlayByPlayFinal/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905

Play By Play [Live & Final]

Returns all plays for the specified GameID, its type and outcomes, complete with player and team stats. All of which is delivered during and after the game.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
PlayByPlay
Included Data Tables:
Game Inning Pitch Play PlayByPlay Series
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/pbp/{format}/PlayByPlay/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905

Play By Play Delta

Returns all play-by-plays for the specified season and week, but only returns plays that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
Endpoint Notes
Call Interval:
3 Seconds
Return Type:
PlayByPlay[]
Included Data Tables:
Game Inning Pitch Play PlayByPlay Series
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/pbp/{format}/PlayByPlayDelta/{date}/{minutes}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.
minutes
string
true
Only returns plays that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries are: 1, 2 ... all.

Player Feeds

Depth Charts, Lineups & Injuries

Available Endpoints
Subfeed
GET Batter vs. Pitcher Stats
Depth Charts, Lineups & Injuries
Returns stats for the specified hitter vs. the specified pitcher.
PlayerSeason
GET Depth Charts
Depth Charts, Lineups & Injuries
Returns depth charts for all teams. Includes only players on the active roster.
DepthChart TeamDepthChart
GET Player Details - by Active
Depth Charts, Lineups & Injuries
Returns all players currently on a team, including biographical information, team, jersey number, position, and injuries.
Player
GET Player Details - by Free Agents
Depth Charts, Lineups & Injuries
Returns all players currently not on a team, including biographical information, team, jersey number, position, and injuries.
Player
GET Player Details - by Injured
Depth Charts, Lineups & Injuries
Returns all players that have an injury or are on an injured list, suspended list, restricted list, paternity list, bereavement list, or military list. Including information such as injury status, injury body part, injury start date, and injury note.
Player
GET Players Details - by Team
Depth Charts, Lineups & Injuries
Returns all players on the specified team, with full bio information, injury information, and player ID's from: Rotoworld, Rotowire, SportRadar, FantasyAlarm, Stats, SportsDirect, FanDuel, DraftKings, and Yahoo.
Player
GET Starting Lineups - by Date
Depth Charts, Lineups & Injuries
Returns projected and confirmed starting lineups for games on the specified date.
Lineup StartingLineups
GET Team Hitting vs. Starting Pitcher
Depth Charts, Lineups & Injuries
Returns a team's hitting stats versus the projected or confirmed starting pitcher for the specified game.
PlayerSeason
GET Transactions
Depth Charts, Lineups & Injuries
Returns a list of transactions on given date. Includes players being signed, traded, waived, released, designated for assignment, contract selected, recalled, retired, optioned, and sent outright.
Transaction

Batter vs. Pitcher Stats

Returns stats for the specified hitter vs. the specified pitcher.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
PlayerSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/HitterVsPitcher/{hitterid}/{pitcherid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
hitterid
integer
true
Unique FantasyData Player ID. Example:10000031.
pitcherid
integer
true
Unique FantasyData Player ID. Example:10000618.

Depth Charts

Returns depth charts for all teams. Includes only players on the active roster.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamDepthChart[]
Included Data Tables:
DepthChart TeamDepthChart
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/projections/{format}/DepthCharts
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Player Details - by Active

Returns all players currently on a team, including biographical information, team, jersey number, position, and injuries.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Player[]
Included Data Tables:
Player
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/Players
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Player Details - by Free Agents

Returns all players currently not on a team, including biographical information, team, jersey number, position, and injuries.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Player[]
Included Data Tables:
Player
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/FreeAgents
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Player Details - by Injured

Returns all players that have an injury or are on an injured list, suspended list, restricted list, paternity list, bereavement list, or military list. Including information such as injury status, injury body part, injury start date, and injury note.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
Player[]
Included Data Tables:
Player
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/projections/{format}/InjuredPlayers
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Players Details - by Team

Returns all players on the specified team, with full bio information, injury information, and player ID's from: Rotoworld, Rotowire, SportRadar, FantasyAlarm, Stats, SportsDirect, FanDuel, DraftKings, and Yahoo.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Player[]
Included Data Tables:
Player
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/Players/{team}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
team
string
true
The abbreviation of the requested team.
Examples: SF, NYY.

Starting Lineups - by Date

Returns projected and confirmed starting lineups for games on the specified date.
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
StartingLineups[]
Included Data Tables:
Lineup StartingLineups
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/projections/{format}/StartingLineupsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the slates.
Examples: 2017-JUL-31, 2017-SEP-01.

Team Hitting vs. Starting Pitcher

Returns a team's hitting stats versus the projected or confirmed starting pitcher for the specified game.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
PlayerSeason[]
Included Data Tables:
PlayerSeason
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/TeamHittersVsPitcher/{gameid}/{team}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905
team
string
true
The abbreviation of the requested team.
Examples: SF, NYY.

Transactions

Returns a list of transactions on given date. Includes players being signed, traded, waived, released, designated for assignment, contract selected, recalled, retired, optioned, and sent outright.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
Transaction[]
Included Data Tables:
Transaction
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/scores/{format}/TransactionsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the news.
Examples: 2015-JUL-31, 2015-SEP-01.

Betting Feeds

Game Lines

Available Endpoints
Subfeed
GET In-Game Odds - by Date
In-Play Lines
Returns in-play game odds (spread, moneyline, total) for the specified date, meaning odds for games which are in-progress. Returns only the most recent data and does not include line movement.
GameInfo GameOdd
GET In-Game Odds - by Date [Sportsbook Group]
In-Play Lines
Returns in-play game odds (spread, moneyline, total) for games on the specified date. A Sportsbook Group must also be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
GameInfo GameOdd
GET In-Game Odds Line Movement
In-Play Lines Plus
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfo GameOdd
GET In-Game Odds Line Movement [Sportsbook Group]
In-Play Lines Plus
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfo GameOdd
GET In-Game Odds Line Movement with Resulting [Sportsbook Group]
In-Play Lines Plus
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. This also includes resulting for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
GameInfoResult GameOddOutcome GameOddResult Inning
GET Period Game Odds - by Date
Pre-Game Lines
Returns the non-full-game odds (spread, moneyline, total) for games on the specified date. Non-full-game means first inning or first five innings, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
GameInfo GameOdd
GET Pre-Game and Period Game Odds - by Date [Sportsbook Group]
Pre-Game Lines
Returns the full-game and non-full-game odds (spread, moneyline, total) for games on the specified date. A Sportsbook Group must be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement.
GameInfo GameOdd
GET Pre-Game Odds - by Date
Pre-Game Lines
Returns the full-game odds (moneyline, spread, total) for games in the specified date. Returns only the most recent data and does not include line movement.
GameInfo GameOdd
GET Period Game Odds Line Movement
Pre-Game Lines Plus
Returns the non-full-game odds (spread, moneyline, total), with line movement, for the specified game. Non-full-game means first inning or first five innings, for example, rather than full game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfo GameOdd
GET Pre-Game and Period Game Odds Line Movement [Sportsbook Group]
Pre-Game Lines Plus
Returns the game odds for games on the specified date. In this endpoint both full-game and partial-game odds are included. Returns the full line movement for the specified game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfo GameOdd
GET Pre-Game and Period Game Odds Line Movement with Resulting [Sportsbook Group]
Pre-Game Lines Plus
Returns the game odds for games on the specified date. In this endpoint both full-game and partial-game odds are included. This also includes Resulting Resulting: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. Returns the full line movement for the specified game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfoResult GameOddOutcome GameOddResult Inning
GET Pre-Game Odds Line Movement
Pre-Game Lines Plus
Returns the full-game core odds (moneyline, spread, total) for the specified GameID. Returns only the most recent data and does not include line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
GameInfo GameOdd

In-Game Odds - by Date

Returns in-play game odds (spread, moneyline, total) for the specified date, meaning odds for games which are in-progress. Returns only the most recent data and does not include line movement.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/LiveGameOddsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-06-20, 2018-06-23.

In-Game Odds - by Date [Sportsbook Group]

Returns in-play game odds (spread, moneyline, total) for games on the specified date. A Sportsbook Group must also be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/InGameOddsByDate/{date}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-06-20, 2018-06-23.
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

In-Game Odds Line Movement

Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/LiveGameOddsLineMovement/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 51735 or 51745

In-Game Odds Line Movement [Sportsbook Group]

Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/InGameOddsLineMovement/{gameid}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 51735 or 51745
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

In-Game Odds Line Movement with Resulting [Sportsbook Group]

Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. This also includes resulting for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfoResult[]
Included Data Tables:
GameInfoResult GameOddOutcome GameOddResult Inning
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/InGameOddsLineMovementWithResulting/{gameid}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 51735 or 51745
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Period Game Odds - by Date

Returns the non-full-game odds (spread, moneyline, total) for games on the specified date. Non-full-game means first inning or first five innings, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/AlternateMarketGameOddsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-06-20, 2018-06-23.

Pre-Game and Period Game Odds - by Date [Sportsbook Group]

Returns the full-game and non-full-game odds (spread, moneyline, total) for games on the specified date. A Sportsbook Group must be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/PreGameOddsByDate/{date}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-06-20, 2018-06-23.
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Pre-Game Odds - by Date

Retrieving the most recent pre-game odds data
Returns the full-game odds (moneyline, spread, total) for games in the specified date. Returns only the most recent data and does not include line movement.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
Ideal For:
Receiving the most recent pre-game odds across a variety of sportsbooks
Not Ideal For:
Retrieving line movement (Use Pre-Game Odds Line Movement instead).
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/GameOddsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-06-20, 2018-06-23.

Period Game Odds Line Movement

Returns the non-full-game odds (spread, moneyline, total), with line movement, for the specified game. Non-full-game means first inning or first five innings, for example, rather than full game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/AlternateMarketGameOddsLineMovement/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 51735 or 51745

Pre-Game and Period Game Odds Line Movement [Sportsbook Group]

Returns the game odds for games on the specified date. In this endpoint both full-game and partial-game odds are included. Returns the full line movement for the specified game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/PreGameOddsLineMovement/{gameid}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 51735 or 51745
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Pre-Game and Period Game Odds Line Movement with Resulting [Sportsbook Group]

Returns the game odds for games on the specified date. In this endpoint both full-game and partial-game odds are included. This also includes Resulting Resulting: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. Returns the full line movement for the specified game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfoResult[]
Included Data Tables:
GameInfoResult GameOddOutcome GameOddResult Inning
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/PreGameOddsLineMovementWithResulting/{gameid}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 51735 or 51745
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Pre-Game Odds Line Movement

Returns the full-game core odds (moneyline, spread, total) for the specified GameID. Returns only the most recent data and does not include line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/GameOddsLineMovement/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are 51735 or 51745

Props

Available Endpoints
Subfeed
GET Betting Props - by Season [Sportsbook Group] [Archive]
SportsDataIO API Historical
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
GET Betting Events - by Date
Props
Returns BettingEvents for the specified date, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Events - by Season
Props
Returns BettingEvents for the specified season, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Event
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified BettingEventID.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Event [Sportsbook Group]
Props
Returns the markets and available outcomes for the specified BettingEventID. A Sportsbook Group must also be specified as a URL parameter.
GET Betting Markets - by Game
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Game [Sportsbook Group]
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID. A Sportsbook Group must also be specified as a URL parameter.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Market Type
Props
Returns markets and available outcomes for the specified event and market type. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Market Type [Sportsbook Group]
Props
Returns markets and available outcomes for the specified event and market type. A Sportsbook Group must also be specified as a URL parameter. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Player Props - by Game
Props
Returns player props available in the specified game. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Player Props - by Game [Sportsbook Group]
Props
Returns player props for the specified game. A Sportsbook Group must also be specified as a URL parameter. This works the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Market
Props Plus
Returns full line movement for the specified BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Market - [Sportsbook Group]
Props Plus
Returns full line movement for the specified BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Results - by Market
Props Plus
Returns resulting for the specified market that is supported for result. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
BettingMarketResult BettingOutcomeResult
GET Betting Results - by Market [Sportsbook Group]
Props Plus
Returns resulting for the specified market that is supported for results. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. A Sportsbook Group must also be specified as a URL parameter.

Betting Props - by Season [Sportsbook Group] [Archive]

To ensure best performance, all betting odds older than 30 days are stored in our Historical API data warehouse. See our Historical Data Guide for more information.
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/archive/{format}/BettingPropsArchive/{season}/{bettingMarketId}/{sportsbookGrouping}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season
Examples: 2020, 2021, etc.
bettingMarketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookGrouping
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Events - by Date

Returns BettingEvents for the specified date, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingEvent[]
Included Data Tables:
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingEventsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2020-08-20, 2020-08-23.

Betting Events - by Season

Returns BettingEvents for the specified season, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEvent[]
Included Data Tables:
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingEvents/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type).
Examples: 2020, 2020PRE, 2020POST, 2020STAR, 2021, etc.

Betting Markets - by Event

Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified BettingEventID.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarkets/{eventId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).

Betting Markets - by Event [Sportsbook Group]

Returns the markets and available outcomes for the specified BettingEventID. A Sportsbook Group must also be specified as a URL parameter.
Endpoint Notes
Return Type:
BettingMarket[]
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarketsByEvent/{eventId}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Betting Markets - by Game

Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
Ideal For:
Receiving a high-level view of all betting markets offered for a game
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarketsByGameID/{gameID}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameID
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets).

Betting Markets - by Game [Sportsbook Group]

Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID. A Sportsbook Group must also be specified as a URL parameter.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarketsByGameID/{gameID}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameID
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets).
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Betting Markets - by Market Type

Returns markets and available outcomes for the specified event and market type. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarketsByMarketType/{eventId}/{marketTypeID}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include: 1 for Game Lines, 2 for Player Props, 3 for Team Props, 6 for Game Props

Betting Markets - by Market Type [Sportsbook Group]

Retrieving lowest latency betting markets for a given game
Returns markets and available outcomes for the specified event and market type. A Sportsbook Group must also be specified as a URL parameter. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
Ideal For:
Retrieving all betting markets for a given market type within a game
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarketsByMarketType/{eventID}/{marketTypeID}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventID
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include: 1 for Game Lines, 2 for Player Props, 3 for Team Props, 6 for Game Props
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Betting Player Props - by Game

Returns player props available in the specified game. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingPlayerPropsByGameID/{gameId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameId
integer
true
The unique GameID of the game in question.

Betting Player Props - by Game [Sportsbook Group]

Retrieving the lowest latency player props within a game
Returns player props for the specified game. A Sportsbook Group must also be specified as a URL parameter. This works the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
Ideal For:
Retrieving all player props for a given game
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingPlayerPropsByGameID/{gameId}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameId
integer
true
The unique GameID of the game in question.
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Betting Market

Returns full line movement for the specified BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingMarket
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarket/{marketId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.

Betting Market - [Sportsbook Group]

Returns full line movement for the specified BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingMarket
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarket/{marketId}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.

Possible values include:

available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.

unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Betting Results - by Market

Returns resulting for the specified market that is supported for result. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
BettingMarketResult
Included Data Tables:
BettingMarketResult BettingOutcomeResult
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingMarketResults/{marketId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets. Valid IDs include 837872, 841068

Betting Results - by Market [Sportsbook Group]

Returns resulting for the specified market that is supported for results. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. A Sportsbook Group must also be specified as a URL parameter.
Endpoint Notes
Return Type:
BettingMarketResult
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingResultsByMarket/{marketID}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketID
string
true
The MarketId of the desired market for which to pull all outcomes/bets. Valid IDs include 837872, 841068
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.

Futures

Available Endpoints
Subfeed
GET Betting Futures - by Season [Sportsbook Group] [Archive]
SportsDataIO API Historical
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
GET Betting Futures - by Season
Futures
Returns available Futures markets for the specified season. This endpoint does not include line movement.
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Futures - by Season [Sportsbook Group]
Futures
Returns all available Futures markets for the specified season. A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook

Betting Futures - by Season [Sportsbook Group] [Archive]

To ensure best performance, all betting odds older than 30 days are stored in our Historical API data warehouse. See our Historical Data Guide for more information.
All Betting Market data for events older than 30 days old is stored in [Archive] endpoints like these. You need a Historical Data API key in order to access this archival data. Please contact us for more information.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/archive/{format}/BettingFuturesArchive/{season}/{bettingMarketId}/{sportsbookGrouping}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season
Examples: 2020, 2021, etc.
bettingMarketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookGrouping
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Futures - by Season

Returns available Futures markets for the specified season. This endpoint does not include line movement.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEvent[]
Included Data Tables:
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingFuturesBySeason/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type).
Examples: 2020, 2020PRE, 2020POST, 2020STAR, 2021, etc.

Betting Futures - by Season [Sportsbook Group]

Returns all available Futures markets for the specified season. A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEvent[]
Included Data Tables:
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingFuturesBySeason/{season}/{sportsbookGroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type).
Examples: 2020, 2020PRE, 2020POST, 2020STAR, 2021, etc.
sportsbookGroup
string
true
Access Required
The name of the sportsbook group that will filter outcomes.
Available Endpoints
Subfeed
GET Betting Splits - by Game
Betting Splits
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified game. This endpoint will return the movement from this market as well as the most recent.
BettingMarketSplit BettingSplit GameBettingSplit
GET Betting Splits by - Betting Market
Betting Splits
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified market. This endpoint will return the movement from this market as well as the most recent.
BettingMarketSplit BettingSplit
GET Betting Trends - by Matchup
Matchup Stats
Returns trends data for the specified pairing of teams (team vs opponent) - Last X games. Will return data even if the teams are not set to play this season. This is intended for use on a specific game though it will work for other comparisons if applicable.
Game Inning MatchupTrends Series TeamGameTrends TeamTrends
GET Betting Trends - by Team
Matchup Stats
Returns recent team trends and performance against betting lines in recent sets of games - Last X games.
Game Inning Series TeamGameTrends TeamTrends

Betting Splits - by Game

Returns a list of Money and Bet Percentage splits for each outcome type available in the specified game. This endpoint will return the movement from this market as well as the most recent.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameBettingSplit
Included Data Tables:
BettingMarketSplit BettingSplit GameBettingSplit
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingSplitsByGameId/{gameId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameId
integer
true
The ID of the game for which you want to receive splits for. Example 63266.

Betting Splits by - Betting Market

Returns a list of Money and Bet Percentage splits for each outcome type available in the specified market. This endpoint will return the movement from this market as well as the most recent.
Endpoint Notes
Call Interval:
Return Type:
BettingMarketSplit
Included Data Tables:
BettingMarketSplit BettingSplit
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/BettingSplitsByMarketId/{marketId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull splits.. Valid IDs include 837872

Betting Trends - by Matchup

Returns trends data for the specified pairing of teams (team vs opponent) - Last X games. Will return data even if the teams are not set to play this season. This is intended for use on a specific game though it will work for other comparisons if applicable.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
MatchupTrends
Included Data Tables:
Game Inning MatchupTrends Series TeamGameTrends TeamTrends
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/MatchupTrends/{team}/{opponent}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
team
string
true
The abbreviation of the requested team.
Examples: PHI, MIN, DET, etc.
opponent
string
true
The abbreviation of the requested opponent.
Examples: PHI, MIN, DET, etc.

Betting Trends - by Team

Returns recent team trends and performance against betting lines in recent sets of games - Last X games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamTrends
Included Data Tables:
Game Inning Series TeamGameTrends TeamTrends
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/odds/{format}/TeamTrends/{team}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
team
string
true
The abbreviation of the requested team.
Examples: PHI, MIN, DET, etc.

Fantasy Feeds

Projections

Available Endpoints
Subfeed
GET Projected Player Game Stats - by Date
Legacy Projections
SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by date.
PlayerGameProjection
GET Projected Player Season Stats With ADP
Legacy Projections
SportsDataIO's proprietary projections, including average draft position, for all active players for the season.
PlayerSeasonProjection
GET DFS Slate Ownership Projections - by Slate
Ownership Projections
Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
DfsSlatePlayerOwnershipProjection DfsSlateWithOwnershipProjection
GET DFS Slate Ownership Projections - Upcoming
Ownership Projections
Returns DFS Slates which have not yet started for which we have DFS Ownership projections.
DfsSlatePlayerOwnershipProjection DfsSlateWithOwnershipProjection

Projected Player Game Stats - by Date

SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by date.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerGameProjection[]
Included Data Tables:
PlayerGameProjection
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/projections/{format}/PlayerGameProjectionStatsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

Projected Player Season Stats With ADP

SportsDataIO's proprietary projections, including average draft position, for all active players for the season.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerSeasonProjection[]
Included Data Tables:
PlayerSeasonProjection
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/projections/{format}/PlayerSeasonProjectionStats/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2017, 2018.

DFS Slate Ownership Projections - by Slate

Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlateWithOwnershipProjection
Included Data Tables:
DfsSlatePlayerOwnershipProjection DfsSlateWithOwnershipProjection
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/projections/{format}/DfsSlateOwnershipProjectionsBySlateID/{slateId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
slateId
integer
true
SlateID of the DFS Slate you wish to get ownership projections for. Will have an empty SlateOwnershipProjections if this slate was not projected

DFS Slate Ownership Projections - Upcoming

Returns DFS Slates which have not yet started for which we have DFS Ownership projections.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlateWithOwnershipProjection[]
Included Data Tables:
DfsSlatePlayerOwnershipProjection DfsSlateWithOwnershipProjection
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/projections/{format}/UpcomingDfsSlateOwnershipProjections
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Salaries, Stats & Points

Available Endpoints
Subfeed
GET Fantasy Points - by Date
Points & Stats
Returns a simple list of fantasy points and stats for each player for a given date.
FantasyGame
GET DFS Slates - by Date
Salaries & Slates
Returns DFS Slates which have not yet started for which we have DFS projections.
DfsSlate DfsSlateGame DfsSlatePlayer Game Inning Series

Fantasy Points - by Date

Returns a simple list of fantasy points and stats for each player for a given date.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
FantasyGame[]
Included Data Tables:
FantasyGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/stats/{format}/FantasyGameStatsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2017-JUL-31, 2017-SEP-01.

DFS Slates - by Date

Returns DFS Slates which have not yet started for which we have DFS projections.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlate[]
Included Data Tables:
DfsSlate DfsSlateGame DfsSlatePlayer Game Inning Series
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/projections/{format}/DfsSlatesByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the slates.
Examples: 2017-JUL-31, 2017-SEP-01.

News & Images

Player News & Notes

Available Endpoints
Subfeed
GET Premium News
Rotoballer News
Returns RotoBallers premium news feed (stories in greater detail), ordered by date/time.
News
GET Premium News - by Date
Rotoballer News
Returns RotoBallers premium news feed (stories in greater detail), for given date.
News

Premium News

Returns RotoBallers premium news feed (stories in greater detail), ordered by date/time.
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
News[]
Included Data Tables:
News
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/news-rotoballer/{format}/RotoBallerPremiumNews
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Premium News - by Date

Returns RotoBallers premium news feed (stories in greater detail), for given date.
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
News[]
Included Data Tables:
News
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/news-rotoballer/{format}/RotoBallerPremiumNewsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the news.
Examples: 2017-JUL-31, 2017-SEP-01.

Player Headshots

Available Endpoints
Subfeed
GET Headshots
Player Headshots
USA Today/IMAGN cropped action headshots for all active NFL players, delivered shortly after the season starts.
Headshot

Headshots

USA Today/IMAGN cropped action headshots for all active NFL players, delivered shortly after the season starts.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Headshot[]
Included Data Tables:
Headshot
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/mlb/headshots/{format}/Headshots
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
Contact Us