--- title: "Pre-Game Odds - by Date" method: GET path: "/v3/nba/odds/{format}/GameOddsByDate/{date}" tags: ["NBA v3 Odds"] --- # Pre-Game Odds - by Date `GET /v3/nba/odds/{format}/GameOddsByDate/{date}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nba/odds/{format}/GameOddsByDate/{date}` - Auth: one of: - API key in header `Ocp-Apim-Subscription-Key` - API key in query parameter `key` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns full game odds (spread, moneyline, total) for games on a given date. Only returns the most recently seen odds, not inclusive of line movement. ## Path parameters - `format` 'JSON' | 'XML', required - `date` string, required ## Response `200` Success - GameInfo[] - `GameId` integer: The unique ID of the game. - `Season` integer: The NBA season of the game - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition) - `Day` string, nullable: The day of the game - `DateTime` string, nullable: The date and time of the game - `Status` string, nullable: The status of the game. For a description of possible values, see here. For how suspended and postponed games are handled specifically, see here. - `AwayTeamId` integer, nullable: The unique ID of the away team - `HomeTeamId` integer, nullable: The unique ID of the home team - `AwayTeamName` string, nullable: The abbreviation [Key] of the away team - `HomeTeamName` string, nullable: The abbreviation [Key] of the home team - `GlobalGameId` integer: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues. - `GlobalAwayTeamId` integer, nullable: The rotation number of the home team for this game - `GlobalHomeTeamId` integer, nullable: A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues. - `PregameOdds` GameOdd[]: List of Pregame GameOdds from different sportsbooks - `GameOddId` integer: The unique ID of this odd - `Sportsbook` string, nullable: Name of sportsbook - `GameId` integer: The unique ID of the game associated with this GameOdd - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time) - `Updated` string, nullable: The timestamp of when these odds were last updated (US Eastern Time). If these are the latest odds for this game; and they have not been updated within the last few minutes; then it indicates that there were problems connecting to the sportsbook - `HomeMoneyLine` integer, nullable: The sportsbook's money line for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's money line for the away team - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team - `OverUnder` number, nullable: The sportsbook's total points scored over under for the game - `OverPayout` integer, nullable: The sportsbook's payout for the over - `UnderPayout` integer, nullable: The sportsbook's payout for the under - `SportsbookId` integer, nullable: Unique ID of the Sportsbook - `OddType` string, nullable: The market type of the odd (ex: live, pregame, 1st-half, 2nd-quarter) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (in US Eastern Time) - `LiveOdds` GameOdd[]: List of Live GameOdds from different sportsbooks - `GameOddId` integer: The unique ID of this odd - `Sportsbook` string, nullable: Name of sportsbook - `GameId` integer: The unique ID of the game associated with this GameOdd - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time) - `Updated` string, nullable: The timestamp of when these odds were last updated (US Eastern Time). If these are the latest odds for this game; and they have not been updated within the last few minutes; then it indicates that there were problems connecting to the sportsbook - `HomeMoneyLine` integer, nullable: The sportsbook's money line for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's money line for the away team - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team - `OverUnder` number, nullable: The sportsbook's total points scored over under for the game - `OverPayout` integer, nullable: The sportsbook's payout for the over - `UnderPayout` integer, nullable: The sportsbook's payout for the under - `SportsbookId` integer, nullable: Unique ID of the Sportsbook - `OddType` string, nullable: The market type of the odd (ex: live, pregame, 1st-half, 2nd-quarter) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (in US Eastern Time) - `HomeTeamScore` integer, nullable: Total points scored by the home team in the game (updated after the game ends to allow for resolving bets) - `AwayTeamScore` integer, nullable: Total number of points the away team scored in the game (updated after game ends to allow for resolving bets) - `TotalScore` integer, nullable: The total amount of points scored in the game by both teams. Updated after the game ends to allow for resulting bets - `HomeRotationNumber` integer, nullable: The Rotation number of the home team for this game - `AwayRotationNumber` integer, nullable: The rotation number of the away team for this game - `AlternateMarketPregameOdds` GameOdd[]: A list of Alternate Market Pregame GameOdds from different sportsbooks (such as 1st-half; 1st-qtr; etc) - `GameOddId` integer: The unique ID of this odd - `Sportsbook` string, nullable: Name of sportsbook - `GameId` integer: The unique ID of the game associated with this GameOdd - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time) - `Updated` string, nullable: The timestamp of when these odds were last updated (US Eastern Time). If these are the latest odds for this game; and they have not been updated within the last few minutes; then it indicates that there were problems connecting to the sportsbook - `HomeMoneyLine` integer, nullable: The sportsbook's money line for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's money line for the away team - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team - `OverUnder` number, nullable: The sportsbook's total points scored over under for the game - `OverPayout` integer, nullable: The sportsbook's payout for the over - `UnderPayout` integer, nullable: The sportsbook's payout for the under - `SportsbookId` integer, nullable: Unique ID of the Sportsbook - `OddType` string, nullable: The market type of the odd (ex: live, pregame, 1st-half, 2nd-quarter) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (in US Eastern Time) ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/nba-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nba-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nba-api/revisions/30672152476c?raw)