--- title: "Pre-Game Odds - by Week" method: GET path: "/v3/nfl/odds/{format}/GameOddsByWeek/{season}/{week}" tags: ["NFL v3 Odds"] --- # Pre-Game Odds - by Week `GET /v3/nfl/odds/{format}/GameOddsByWeek/{season}/{week}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nfl/odds/{format}/GameOddsByWeek/{season}/{week}` - 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 the full-game core odds for games in a given week & season. This means moneyline, spread, and total. Only returns the most recently seen odds, not-including line movement. ## Path parameters - `format` 'JSON' | 'XML', required - `season` string, required - `week` string, required ## Response `200` Success - GameInfo[] - `ScoreId` integer: Unique ID of the score/game - `Season` integer: The year of the season during which this game occurs. - `SeasonType` integer: The type of season that this game corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star). - `Week` integer, nullable: The NFL week of the game (regular season: 1 to 18; preseason: 0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3 preseason weeks - `Day` string, nullable: The date of the game (in US Eastern Time) - `DateTime` string, nullable: The date and time of the game (in US Eastern Time) - `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 name of the away team - `HomeTeamName` string, nullable: The name 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: A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues - `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 Odds from different sportsbooks - `GameOddId` integer: The unique ID of this odd - `Sportsbook` string, nullable: Name of sportsbook - `ScoreId` integer: Unique ID of the score/game - `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, based on US Eatern Time (EST/EDT). 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 moneyline for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team - `DrawMoneyLine` integer, nullable: The sportsbook's moneyline for a draw - `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 over the total points line - `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 this odd (ex: live, pregame, 1st-half, 1st-qtr, etc) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `GameId` integer: The unique ID of this game - `Unlisted` string, nullable: The datetime the outcome was unlisted (no longer available for bets) in US eastern time - `LiveOdds` GameOdd[]: List of Live Odds from different sportsbooks - `GameOddId` integer: The unique ID of this odd - `Sportsbook` string, nullable: Name of sportsbook - `ScoreId` integer: Unique ID of the score/game - `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, based on US Eatern Time (EST/EDT). 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 moneyline for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team - `DrawMoneyLine` integer, nullable: The sportsbook's moneyline for a draw - `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 over the total points line - `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 this odd (ex: live, pregame, 1st-half, 1st-qtr, etc) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `GameId` integer: The unique ID of this game - `Unlisted` string, nullable: The datetime the outcome was unlisted (no longer available for bets) in US eastern time - `HomeTeamScore` integer, nullable: Score of the home team (updated after game ends to allow for resolving bets) - `AwayTeamScore` integer, nullable: Score of the away team (updated after game ends to allow for resolving bets) - `TotalScore` integer, nullable: The total points scored by both teams in the game tied to this event (updated after game ends to allow for resulting bets) - `HomeRotationNumber` integer, nullable: Rotation Number of home team in this game - `AwayRotationNumber` integer, nullable: Rotation Number of away team in this game - `AlternateMarketPregameOdds` GameOdd[]: List of Alternate Market Pregame Odds from different sportsbooks - `GameOddId` integer: The unique ID of this odd - `Sportsbook` string, nullable: Name of sportsbook - `ScoreId` integer: Unique ID of the score/game - `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, based on US Eatern Time (EST/EDT). 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 moneyline for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team - `DrawMoneyLine` integer, nullable: The sportsbook's moneyline for a draw - `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 over the total points line - `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 this odd (ex: live, pregame, 1st-half, 1st-qtr, etc) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `GameId` integer: The unique ID of this game - `Unlisted` string, nullable: The datetime the outcome was unlisted (no longer available for bets) in US eastern time - `GameId` integer: The unique ID of this game ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/nfl-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nfl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nfl-api/revisions/2dca8b6e9675?raw)