nfl

NFL schedule rows (historical)

NFL schedule and final scores, 2020 onward. Omit season to get the newest season present; meta.resolved names the season actually served and whether it was defaulted, so the bare path always answers.

get/v1/nfl/games

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/nfl/games
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

seasoninteger

Optional; defaults to the newest season present, echoed in meta.resolved. Season LABEL, not a calendar year: the year a season STARTS in. 2025 means the 2025-26 campaign for leagues that cross the new year (EPL, NBA, NHL) and the 2025 season for those that do not (MLB, MLS, WNBA). Filtering resolves each league's own start month, so a season never spans two calendar years' worth of rows.

weekinteger
teamstring
type'REG' | 'WC' | 'DIV' | 'CON' | 'SB' | 'POST'

Round filter. REG, WC, DIV, CON and SB are the values game_type actually holds; POST is an alias matching every playoff round (WC, DIV, CON, SB).

limitinteger
offsetinteger

Response

ok

dataobject[]

Changes

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