NFL

Get a single game by id

get/api/v1/nfl/games/{id}

Request

  • Base URL: https://api.stat-api.com
  • URL: https://api.stat-api.com/api/v1/nfl/games/{id}
  • Auth: HTTP bearer

Path parameters

idinteger required

Primary Key

Primary key (id) of the games row.

Response

Single games row.

attendanceinteger nullable

Reported attendance count; null when not published.

away_rotation_numberinteger nullable

Sportsbook rotation number for the away team (3-4 digit cross-book reference).

away_teamstring required

Denormalized team abbreviation for the away side at game time (snapshot copy of teams.abbreviation).

away_team_idinteger required
away_team_scoreinteger required

Final away-team score; 0 (not null) until the game completes.

channelstring nullable

Primary broadcast network/channel (e.g., CBS, FOX, Prime Video).

dayinteger required

Calendar day as a YYYYMMDD integer (e.g. 20240915), US Eastern.

end_timestring date-time nullable

Actual game end timestamp; null until the game completes.

game_labelstring nullable

Display label for special games (e.g., Thanksgiving Day, Monday Night Football).

game_sub_labelstring nullable

Secondary label or sub-category for the game.

game_timestring date-time nullable

Scheduled kickoff time (timezone-aware); null when the league published no time.

home_rotation_numberinteger nullable

Sportsbook rotation number for the home team (3-4 digit cross-book reference).

home_teamstring required

Denormalized team abbreviation for the home side at game time (snapshot copy of teams.abbreviation).

home_team_idinteger required
home_team_scoreinteger required

Final home-team score; 0 (not null) until the game completes.

idinteger required

Primary Key

league_game_idstring required

Official NFL game ID from league source

neutral_venueboolean required

True if the game is played at a neutral site (Super Bowl, international games, etc.).

overtimeboolean required

True if the game went to overtime.

overtime_periodsinteger nullable

Number of overtime periods played (1+ when overtime is true).

playoff_roundstring nullable

Postseason round (WildCard, Divisional, Conference Championship, Super Bowl); null outside the postseason.

playoff_seed_awayinteger nullable

Away-team playoff seed (1-7); null outside the postseason.

playoff_seed_homeinteger nullable

Home-team playoff seed (1-7); null outside the postseason.

postponed_statusstring nullable

Reason for postponement (e.g., Weather, COVID); null for games played as scheduled.

season_idinteger required
season_typestring required

Canonical season phase. Postseason round detail (Wild Card / Divisional / Conference Championship / Super Bowl) lives in playoff_round.

stadium_idinteger required

Stadium hosting the game (FK to stadiums).

statusstring required

Game status. Currently always Scheduled (status reconciliation is pending) — detect completed games via populated scores, not this field.

time_tbdboolean required

True when the league has not set the kickoff time yet; game_time then holds a provisional Sunday 1:00 PM ET of the game's week, not a real kickoff.

typestring required

Game classification (Regular, Playoff, Super Bowl, Preseason).

weekinteger required

Week number within the season stage — 1-18 for regular season, restarting at 1 in the postseason (1 Wild Card, 2 Divisional, 3 Conference Championship, 4 Super Bowl). Note nfl.injuries.week uses the continuous 19-22 convention instead.

Changes

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