nfl

NFL season rosters

Season rosters for all 32 teams, 2020 through 2026: 21,795 rows. Keyed on the same gsis-format player_id as /v1/nfl/players/{id}/stats, so joining weekly statistics to a season roster needs no id reconciliation.

SCOPE: a row is the published snapshot for that SEASON, not a point-in-time roster for a given week. status carries the roster designation as published (ACT, RES, DEV, CUT, ...). 2026 rows exist and describe the upcoming season.

Omitting season resolves to the newest season present; the resolved value and whether it was defaulted are echoed in meta.resolved.

get/v1/nfl/rosters

Request

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

Query parameters

seasoninteger

Season LABEL: the year the season starts in. Defaults to the newest season present.

teamstring

Team abbreviation, case-insensitive (e.g. DET).

positionstring

Position code, case-insensitive (e.g. QB).

statusstring

Roster status as published (ACT, RES, DEV, ...).

player_idstring

NFL player id (gsis format), e.g. "00-0033106".

limitinteger
offsetinteger

Response

ok

Example response

{
  "data": [
    {
      "season": 2025,
      "team": "DET",
      "player_id": "00-0033106",
      "player_name": "Jared Goff",
      "position": "QB",
      "status": "ACT"
    }
  ]
}

Changes

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