Your web browser appears to be outdated. Our website may not look quite right in it.
Please consider using one of our preferred browsers to enjoy an optimal experience.
NBA API Documentation
This is the documentation for our NBA API. To get a more comprehensive understanding of what feeds
we have to offer and the data points we deliver via our endpoints, we encourage you to explore the following resources:
All of our API endpoints can be accessed via an HTTP GET request using your API key.
The API key can be passed either as a query parameter or using the following HTTP request header.
Ocp-Apim-Subscription-Key: {key}
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.
Returns all teams with information such as team name, city, conference, division, colors, logos, and head coach. All teams, regardless of status, will be included (i.e. All-Star Teams).
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.
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.
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.
Desired response format. Valid entries are XML or JSON.
team
string
true
The abbreviation of the requested team. Examples: PHI, BKN.
Team Profiles - All
Returns all teams with information such as team name, city, conference, division, colors, logos, and head coach. All teams, regardless of status, will be included (i.e. All-Star Teams).
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.
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.
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.
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.
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.
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.
Returns the calendar year of the current season. For leagues that span across two calendar years, the current season is defined as the calendar year in which the majority of the season falls.
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.
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.
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.
Desired response format. Valid entries are XML or JSON.
Season - Current
Returns the calendar year of the current season. For leagues that span across two calendar years, the current season is defined as the calendar year in which the majority of the season falls.
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.
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.
Returns a full schedule of games for the specified season. Includes home and away teams, date, start time, stadium, broadcast channel, game status, quarter, pre-game lines (moneyline, spread, total), and gameday information such as referees and series info.
Returns a full schedule of games for the specified season. Includes home and away teams, date, start time, stadium, broadcast channel, game status, quarter, pre-game lines (moneyline, spread, total), and gameday information such as referees and series info.
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.
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.
Returns 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.
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.
Returns 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.
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.
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.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2015-JUL-31, 2015-SEP-01.
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.
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.
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.
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.
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.
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.
Returns game by game logs for the specified team's total statistics in the specified season. And also for given number of games (either an integer or "all").
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2015, 2016.
team
string
true
The abbreviation of the requested team.
Examples: MIA, PHI.
Team Game Logs - by Season
Returns game by game logs for the specified team's total statistics in the specified season. And also for given number of games (either an integer or "all").
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.
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.
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.
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.
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.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season.
Examples: 2015, 2016.
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.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 14620, 16905, etc.
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.
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.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s).
Examples: 2015-JUL-31, 2015-SEP-01.
Box Scores Delta - by Date
Returns all stats for the specified date, only returning player stats that have changed in the last X minutes, as given in the API call. This is a live endpoint, not final, meaning that it will return data for games in progress.
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.
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.
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.
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered after the game.
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered during and after the game.
Returns all play-by-play for the specified season and week, but only returns plays that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered after the game.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 14620, 16905, etc.
Play By Play [Live & Final]
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered during and after the game.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 14620, 16905, etc.
Play By Play Delta
Returns all play-by-play for the specified season and week, but only returns plays that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Returns the non-full-game odds (spread, moneyline, total) for games on the specified date. Non-full-game means 1st half or 1st quarter, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
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.
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.
Returns the non-full-game odds (spread, moneyline, total), with line movement, for the specified game. Non-full-game means 1st half or 1st quarter, for example, rather than full game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Returns the game odds for games on the specified date. In this endpoint, both full-game and partial-game odds are included. Returns the full line movement for the specified game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
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 specified game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Returns the full-game core odds (moneyline, spread, total) for the specified game. Non-full-game means 1st half or 1st quarter, for example, rather than full 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.
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.
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.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s). Examples: 2018-06-20, 2018-06-23.
In-Game Odds - by Date [Sportsbook Group]
Returns in-play game odds (spread, moneyline, total) for games on the specified date. A Sportsbook Group must also be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
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.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s). Examples: 2018-06-20, 2018-06-23.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook 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.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 12780 or 12781
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.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 12780 or 12781
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.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 12780 or 12781
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Period Game Odds - by Date
Returns the non-full-game odds (spread, moneyline, total) for games on the specified date. Non-full-game means 1st half or 1st quarter, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
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.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s). Examples: 2018-06-20, 2018-06-23.
Pre-Game and Period Game Odds - by Date [Sportsbook Group]
Returns the full-game and non-full-game odds (spread, moneyline, total) for games on the specified date. A Sportsbook Group must be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement.
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.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s). Examples: 2018-06-20, 2018-06-23.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook 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.
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.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s). Examples: 2018-06-20, 2018-06-23.
Period Game Odds Line Movement
Returns the non-full-game odds (spread, moneyline, total), with line movement, for the specified game. Non-full-game means 1st half or 1st quarter, for example, rather than full game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 12780 or 12781
Pre-Game and Period Game Odds Line Movement [Sportsbook Group]
Returns the game odds for games on the specified date. In this endpoint, both full-game and partial-game odds are included. Returns the full line movement for the specified game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 12780 or 12781
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 specified game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
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.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of an NBA game. GameIDs can be found in the Games API. Valid entries are 12780 or 12781
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. Non-full-game means 1st half or 1st quarter, for example, rather than full 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.
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.
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.)
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.)
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.
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.
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.
Returns player props available in the specified game. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
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.
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.
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.
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.
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.
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.)
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.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s). Examples: 2020-02-15, 2020-02-23.
Betting Events - by Season
Returns BettingEvents for the specified season, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.)
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.
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.
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.
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.
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.
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.
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.
Desired response format. Valid entries are XML or JSON.
gameID
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 14814
Betting Markets - by Game [Sportsbook Group]
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID. A Sportsbook Group must also be specified as a URL parameter.
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.
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.
Desired response format. Valid entries are XML or JSON.
gameID
integer
true
The GameID of the desired game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 14814
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Betting Markets - by Market Type
Returns markets and available outcomes for the specified event and market type. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
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.
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.
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 134, 155, etc.
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include:
1 for `Game Lines`
2 for `Player Props`
3 for `Team Props`
6 for `Game Props`
Betting Markets - by Market Type [Sportsbook Group]
Retrieving lowest latency betting markets for a given game
Returns markets and available outcomes for the specified event and market type. A Sportsbook Group must also be specified as a URL parameter. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
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.
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.
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets). Valid entries include: 134, 155, etc.
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include:
1 for `Game Lines`
2 for `Player Props`
3 for `Team Props`
6 for `Game Props`
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Betting Player Props - by Game
Returns player props available in the specified game. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
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.
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.
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.
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.
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.
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.
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.
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets. Valid entries include: 421, 1041, etc.
Betting Market [Sportsbook Group]
Returns full line movement for a specified BettingMarket. A Sportsbook Group must also be specified as a URL parameter. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
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.
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets. Valid entries include: 421, 1041, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Betting Results - by Market
Returns resulting for the specified market that is supported for result. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
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.
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets. Valid entries include: 406451, 404168, etc.
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.
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.
Returns available Futures markets for the specified season. A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
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.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season Examples: 2020, 2021, etc
Betting Futures - by Season [Sportsbook Group]
Returns available Futures markets for the specified season. A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Desired response format. Valid entries are XML or JSON.
FAQ
Frequently Asked Questions
Combine live game-state and score endpoints with the appropriate box-score and player-game statistics feeds. Add play-by-play only when your product needs individual events. The NBA API documentation identifies the available endpoints and payload types.
A final buzzer does not necessarily freeze every player statistic. Keep live and final data distinct, update stored records when values change, and use completion signals before finalizing dependent workflows. See the game-status guide and NBA API reference.
Yes, with different feed selections: live game endpoints suit scoreboards, while box scores, play-by-play, and season data support richer analysis. Availability and update intervals vary by feed. Use the NBA API documentation to choose the required level of detail.