NFL

List game_team_rosters for NFL

get/api/v1/nfl/game_team_rosters

Request

  • Base URL: https://api.stat-api.com
  • URL: https://api.stat-api.com/api/v1/nfl/game_team_rosters
  • Auth: HTTP bearer

Query parameters

game_idinteger

Filter to a single game.

team_idinteger

Filter by team.

player_idinteger

Filter to a single player.

position'C' | 'CB' | 'DB' | 'DE' | 'DL' | 'DT' | 'FB' | 'FS' | 'G' | 'H' | 'ILB' | 'K' | 'LB' | 'LILB' | 'LOLB' | 'LOT' | 'LS' | 'MLB' | 'NT' | 'OL' | 'OLB' | 'OT' | 'P' | 'PK' | 'PR' | 'QB' | 'RB' | 'RILB' | 'ROT' | 'S' | 'SAF' | 'T' | 'TE' | 'WR'

Filter by player position.

status'Active' | 'Cut' | 'Exempt' | 'ExemptInternational' | 'Inactive' | 'NonFootballInjury' | 'PhysicallyUnableToPerform' | 'PracticeSquad' | 'PracticeSquadReleased' | 'ReleasedFromInjuredReserve' | 'Reserve' | 'RestrictedFreeAgent' | 'Retired' | 'Suspended' | 'UnrestrictedFreeAgent' | 'Waived'

Filter by game-roster status (readable single-word vocabulary; PracticeSquadReleased covers the league TRC/TRD transaction codes).

depth_orderinteger

Filter by depth-chart rank (e.g., 1 for starters).

depth_order__lteinteger

Filter by depth-chart rank (e.g., 1 for starters). (less-than-or-equal)

formation'offense' | 'defense' | 'special_teams'

Filter by unit/formation.

injury_status'Active' | 'Doubtful' | 'Injured Reserve' | 'Note' | 'Out' | 'Questionable' | 'Unknown'

Filter by injury status designation.

mode'pre' | 'full'

Time wall. pre (default): each value as it stood at its game's kickoff; post-game fields are null. full: the latest value before week end (the first Tuesday 04:00 ET after the game), post-game fields included. See the Data timing guide.

limitinteger

Page size; defaults to (and is capped at) 5000.

from_idinteger

Return rows with id strictly greater than this value, in ascending id order. To walk every row, start at 0 and then pass the previous response's next_from_id. Without it, the first page uses the table's default sort and returns no cursor.

format'json' | 'csv'

Response format: json (default) or csv — the same rows as CSV with raw values, a blank cell for null, and X-Next-From-Id when another page exists. With format=csv only, the API key may be passed as the key query param (for Google Sheets IMPORTDATA); use a separate, revocable key for that.

Response

game_team_rosters rows matching the declared filter set.

has_moreboolean required

True when a full page came back, so more rows can exist.

limitinteger required

Page size used for this response.

mode'pre' | 'full' required

The time-wall mode that served these rows (pre or full).

next_from_idinteger nullable required

Pass this as from_id on the next request to page forward. null on the terminal page, and on a first page requested without from_id (that page uses the default sort): to walk every row, start with from_id=0.

Changes

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