nfl

NFL injuries - weekly report, practice participation and roster status

Three facts about a player, never collapsed into one. report is the league's mandated weekly game designation (Out, Doubtful, Questionable), practice is participation (Did Not Participate, Limited, Full), and roster is reserve-list state (IR, IR-R, PUP-R, NFI-R, Reserve-Sus, Reserve-DNR) with a human comment. A player can legitimately hold all three at once with different values, and each row's sources array names which feeds contributed it. 34,810 weekly-report rows cover 2020-2026, all 32 teams and every regular-season week plus the postseason rounds. Omit season to get the newest week available; meta.resolved names the season and week actually served, and meta.data_as_of is the newest updated_at in the response, which sits in the past between seasons because nothing new is published then. ROSTER STATUS IS CURRENT-INSTANT ONLY - it is attached to the newest published week and nothing else. Ask for an older season or week and every row's roster is null and meta.sources.roster_status.in_scope is false with a reason, rather than the field being quietly absent. Rows carrying roster status but no weekly report entry have player_id null, because player_id on this endpoint is an NFL gsis-format id and those rows have none; their identity is roster.bbs_player_id when we hold one, and otherwise their name and team. Each row's sources array names the feeds by WHAT THEY ANSWER - weekly_report, roster_status - never by supplier.

get/v1/nfl/injuries

Request

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

Query parameters

seasoninteger

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
player_idstring
season_type'REG' | 'POST' | 'WC' | 'DIV' | 'CON' | 'SB'
statusstring

GAME DESIGNATION, matched case-insensitively (e.g. Out, Questionable). Filters the weekly report only, so rows that carry roster status and no report entry are excluded.

roster_statusstring

ROSTER / RESERVE-LIST status, matched case-insensitively and EXACTLY (e.g. IR, IR-R, PUP-R, NFI-R, Reserve-Sus, Reserve-DNR, Questionable, Out). A separate axis from status: IR does not match IR-R. Only meaningful on the newest published week.

positionstring
limitinteger
offsetinteger

Response

ok

dataobject[]

Changes

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