SPsportsdata
NFL v3 Odds

Pre-Game Odds - by Week

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.

get/v3/nfl/odds/{format}/GameOddsByWeek/{season}/{week}

Request

Path parameters

format'JSON' | 'XML' required

Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.

seasonstring required

Year of the season, with optional season type. <br>Examples: <code>2018</code>, <code>2018POST</code>, etc.

weekstring required

The week of the scores (games). <br>Examples: <code>1</code>, <code>2</code>, etc.

Response

Success

ScoreIdinteger

Unique ID of the score/game

Seasoninteger

The year of the season during which this game occurs.

SeasonTypeinteger

The type of season that this game corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star).

Weekinteger 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

Daystring nullable

The date of the game (in US Eastern Time)

DateTimestring nullable

The date and time of the game (in US Eastern Time)

Statusstring nullable

The status of the game. For a description of possible values, see <a href="https://sportsdata.io/help/faq#what-are-all-of-the-game-statuses-used-across-sports" target="_blank">here.</a> For how suspended and postponed games are handled specifically, see <a href="https://sportsdata.io/help/faq#how-do-you-handle-postponed-suspended-and-canceled-games" target="_blank">here</a>.

AwayTeamIdinteger nullable

The unique ID of the away team

HomeTeamIdinteger nullable

The unique ID of the home team

AwayTeamNamestring nullable

The name of the away team

HomeTeamNamestring nullable

The name of the home team.

GlobalGameIdinteger

A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues

GlobalAwayTeamIdinteger nullable

A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues

GlobalHomeTeamIdinteger nullable

A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues

HomeTeamScoreinteger nullable

Score of the home team (updated after game ends to allow for resolving bets)

AwayTeamScoreinteger nullable

Score of the away team (updated after game ends to allow for resolving bets)

TotalScoreinteger nullable

The total points scored by both teams in the game tied to this event (updated after game ends to allow for resulting bets)

HomeRotationNumberinteger nullable

Rotation Number of home team in this game

AwayRotationNumberinteger nullable

Rotation Number of away team in this game

GameIdinteger

The unique ID of this game

Changes

No recorded changes to this operation across all 2 revisions of this API.