---
title: "List team_player_rosters for NFL"
method: GET
path: "/api/v1/nfl/team_player_rosters"
tags: ["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_id` integer
- `player_id` integer
- `season_id` integer
- `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'
- `mode` 'pre' | 'full'
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

team_player_rosters rows matching the declared filter set.

- NFLTeamPlayerRostersListResponse
  - `has_more` boolean, required: True when a full page came back, so more rows can exist.
  - `limit` integer, required: Page size used for this response.
  - `mode` 'pre' | 'full', required: The time-wall mode that served these rows (`pre` or `full`).
  - `next_from_id` integer, 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`.
  - `team_player_rosters` NFLTeamPlayerRosters[], required
    - `day` integer, required: The first game day of the current game's week (YYYYMMDD, Eastern), usually its Thursday; the same value for every club that week.
    - `depth_order` integer, nullable: Depth-chart order at this position for the current game (1 = starter); empty when not on the chart or not active.
    - `game_id` integer, required: The club's current game — its next game not yet kicked off, else its latest game.
    - `game_time` string, date-time, nullable: Kickoff time of the current game.
    - `id` integer, required: Primary Key
    - `injury_status` string, nullable: Injury designation on the current game roster (e.g. Questionable, Doubtful, Out; empty when healthy).
    - `player_id` integer, required
    - `position` string, nullable: The player's position on the club (a position from the filter list when the game roster has one, else his primary position).
    - `position_group` string, nullable: Position group (`Offense`, `Defense`, `Special Teams`).
    - `practice_status` string, nullable: The injury report's practice participation for the current game, as the report words it (`DNP`, `LP`, `FP`, or the long form such as `Did Not Participate In Practice`); empty when the player is not on the practice report.
    - `report_primary_injury` string, nullable: The injury report's primary injury for the current game.
    - `report_status` string, nullable: The official injury report's game status for the current game, as the report words it (e.g. `Out`, `Doubtful`, `Questionable`, `Active`, `Injured Reserve`), from the injury report of that same game only; empty when the player is not on it.
    - `season_id` integer, required
    - `season_type` string, nullable: Season type of the current game (regular_season, postseason, preseason).
    - `status` string, nullable: Roster status for the current game (`Active`, `Inactive`, `PracticeSquad`, `Reserve`, `Exempt`, `PhysicallyUnableToPerform`, `NonFootballInjury`, `Suspended`, ...); only players on the club appear.
    - `team_id` integer, required
    - `week` integer, nullable: Week of the current game within its season type.

## Other responses

- `400`: No declared filter set was satisfied by the request — see `accepted` in the body for the valid combinations.

---

[API](https://skmtc.dev/stat-api/apis/sports-db-public-api.md) · [All operations](https://skmtc.dev/stat-api/apis/sports-db-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stat-api/apis/sports-db-public-api/revisions/0c8484d5fc29?raw)