{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "#/components/schemas/Score", "title": "Score", "properties": { "GameKey": { "type": [ "string", "null" ], "description": "A 9 digit unique code identifying the game that this record corresponds to. The GameID is composed of Season; SeasonType; Week and HomeTeam. Note: This value will be NULL for bye weeks" }, "SeasonType": { "type": "integer", "description": "The type of season that this game corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star)." }, "Season": { "type": "integer", "description": "The NFL season of the game" }, "Week": { "type": "integer", "description": "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" }, "Date": { "type": [ "string", "null" ], "description": "The date and time of the game (in US Eastern Time)" }, "AwayTeam": { "type": [ "string", "null" ], "description": "The abbreviation [Key} of the away team" }, "HomeTeam": { "type": [ "string", "null" ], "description": "The abbreviation [Key] of the home team" }, "AwayScore": { "type": [ "integer", "null" ], "description": "The final score of the Away Team" }, "HomeScore": { "type": [ "integer", "null" ], "description": "The final score of the Home Team" }, "Channel": { "type": [ "string", "null" ], "description": "The television station broadcasting the game" }, "PointSpread": { "type": [ "number", "null" ], "description": "The oddsmaker point spread at game start from the perspective of the team (negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored)" }, "OverUnder": { "type": [ "number", "null" ], "description": "The total points line (over/under) at game start" }, "Quarter": { "type": [ "string", "null" ], "description": "The current quarter of the game (1, 2, 3, 4, HALF, OT, F, F/OT or NULL if game has not yet started)" }, "TimeRemaining": { "type": [ "string", "null" ], "description": "The amount of time remaining in the current quarter (e.g. 11:23; 5:34; NULL if game is not in progress or at halftime)" }, "Possession": { "type": [ "string", "null" ], "description": "The team that currently has possession of the ball (Ex. PHI; NE; NULL if game is not in progress or at halftime)" }, "Down": { "type": [ "integer", "null" ], "description": "The current down in the game (1, 2, 3, 4 or NULL)" }, "Distance": { "type": [ "string", "null" ], "description": "The yards to go for a first down (this can be any positive number or \"Goal\")" }, "YardLine": { "type": [ "integer", "null" ], "description": "the yard line of the ball's current position on the field as of the most recently completed play" }, "YardLineTerritory": { "type": [ "string", "null" ], "description": "The team's side of the field that the ball is on when the play occurred" }, "RedZone": { "type": [ "string", "null" ], "description": "The team abbreviation [Key] that currently has the ball in the opponent's red zone (Ex: \"SF\"; \"BAL\" or NULL)" }, "AwayScoreQuarter1": { "type": [ "integer", "null" ], "description": "Points scored by the away team in Quarter 1" }, "AwayScoreQuarter2": { "type": [ "integer", "null" ], "description": "Points scored by the away team in Quarter 2" }, "AwayScoreQuarter3": { "type": [ "integer", "null" ], "description": "Points scored by the away team in Quarter 3" }, "AwayScoreQuarter4": { "type": [ "integer", "null" ], "description": "Points scored by the away team in Quarter 4" }, "AwayScoreOvertime": { "type": [ "integer", "null" ], "description": "Points scored by the away team in overtime" }, "HomeScoreQuarter1": { "type": [ "integer", "null" ], "description": "Points scored by the home team in Quarter 1" }, "HomeScoreQuarter2": { "type": [ "integer", "null" ], "description": "Points scored by the home team in Quarter 2" }, "HomeScoreQuarter3": { "type": [ "integer", "null" ], "description": "Points scored by the home team in Quarter 3" }, "HomeScoreQuarter4": { "type": [ "integer", "null" ], "description": "Points scored by the home team in Quarter 4" }, "HomeScoreOvertime": { "type": [ "integer", "null" ], "description": "Points scored by the home team in overtime" }, "HasStarted": { "type": "boolean", "description": "Whether the game has started (true/false)" }, "IsInProgress": { "type": "boolean", "description": "Whether the game is currently in progress (true/false)" }, "IsOver": { "type": "boolean", "description": "Whether the game is over (true/false)" }, "Has1stQuarterStarted": { "type": "boolean", "description": "Whether the 1st quarter has started" }, "Has2ndQuarterStarted": { "type": "boolean", "description": "Whether the 2nd quarter has started" }, "Has3rdQuarterStarted": { "type": "boolean", "description": "Whether the 3rd quarter has started" }, "Has4thQuarterStarted": { "type": "boolean", "description": "Whether the 4th quarter has started" }, "IsOvertime": { "type": "boolean", "description": "Whether this game went into overtime" }, "DownAndDistance": { "type": [ "string", "null" ], "description": "The description of the down and distance for display purposes" }, "QuarterDescription": { "type": [ "string", "null" ], "description": "Description of the current quarter for display purposes" }, "StadiumID": { "type": [ "integer", "null" ], "description": "The unique ID of the team's current home stadium" }, "LastUpdated": { "type": [ "string", "null" ], "description": "The date and time that this game was last updated (in US Eastern Time)" }, "GeoLat": { "type": [ "number", "null" ], "description": "The geographic latitude coordinate of the venue where the game is taking place" }, "GeoLong": { "type": [ "number", "null" ], "description": "The geographic longitude coordinate of the venue where the game is taking place" }, "ForecastTempLow": { "type": [ "integer", "null" ], "description": "The forecasted low temperature on game day at this venue (Fahrenheit)" }, "ForecastTempHigh": { "type": [ "integer", "null" ], "description": "The forecasted high temperature on game day at this venue (Fahrenheit)" }, "ForecastDescription": { "type": [ "string", "null" ], "description": "The forecast description on game day at this venue." }, "ForecastWindChill": { "type": [ "integer", "null" ], "description": "The forecasted wind chill on game day at this venue." }, "ForecastWindSpeed": { "type": [ "integer", "null" ], "description": "The forecasted wind speed on game day at this venue." }, "AwayTeamMoneyLine": { "type": [ "integer", "null" ], "description": "The sportsbook's moneyline for the away team" }, "HomeTeamMoneyLine": { "type": [ "integer", "null" ], "description": "The sportsbook's moneyline for the home team" }, "Canceled": { "type": [ "boolean", "null" ], "description": "Indicates whether the game was canceled" }, "Closed": { "type": [ "boolean", "null" ], "description": "Indicates whether the game is over and the final score has been verified and closed out. Note: it is recommend for bet resulting to use IsClosed = True rather than simply Final game status" }, "LastPlay": { "type": [ "string", "null" ], "description": "The description of the most recent play/event of the game. Note: This is for display purposes and does not include corresponding data points" }, "Day": { "type": [ "string", "null" ], "description": "The date of the game (in US Eastern Time)" }, "DateTime": { "type": [ "string", "null" ], "description": "The date and time of the game (in US Eastern Time)" }, "AwayTeamID": { "type": [ "integer", "null" ], "description": "The unique ID of the away team" }, "HomeTeamID": { "type": [ "integer", "null" ], "description": "The unique ID of the home team" }, "GlobalGameID": { "type": [ "integer", "null" ], "description": "A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues" }, "GlobalAwayTeamID": { "type": [ "integer", "null" ], "description": "A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues" }, "GlobalHomeTeamID": { "type": [ "integer", "null" ], "description": "A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues" }, "PointSpreadAwayTeamMoneyLine": { "type": [ "integer", "null" ], "description": "The payout on the away team's spread" }, "PointSpreadHomeTeamMoneyLine": { "type": [ "integer", "null" ], "description": "The payout on the home team's spread" }, "ScoreID": { "type": "integer", "description": "Unique ID of the Score/Game" }, "StadiumDetails": { "$ref": "#/components/schemas/Stadium", "description": "The details of the stadium where this game is played" }, "Status": { "type": [ "string", "null" ], "description": "The status of the game. For a description of possible values, see here. For how suspended and postponed games are handled specifically, see here." }, "GameEndDateTime": { "type": [ "string", "null" ], "description": "The date and time of when the game officially ended. Note: This field is populated after the game and score are finalized" }, "HomeRotationNumber": { "type": [ "integer", "null" ], "description": "Rotation number of home team in this game" }, "AwayRotationNumber": { "type": [ "integer", "null" ], "description": "Rotation number of away team in this game" }, "NeutralVenue": { "type": [ "boolean", "null" ], "description": "Indicates whether this game is played in a neutral venue" }, "RefereeID": { "type": [ "integer", "null" ], "description": "The unique ID of the head referee" }, "OverPayout": { "type": [ "integer", "null" ], "description": "The sportsbook's payout for over the total points line" }, "UnderPayout": { "type": [ "integer", "null" ], "description": "The sportsbook's payout for the under" }, "HomeTimeouts": { "type": [ "integer", "null" ], "description": "The number of timeouts remaining for the Home Team" }, "AwayTimeouts": { "type": [ "integer", "null" ], "description": "The number of timeouts remaining for the Away Team" }, "DateTimeUTC": { "type": [ "string", "null" ], "description": "The date and time of the game (in UTC)" }, "Attendance": { "type": "integer", "description": "The total attendance for the game" }, "IsClosed": { "type": [ "boolean", "null" ], "description": "Indicates whether the game is over and the final score has been verified and closed out." } } }