---
title: "List game_team_rosters for NFL"
method: GET
path: "/api/v1/nfl/game_team_rosters"
tags: ["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_id` integer
- `team_id` integer
- `player_id` integer
- `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'
- `status` 'Active' | 'Cut' | 'Exempt' | 'ExemptInternational' | 'Inactive' | 'NonFootballInjury' | 'PhysicallyUnableToPerform' | 'PracticeSquad' | 'PracticeSquadReleased' | 'ReleasedFromInjuredReserve' | 'Reserve' | 'RestrictedFreeAgent' | 'Retired' | 'Suspended' | 'UnrestrictedFreeAgent' | 'Waived'
- `depth_order` integer
- `depth_order__lte` integer
- `formation` 'offense' | 'defense' | 'special_teams'
- `injury_status` 'Active' | 'Doubtful' | 'Injured Reserve' | 'Note' | 'Out' | 'Questionable' | 'Unknown'
- `mode` 'pre' | 'full'
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

game_team_rosters rows matching the declared filter set.

- NFLGameTeamRostersListResponse
  - `game_team_rosters` NFLGameTeamRosters[], required
    - `comment` string, nullable: Optional note from the gameday roster report (e.g., reason for inactive).
    - `depth_order` integer, nullable: Depth-chart rank at this position for this game (1 = starter, 2 = backup, etc.).
    - `depth_position` string, nullable: Position slot on the depth chart for this game (e.g. QB, RB, WR, LT, CB).
    - `formation` string, nullable: Formation unit this slot belongs to (offense, defense, special_teams).
    - `game_id` integer, required
    - `id` integer, required: Primary Key
    - `injury_status` string, nullable: Final game injury report designation as of kickoff lock (e.g. Questionable, Doubtful, Out, or NULL if uninjured).
    - `player_id` integer, required
    - `position` string, nullable: Position the player suited up at for this game.
    - `starter` boolean, required: True if the player started this game.
    - `status` string, nullable: Roster status for the game, readable single-word vocabulary (`Active`, `Inactive`, `PracticeSquad`, `Reserve`, `Cut`, `Retired`, `Exempt`, `PracticeSquadReleased`).
    - `team_id` integer, required
  - `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`.

## 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/601ff9eaca3f?raw)