Skip to main content

NHL API Documentation

This is the documentation for our NHL 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:

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 teams in the specified season.

Standings

Returns regular season standings for all teams in the specified season.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Standing[]
Included Data Tables:
 
 
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.
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: 2016, 2017.

Teams, Players & Rosters

Available Endpoints
Subfeed
Teams, Players & Rosters
Returns all players on a team, including biographical information, team, jersey number, position, and injuries.
Teams, Players & Rosters
Returns all players not on a team, including biographical information, team, jersey number, position, and injuries.
Teams, Players & Rosters
Returns players on the specified team with their biographical information, jersey number, and position.
Teams, Players & Rosters
Returns all teams with information such as team name, city, conference, division, colors, logos, and head coach. All teams, regardless of status, will be included - i.e. All-Star Teams.
Teams, Players & Rosters
Returns active teams with information such as team name, city, conference, division, colors, logos, and head coach.
Teams, Players & Rosters
Returns active teams for the specified season with information such as team name, city, conference, division, colors, logos, and head coach.

Player Details - by Active

Returns all players on a team, including biographical information, team, jersey number, position, and injuries.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
PlayerBasic[]
Included Data Tables:
 
 
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.
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 not on a team, including biographical information, team, jersey number, position, and injuries.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
PlayerBasic[]
Included Data Tables:
 
 
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.
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 Profiles - by Team

Returns players on the specified team with their biographical information, jersey number, and position.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerBasic[]
Included Data Tables:
 
 
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.
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, conference, division, colors, logos, and head coach. All teams, regardless of status, will be included - i.e. All-Star Teams.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
 
 
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.
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 active teams with information such as team name, city, conference, division, colors, logos, and head coach.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
 
 
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.
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 active teams for the specified season with information such as team name, city, conference, division, colors, logos, and head coach.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
 
 
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.
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 Referees
Venues & Officials
Returns all referees with position, number, college, and experience.
GET Stadiums
Venues & Officials
Returns all stadiums with capacity, address, latitude/longitude, city, state, and country.

Referees

Returns all referees with position, number, college, and experience.
Endpoint Notes
Call Interval:
1 Day
Return Type:
Referee[]
Included Data Tables:
 
 
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.
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.

Stadiums

Returns all stadiums with capacity, address, latitude/longitude, city, state, and country.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Stadium[]
Included Data Tables:
 
 
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.
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
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.
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.
Utility Endpoints
Returns the calendar year of the current season. For leagues that span across two calendar years, the current season is defined as the calendar year in which the majority of the season falls.
Utility Endpoints
Returns a list of all available sportsbooks with their associated unique IDs.

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.
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
 
 
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.
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. For leagues that span across two calendar years, the current season is defined as the calendar year in which the majority of the season falls.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Season
Included Data Tables:
 
 
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.
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:
 
 
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.
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, date, start time, stadium, game status, quarter, pre-game lines (moneyline, spread, total), and gameday information.
Schedules & Game Day Info
Returns a lightweight schedule of games for the specified season. Includes home and away teams, date, start time, stadium, and game status.

Schedules

Returns a full schedule of games for the specified season. Includes home and away teams, date, start time, stadium, game status, quarter, pre-game lines (moneyline, spread, total), and gameday information.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Game[]
Included Data Tables:
Ideal For:
Populating calendar views, retrieving GameID’s to link to other feeds, and getting static game metadata
Not Ideal For:
Live scores and 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.
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 lightweight schedule of games for the specified season. Includes home and away teams, date, start time, stadium, and game status.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
ScheduleBasic[]
Included Data Tables:
 
 
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.
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
Final Only (No Game State)
Full scores and gameday info, including infotainment odds, as well as all of the period scores and full-time score, delivered as the game ends.
Final Only (No Game State)
Returns final scores for all games on the specified date. No gameday info is provided.
Live & Final (With Game State)
Full scores and gameday info delivered live and post-game. Live data includes period and score info. Gameday info includes TV channel, attendance, etc.
Live & Final (With Game State)
Returns live and final scores for all games on the specified date. No gameday info is provided.

Games - by Date [Final]

This is the Final version of this endpoint. For live data, please use Games - by Date [Live & Final].
Full scores and gameday info, including infotainment odds, as well as all of the period scores and full-time score, delivered as the game ends.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
 
 
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.
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-JAN-31, 2017-OCT-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 final scores for all games on the specified date. No gameday info is provided.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
ScoreBasic[]
Included Data Tables:
 
 
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.
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-JAN-31, 2017-OCT-01.

Games - by Date [Live & Final]

Retrieving up-to-the-second high-level game information, such as scores and game status.
Full scores and gameday info delivered live and post-game. Live data includes period and score info. Gameday info includes TV channel, attendance, etc.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
Ideal For:
Score tickers, live dashboards, and checking game status updates.
 
 
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.
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-JAN-31, 2017-OCT-01.

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

Returns live and final scores for all games on the specified date. No gameday info is provided.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
ScoreBasic[]
Included Data Tables:
 
 
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.
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-JAN-31, 2017-OCT-01.

Team & Player Stats

Available Endpoints
Subfeed
Final Only
Returns all statistics for the specified game, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
Final Only
Returns all statistics for all games on the specified date, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
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.
Final Only
Returns box score stats for all players that participated in a game on the specified date. Data is added for players once their respective game concludes.
Final Only
Returns season-long stats for all players on a team for the specified season.
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.
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.
Final Only
Returns box score stats for each team on the specified date. Team stats are an aggregation of all player stats. Data is updated as each game is completed.
Final Only
Returns season-long stats (i.e. the season total, not each individual game record) for all teams in the specified season.
Final Only
Returns a season total of stats for the specified teams' opponents' positions (e.g. all field goals made against this team by Right Wings, Left Wings, etc.).
Live & Final
Returns all statistics for the specified game, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final.
Live & Final
Returns all statistics for all games on the specified date, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final.
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.
Live & Final
Returns box score stats for all players that participated in a game on the specified date. All of which is updated during and after games.
Live & Final
Returns team stats for the specified team's game on the specified date. All of which is delivered during and after games.

Box Score [Final]

This is the Final version of this endpoint. For live data, please use Box Score [Live & Final].
Returns all statistics for the specified game, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore
 
 
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.
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 NHL 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 all games on the specified date, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
 
 
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.
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-OCT-31, 2018-FEB-15.

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:
 
 
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.
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:30000651.
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 in a game on 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:
 
 
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.
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-OCT-31, 2018-FEB-15.

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:
 
 
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.
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: 2016, 2017.

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:
 
 
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.
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: 2016, 2017.
team
string
true
The abbreviation of the requested team.
Examples: SF, NYY.

Team 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:
TeamGame[]
Included Data Tables:
 
 
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.
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 8
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 on the 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:
 
 
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.
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-JAN-31, 2017-OCT-01.

Team Season Stats

Returns season-long stats (i.e. the season total, not each individual game record) for all teams in the specified season.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamSeason[]
Included Data Tables:
 
 
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.
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: 2016, 2017.

Team Stats Allowed - by Position

Returns a season total of stats for the specified teams' opponents' positions (e.g. all field goals made against this team by Right Wings, Left Wings, etc.).
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamSeason[]
Included Data Tables:
 
 
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.
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: 2016, 2017.

Box Score [Live & Final]

Returns all statistics for the specified game, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905

Box Scores - by Date [Live & Final]

Returns all statistics for all games on the specified date, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
 
 
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.
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-OCT-31, 2018-FEB-15.

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[]
 
 
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.
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-OCT-31, 2018-FEB-15.
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 or 2.

Player Game Stats - by Date [Live & Final]

Returns box score stats for all players that participated in a game on the specified date. All of which is updated during and after games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerGame[]
Included Data Tables:
 
 
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.
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-OCT-31, 2018-FEB-15.

Team Game Stats - by Date [Live & Final]

Returns team stats for the specified team's game on the specified date. All of which is delivered during and after games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamGame[]
Included Data Tables:
 
 
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.
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-JAN-31, 2017-OCT-01.

Play by Play

Available Endpoints
Subfeed
Final Only
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered after the game.
Live & Final
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered during and after the game.
Live & Final
Returns all play-by-play 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.

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 game with each play's 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
 
 
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.
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 NHL 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 game with each play's 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
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905

Play By Play Delta

Returns all play-by-play 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[]
 
 
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.
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-JAN-31, 2017-OCT-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
Depth Charts, Lineups & Injuries
Returns goaltender depth charts for all teams.
Depth Charts, Lineups & Injuries
The line combinations - groups of skaters that play together - ordered and given by season.
Depth Charts, Lineups & Injuries
Returns all players on a team, including biographical information, team, jersey number, position, and injuries.
Depth Charts, Lineups & Injuries
Returns all players not on a team, including biographical information, team, jersey number, position, and injuries.
Depth Charts, Lineups & Injuries
Returns all injured players along with injury information (status, start date, body part, and note).
Depth Charts, Lineups & Injuries
Returns all players on specified team, with full bio information and injury information.
Depth Charts, Lineups & Injuries
Returns projected and confirmed starting goaltenders on the specified date.
Depth Charts, Lineups & Injuries
Returns a list of transactions for given date. Includes players being signed, traded, waived, released, recalled, reassigned, loaned, and retired.

Depth Charts - Goalies

Returns goaltender depth charts for all teams.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamGoalieDepthChart[]
Included Data Tables:
 
 
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.
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.

Line Combinations - by Season

The line combinations - groups of skaters that play together - ordered and given by season.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
TeamLine[]
Included Data Tables:
 
 
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.
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: 2016, 2017.

Player Details - by Active

Returns all players on a team, including biographical information, team, jersey number, position, and injuries.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Player[]
Included Data Tables:
 
 
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.
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 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:
 
 
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.
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 injured players along with injury information (status, start date, body part, and note).
Endpoint Notes
Call Interval:
1 Minute
Return Type:
Player[]
Included Data Tables:
 
 
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.
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 specified team, with full bio information and injury information.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Player[]
Included Data Tables:
 
 
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.
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 Goaltenders - by Date

Returns projected and confirmed starting goaltenders on the specified date.
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
StartingGoaltenders[]
Included Data Tables:
 
 
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.
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: 2021-OCT-12, 2021-DEC-09.

Transactions

Returns a list of transactions for given date. Includes players being signed, traded, waived, released, recalled, reassigned, loaned, and retired.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
Transaction[]
Included Data Tables:
 
 
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.
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: 2018-JAN-31, 2017-OCT-01.

Betting Feeds

Game Lines

Available Endpoints
Subfeed
In-Play Lines
Returns in-play game odds (spread, moneyline, total) for games on a given date. Only returns the most recently seen odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
In-Play Lines
Returns in-play game odds (spread, moneyline, total) for games on a given date. Only returns the most recently seen odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress. A Sportsbook Group must be specified as a URL parameter.
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.
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.
In-Play Lines Plus
Returns in-play game odds (spread, moneyline, total) for games on a given date. 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. Returns the full line movement for the given 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. A Sportsbook Group must be specified as a URL parameter.
Pre-Game Lines
Returns the non-full-game odds (spread, moneyline, total) for games on the specified date. Non-full-game means 1st period or regulation, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
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.
Pre-Game Lines
Returns the full-game odds (moneyline, spread, total) for games on the specified date. Returns only the most recent data and does not include line movement.
Pre-Game Lines Plus
Returns the non-full-game odds (spread, moneyline, total) for games on a given date. Non-full-game means 1st period or regulation, for example, rather than full game. Returns the full line movement for the given 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.
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 given 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.
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. 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 given 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.
Pre-Game Lines Plus
Returns the full-game core odds (moneyline, spread, total) for the specified game. 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.

In-Game Odds - by Date

Returns in-play game odds (spread, moneyline, total) for games on a given date. Only returns the most recently seen 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:
 
 
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.
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-11-20, 2018-11-23.

In-Game Odds - by Date [Sportsbook Group]

Returns in-play game odds (spread, moneyline, total) for games on a given date. Only returns the most recently seen odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
GameInfo[]
Included Data Tables:
 
 
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.
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-11-20, 2018-11-23.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

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:
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 13096 or 13110

In-Game Odds Line Movement [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:
GameInfo[]
Included Data Tables:
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 13096 or 13110
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

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

Returns in-play game odds (spread, moneyline, total) for games on a given date. 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. Returns the full line movement for the given 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. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfoResult[]
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 13096 or 13110
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Period Game Odds - by Date

Returns the non-full-game odds (spread, moneyline, total) for games on the specified date. Non-full-game means 1st period or regulation, 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:
 
 
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.
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-11-20, 2018-11-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:
 
 
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.
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-11-20, 2018-11-23.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Pre-Game Odds - by Date

Retrieving the most recent pre-game odds data
Returns the full-game odds (moneyline, spread, total) for games on 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:
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.
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-11-20, 2018-11-23.

Period Game Odds Line Movement

Returns the non-full-game odds (spread, moneyline, total) for games on a given date. Non-full-game means 1st period or regulation, for example, rather than full game. Returns the full line movement for the given 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:
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 13096 or 13110

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 given 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:
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 13096 or 13110
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

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. 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 given 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[]
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 13096 or 13110
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Pre-Game Odds Line Movement

Returns the full-game core odds (moneyline, spread, total) for the specified game. 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:
 
 
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.
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 NHL game. GameIDs can be found in the Games API. Valid entries are 13096 or 13110

Props

Available Endpoints
Subfeed
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.)
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.)
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified BettingEventID.
Props
Returns the markets and available outcomes for the specified BettingEventID. A Sportsbook Group must also be specified as a URL parameter.
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID.
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.
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.
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.
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.
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.
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.
Props Plus
Returns full line movement for a specified BettingMarket. A Sportsbook Group must also be specified as a URL parameter. 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.
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.
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 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[]
 
 
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.
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-02-15, 2020-02-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[]
 
 
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.
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[]
 
 
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.
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). Valid entries include: 134, 155, etc.

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
Call Interval:
10 Minutes
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.
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). Valid entries include: 134, 155, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

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[]
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.
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). Valid entries include: 14814

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[]
 
 
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.
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). Valid entries include: 14814
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

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[]
 
 
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.
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). Valid entries include: 134, 155, etc.
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[]
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.
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). Valid entries include: 134, 155, etc.
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 grouping.
Examples: G1100

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[]
 
 
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.
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[]
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.
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 grouping.
Examples: G1100

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
 
 
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.
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 entries include: 421, 1041, etc.

Betting Market [Sportsbook Group]

Returns full line movement for a specified BettingMarket. A Sportsbook Group must also be specified as a URL parameter. 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
 
 
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.
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 entries include: 421, 1041, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

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:
15 Minutes
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.
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 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
Call Interval:
15 Minutes
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.
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.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Futures

Available Endpoints
Subfeed
Futures
Returns available Futures markets for the specified season. This endpoint does not include line movement.
Futures
Returns 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.

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[]
 
 
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.
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

Betting Futures - by Season [Sportsbook Group]

Returns 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[]
 
 
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.
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
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Available Endpoints
Subfeed
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.
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.
Matchup Stats
Returns trends data for a 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 with a specific game, though it will work for other comparisons if applicable.
Matchup Stats
Returns recent team trends and performance against betting lines in recent sets of games - Last X games.

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:
 
 
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.
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. MarketIds are pulled from the Betting Markets endpoints.

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
 
 
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.
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. GameIds are pulled from the Schedules and Games by Date endpoints.

Returns trends data for a 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 with a specific game, though it will work for other comparisons if applicable.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
MatchupTrends
 
 
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.
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.

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
 
 
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.
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
Legacy Projections
SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by date.

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:
 
 
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.
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-JAN-31, 2017-OCT-01.

Salaries, Stats & Points

Available Endpoints
Subfeed
Points & Stats
Simple fantasy points awarded to each player who took part in a game on a given date.
Salaries & Slates
Returns DFS Slates which have not yet started, with their player and salary information.

Fantasy Points - by Date

Simple fantasy points awarded to each player who took part in a game on a given date.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
FantasyGame[]
Included Data Tables:
 
 
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.
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-OCT-31, 2018-FEB-15.

DFS Slates - by Date

Returns DFS Slates which have not yet started, with their player and salary information.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlate[]
 
 
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.
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-DEC-01, 2018-FEB-15.

News & Images

Player News & Notes

Available Endpoints
Subfeed
Rotoballer News
Returns RotoBallers premium news feed (stories in greater detail), ordered by date/time.
Rotoballer News
Returns RotoBaller's premium news feed (stories in greater detail) for the specified date.

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:
 
 
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.
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 RotoBaller's premium news feed (stories in greater detail) for the specified date.
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
News[]
Included Data Tables:
 
 
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.
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: 2021-JAN-06, 2021-JAN-31.

Player Headshots

Available Endpoints
Subfeed
GET Headshots
Player Headshots
Headshots

Headshots

Headshots
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Headshot[]
Included Data Tables:
 
 
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.
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