---
title: "NFL schedule rows (historical)"
method: GET
path: "/v1/nfl/games"
tags: ["nfl"]
---

# NFL schedule rows (historical)

`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

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.

## Query parameters

- `season` integer
- `week` integer
- `team` string
- `type` 'REG' | 'WC' | 'DIV' | 'CON' | 'SB' | 'POST'
- `limit` integer
- `offset` integer

## Response `200`

ok

- object
  - `data` object[]
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `offset` integer

---

[API](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api.md) · [All operations](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/revisions/31fb54ac414e?raw)