College Basketball API Documentation

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

Coverage
Workflow Guide
Data Dictionary
Help Center

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

  • JSON
  • XML

Competition Feeds

Standings, Rankings & Brackets

Available Endpoints
Subfeed
GET League Hierarchy
Standings, Rankings & Brackets
Returns all conference information, including season records and rankings for each team, along with team logos and stadium information.
Conference Stadium Team

League Hierarchy

Returns all conference information, including season records and rankings for each team, along with team logos and stadium information.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Conference[]
Included Data Tables:
Conference Stadium Team
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/LeagueHierarchy
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.

Teams, Players & Rosters

Available Endpoints
Subfeed
GET Player Details - by Active
Teams, Players & Rosters
Returns all players on a team, including biographical information, jersey number, position, and class.
PlayerBasic
GET Player Profiles - by Team
Teams, Players & Rosters
Returns players on the specified team, including biographical information, jersey number, position, class, and injury information.
PlayerBasic
GET Team Profiles - All
Teams, Players & Rosters
Returns all schools and their team name, logo, conference, home stadium, AP Ranking, wins, losses, conference wins, and conference losses.
Stadium Team
GET Teams (Basic) - All
Teams, Players & Rosters
Returns all schools with their mascot name, logo, conference, and stadium.
Stadium TeamBasic

Player Details - by Active

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

Player Profiles - by Team

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

Team Profiles - All

Returns all schools and their team name, logo, conference, home stadium, AP Ranking, wins, losses, conference wins, and conference losses.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
Stadium Team
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/teams
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Teams (Basic) - All

Returns all schools with their mascot name, logo, conference, and stadium.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamBasic[]
Included Data Tables:
Stadium TeamBasic
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/TeamsBasic
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.

Venues & Officials

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

Stadiums

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

Utility Endpoints

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

Are Games In Progress

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

Betting Metadata

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

Season - Current

Returns the calendar year of the current season. For leagues/sports 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:
Season
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/CurrentSeason
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Sportsbooks - by Active

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

Event Feeds

Schedules & Game Day Info

Available Endpoints
Subfeed
GET Games - by Season
Schedules & Game Day Info
Returns all games in a specified season.
Game Period Stadium
GET Schedules - by Team
Schedules & Game Day Info
Returns all of a given team's games for the specified season.
Game Period Stadium
GET Schedules (Basic)
Schedules & Game Day Info
Returns the full schedule for a specified season without gameday information. Only includes home and away teams, the date and time of the game, and season type etc.
ScheduleBasic

Games - by Season

Returns all games in a specified season.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Game[]
Included Data Tables:
Game Period Stadium
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.
GET https://api.sportsdata.io/v3/cbb/scores/json/Games/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type).
Examples: 2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.

Schedules - by Team

Returns all of a given team's games for the specified season.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
Game[]
Included Data Tables:
Game Period Stadium
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/TeamSchedule/{season}/{team}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type).
Examples: 2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.
team
string
true
The abbreviation of the requested team. Examples: SF, NYY.

Schedules (Basic)

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

Scores & Game State

Available Endpoints
Subfeed
GET Games - by Date [Final]
Final Only (No Game State)
Returns full game scores and gameday info (including half-time scores) for a specified date once each game is completed.
Game Period Stadium
GET Games - by Season [Final]
Final Only (No Game State)
Returns full game scores and gameday info (including half-time scores) for the specified season once each game is completed.
Game Period Stadium
GET Games - by Date [Live & Final]
Live & Final (With Game State)
Returns live and final scores for all games on the specified date. Includes stadium, attendance, broadcast channel, game status, pre-game lines (moneyline, spread, total), and quarter-by-quarter scores.
Game Period Stadium
GET Games (Basic) - by Date
Live & Final (With Game State)
Returns scores for all games on the specified date.
ScoreBasic
GET Tournament Hierarchy
Live & Final (With Game State)
Returns live and final game scores along with gameday info (including half-time scores) for the specified season.
Game Period Stadium Tournament

Games - by Date [Final]

This is the Final version of this endpoint. For live data, please use Games - by Date [Live & Final].
Returns full game scores and gameday info (including half-time scores) for a specified date once each game is completed.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
Game Period Stadium
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/GamesByDateFinal/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-FEB-27, 2017-DEC-01.

Games - by Season [Final]

Returns full game scores and gameday info (including half-time scores) for the specified season once each game is completed.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Game[]
Included Data Tables:
Game Period Stadium
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/GamesFinal/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type).
Examples: 2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.

Games - by Date [Live & Final]

Retrieving up-to-the-second high-level game information, such as scores and game status.
Returns live and final scores for all games on the specified date. Includes stadium, attendance, broadcast channel, game status, pre-game lines (moneyline, spread, total), and quarter-by-quarter scores.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
Game Period Stadium
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.
GET https://api.sportsdata.io/v3/cbb/scores/json/GamesByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-FEB-27, 2017-DEC-01.

Games (Basic) - by Date

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

Tournament Hierarchy

Returns live and final game scores along with gameday info (including half-time scores) for the specified season.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
Tournament
Included Data Tables:
Game Period Stadium Tournament
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/Tournament/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2018, 2019.

Team & Player Stats

Available Endpoints
Subfeed
GET Box Score [Final]
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.
BoxScore Game Period PlayerGame Stadium TeamGame
GET Box Scores - by Date [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.
BoxScore Game Period PlayerGame Stadium TeamGame
GET Player Game Logs - by Season
Final Only
Returns a specified players box score logs for the specified season and number of games. Data is updated following the most recent games.
PlayerGame
GET Player Game Stats - by Date [Final]
Final Only
Returns box score stats for all players that participated in a game on the specified date. Data is added for players once their respective game concludes.
PlayerGame
GET Player Season Stats
Final Only
Returns season-long stats for all players on a team for the specified season.
PlayerSeason
GET Player Season Stats - by Team
Final Only
Returns season-long stats for players on the specified team within the specified season.
PlayerSeason
GET Team Game Logs By Season
Final Only
Returns game by game logs for the specified team's total statistics in the specified season. And also for a given number of games (either an integer or "all").
TeamGame
GET Team Game Stats - by Date [Final]
Final Only
Returns the box score statistical record team-wide (aggregated from all players) for all games on a given date, updated as each game concludes.
TeamGame
GET Team Season Stats
Final Only
Returns season-long stats (aggregated from player stats) for a specified team in the specified season.
TeamSeason
GET Box Score [Live & Final]
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.
BoxScore Game Period PlayerGame Stadium TeamGame
GET Box Scores - by Date [Live & 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.
BoxScore Game Period PlayerGame Stadium TeamGame
GET Box Scores Delta - by Date
Live & Final
Returns all stats for the specified date, only returning player stats that have changed in the last X minutes, as given in the API call. This is a live endpoint, not final, meaning that it will return data for games in progress.
BoxScore Game Period PlayerGame Stadium TeamGame
GET Player Game Stats - by Date [Live & Final]
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.
PlayerGame
GET Team Game Stats - by Date [Live & Final]
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.
TeamGame

Box Score [Final]

This is the Final version of this endpoint. For live data, please use Box Score [Live & Final].
Returns all statistics for 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
Included Data Tables:
BoxScore Game Period PlayerGame Stadium TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/stats/json/BoxScoreFinal/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an CBB 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[]
Included Data Tables:
BoxScore Game Period PlayerGame Stadium TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/stats/json/BoxScoresFinal/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-FEB-27, 2017-DEC-01.

Player Game Logs - by Season

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

Player Season Stats

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

Player Season Stats - by Team

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

Team Game Logs By Season

Returns game by game logs for the specified team's total statistics in the specified season. And also for a given number of games (either an integer or "all").
Endpoint Notes
Call Interval:
1 Hour
Return Type:
TeamGame[]
Included Data Tables:
TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/TeamGameStatsBySeason/{season}/{teamid}/{numberofgames}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Season to get games from. Example 2019POST, 2020
teamid
integer
true
Unique ID of team. Example 1
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 the box score statistical record team-wide (aggregated from all players) for all games on a given date, updated as each game concludes.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamGame[]
Included Data Tables:
TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/stats/json/TeamGameStatsByDateFinal/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-FEB-27, 2017-DEC-01.

Team Season Stats

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

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
Included Data Tables:
BoxScore Game Period PlayerGame Stadium TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/stats/json/BoxScore/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an CBB 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[]
Included Data Tables:
BoxScore Game Period PlayerGame Stadium TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/stats/json/BoxScores/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-FEB-27, 2017-DEC-01.

Box Scores Delta - by Date

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

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:
TeamGame
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/TeamGameStatsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-FEB-27, 2017-DEC-01.

Player Feeds

Depth Charts, Lineups & Injuries

Available Endpoints
Subfeed
GET Player Details - by Active
Depth Charts, Lineups & Injuries
Returns all players on a team, including biographical information, jersey number, position, class, and injury information.
Player
GET Player Details - by Injured
Depth Charts, Lineups & Injuries
Returns all injured players with their injury status, injury start date, injury body part, and injury note.
Player
GET Player Details - by Team
Depth Charts, Lineups & Injuries
Returns all players on the specified team, including biographical information, jersey number, position, class, and injury information.
Player

Player Details - by Active

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

Player Details - by Injured

Returns all injured players with their injury status, injury start date, injury body part, and injury note.
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
Player[]
Included Data Tables:
Player
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/scores/json/InjuredPlayers
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Player Details - by Team

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

Betting Feeds

Game Lines

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

In-Game Odds - by Date

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

In-Game Odds - by Date [Sportsbook Group]

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

In-Game Odds Line Movement [Sportsbook Group]

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

Alternate Market Pre-Game Odds - by Date

Returns the non-full-game odds for games on a given date. This means odds such as 1st-half, rather than full game. Only returns the most recently seen odds, not-including line movement.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/AlternateMarketGameOddsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-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:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/PreGameOddsByDate/{date}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-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:
GameInfo GameOdd
Ideal For:
Receiving the most recent pre-game odds across a variety of sportsbooks
Not Ideal For:
Retrieving line movement (Use Pre-Game Odds Line Movement instead)
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/GameOddsByDate/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2018-11-20, 2018-11-23.

Alternate Market Pre-Game Odds Line Movement

Returns the non-full-game odds for games in a given GameID. This means odds such as 1st-half, 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:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/AlternateMarketGameOddsLineMovement/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an CBB game. GameIDs can be found in the Games API. Valid entries are 17775 or 17776

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:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/PreGameOddsLineMovement/{gameid}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an CBB game. GameIDs can be found in the Games API. Valid entries are 17775 or 17776
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[]
Included Data Tables:
GameInfoResult GameOddOutcome GameOddResult Period
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/PreGameOddsLineMovementWithResulting/{gameid}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an CBB game. GameIDs can be found in the Games API. Valid entries are 17775 or 17776
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:
GameInfo GameOdd
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/GameOddsLineMovement/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an CBB game. GameIDs can be found in the Games API. Valid entries are 17775 or 17776

Props

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

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

To ensure best performance, all betting odds older than 30 days are stored in our Historical API data warehouse. See our Historical Data Guide for more information.
Betting Props - by Season [Sportsbook Group] [Archive]
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingMarket
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/archive/json/BettingPropsArchive/{season}/{bettingMarketId}/{sportsbookGrouping}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season
Examples: 2020, 2021, etc.
bettingMarketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookGrouping
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Events - by Date

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

Betting Events - by Season

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

Betting Markets - by Event

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

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

Possible values include:

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

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

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

Betting Markets - by Event [Sportsbook Group]

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

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

Possible values include:

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

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

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
sportsbookgroup
string
true
Access Required
The name of the Sportsbook 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[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
Ideal For:
Receiving a high-level view of all betting markets offered for a game
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/BettingMarketsByGameID/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

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

Possible values include:

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

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

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

Betting Markets - by Game [Sportsbook Group]

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

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

Possible values include:

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

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

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets).
sportsbookgroup
string
true
Access Required
The name of the Sportsbook 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[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/BettingMarketsByMarketType/{eventId}/{marketTypeID}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
include
string
false
  • available
  • unlisted
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.

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

Possible values include:

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

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

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

Betting Markets - by Market Type [Sportsbook Group]

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

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

Possible values include:

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

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

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

Betting Player Props - by Game

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

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

Possible values include:

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

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

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

Betting Player Props - by Game [Sportsbook Group]

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

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

Possible values include:

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

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

URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
gameId
integer
true
The unique GameID of the game in question.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook 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
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/BettingMarket/{marketId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.

Betting Market [Sportsbook Group]

Returns full line movement for 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
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/BettingMarket/{marketId}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
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
Included Data Tables:
BettingMarketResult BettingOutcomeResult
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/BettingMarketResults/{marketId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
BettingMarketID of the market for which you would like to see resulted outcomes. Valid example ID 96401, 93518

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
Included Data Tables:
BettingMarketResult BettingOutcomeResult
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/BettingResultsByMarket/{marketId}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
marketId
string
true
BettingMarketID of the market for which you would like to see resulted outcomes. Valid example ID 96401, 93518
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Futures

Available Endpoints
Subfeed
GET Betting Futures - by Season [Sportsbook Group] [Archive]
SportsDataIO API Historical
Betting Futures - by Season [Sportsbook Group] [Archive]
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Futures - by Season
Futures
Returns available Futures markets for the specified season (BettingMarkets that are open for betting at a particular time). This endpoint does not include line movement.
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Futures - by Season [Sportsbook Group]
Futures
Returns available Futures markets for the specified season (BettingMarkets that are open for betting at a particular time). A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook

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

To ensure best performance, all betting odds older than 30 days are stored in our Historical API data warehouse. See our Historical Data Guide for more information.
Betting Futures - by Season [Sportsbook Group] [Archive]
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingMarket
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/archive/json/BettingFuturesArchive/{season}/{bettingMarketId}/{sportsbookGrouping}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season
Examples: 2020, 2021, etc.
bettingMarketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookGrouping
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Futures - by Season

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

Betting Futures - by Season [Sportsbook Group]

Returns available Futures markets for the specified season (BettingMarkets that are open for betting at a particular time). A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
BettingEvent[]
Included Data Tables:
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/BettingFuturesBySeason/{season}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season
Examples: 2020, 2021, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Available Endpoints
Subfeed
GET Betting Splits - by Betting Market
Betting Splits
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified market. This endpoint will return the movement from this market as well as the most recent.
BettingMarketSplit BettingSplit
GET Betting Splits - by Game
Betting Splits
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified game. This endpoint will return the movement from this market as well as the most recent.
BettingMarketSplit BettingSplit GameBettingSplit
GET Betting Trends - by Matchup
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.
Game MatchupTrends Period Stadium TeamGameTrends TeamTrends
GET Betting Trends - by Team
Matchup Stats
Returns recent team trends and performance against betting lines in recent sets of games - Last X games.
Game Period Stadium TeamGameTrends TeamTrends

Betting Splits - by Betting Market

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

Betting Trends - by Matchup

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
Included Data Tables:
Game MatchupTrends Period Stadium TeamGameTrends TeamTrends
 
 
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
GET https://api.sportsdata.io/v3/cbb/odds/json/MatchupTrends/{team}/{opponent}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
team
string
true
The abbreviation of the requested team.
Examples: OU, UK.
opponent
string
true
The abbreviation of the requested opponent.
Examples: OU, UK.

Betting Trends - by Team

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