NFL

List team_player_rosters for NFL

get/api/v1/nfl/team_player_rosters

Request

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

Query parameters

team_idinteger

Filter by team.

player_idinteger

Filter to a single player.

season_idinteger

Filter to a season by year (e.g., 2026 for the 2026-27 season). Defaults to the current season. The roster is today's, so a past season returns no rows.

position'C' | 'CB' | 'DB' | 'DE' | 'DL' | 'DT' | 'FB' | 'FS' | 'G' | 'ILB' | 'K' | 'LB' | 'LS' | 'MLB' | 'NT' | 'OL' | 'OLB' | 'OT' | 'P' | 'QB' | 'RB' | 'S' | 'SAF' | 'TE' | 'WR'

Filter by player position.

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.

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

team_player_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 3 revisions of this API.