STAT-API

NBA game_team_rosters API

game_team_rostersnba.game_team_rosters
The gameday roster for each NBA game — every player of each team, with the player's status, injury designation, starting role and depth-chart slot. mode=pre (the default) shows each value as it stood at tip for that game; mode=full shows the post-game values. The depth-chart slot is the one at tip in both modes.
Full field reference (12 columns) → Data DictionaryQuery in GraphQL →
GET/api/v1/nba/game_team_rosters
Requires one of: game_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
team_idquerybigintoptional
Filter by team.
player_idquerybigintoptional
Filter to a single player.
positionquerystringoptional
Filter by player position (G, F, C, G-F, F-C).
statusqueryintegeroptional
Filter by roster availability code (1=Active, 2=Inactive, 3=Out), as the mode shows it.
injury_statusquerystringoptional
Filter by injury designation, as the mode shows it. Values: DOUBTFUL, OUT, PROBABLE, QUESTIONABLE.
depth_orderqueryintegeroptional
Filter by depth-chart rank (e.g., 1 for the first player at each position). Range syntax: depth_order__lte=.
modequerystringoptionaldefault pre
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. Values: pre, full.
limitqueryintegeroptionaldefault 50
Page size. Defaults to 50; max 5000.
from_idquerybigintoptional
Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nba/game_team_rosters?game_id=1'
Responses
200game_team_rosters rows matching the declared filter set, wrapped in { game_team_rosters, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸
400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json
Response Schema(12 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 724
player_id
bigint—
e.g. 197
team_id
bigint—
e.g. 12
comment
stringnullable—mode=pre: the reason on the league's injury report for this game, as published before tip. mode=full: the note of the post-game roster.
e.g. INACTIVE_GLEAGUE_TWOWAY
confirmed
booleannullable—mode=pre: the team's starting lineup was confirmed before tip (null when no lineup was known). mode=full: the starter value comes from post-game evidence.
e.g. true
depth_order
integernullable—Depth-chart rank at depth_position for this game (1 = first at the position, 2 = second, etc.), as the team's depth chart stood at tip; the same in mode=pre and mode=full. From the depth chart published before tip; for a game without one, from a chart built from the team's previous games. Null when the chart leaves the player out or the team has no chart for the game.
depth_position
stringnullable—Position slot of depth_order on the depth chart for this game (PG, SG, SF, PF, C). A player listed at two positions shows the one where his rank is better; on a tie, the first in PG, SG, SF, PF, C order.
injury_status
stringnullable—OUT, DOUBTFUL, QUESTIONABLE or PROBABLE. mode=pre: the designation that stood at tip for this game (null when available or unknown). mode=full: the post-game value.
Values:OUTQUESTIONABLEPROBABLEDOUBTFUL
position
stringnullable——
Values:GFCG-FF-C
starter
booleannullable—mode=pre: in the starting lineup known before tip (null when no lineup was known). mode=full: started the game.
Values:falsetrue
status
integernullable—Roster availability: 1=Active, 2=Inactive, 3=Out. mode=pre: as it stood at tip for this game (3 when ruled out, 1 for any other designation, null when nothing was known before tip). mode=full: the post-game value.
e.g. 1
GET/api/v1/nba/game_team_rosters/{id}
Parameters
idpathbigintrequired
Primary key (id) of the game_team_roster row.
modequerystringoptionaldefault pre
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. Values: pre, full.
Restores the documented defaults (trial keys only accept the unchanged defaults).
Request
curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nba/game_team_rosters/{pk_value}'
Responses
200Single game_team_roster row.application/jsonshow example ▸
404Row not found.
Response Schema(12 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 724
player_id
bigint—
e.g. 197
team_id
bigint—
e.g. 12
comment
stringnullable—mode=pre: the reason on the league's injury report for this game, as published before tip. mode=full: the note of the post-game roster.
e.g. INACTIVE_GLEAGUE_TWOWAY
confirmed
booleannullable—mode=pre: the team's starting lineup was confirmed before tip (null when no lineup was known). mode=full: the starter value comes from post-game evidence.
e.g. true
depth_order
integernullable—Depth-chart rank at depth_position for this game (1 = first at the position, 2 = second, etc.), as the team's depth chart stood at tip; the same in mode=pre and mode=full. From the depth chart published before tip; for a game without one, from a chart built from the team's previous games. Null when the chart leaves the player out or the team has no chart for the game.
depth_position
stringnullable—Position slot of depth_order on the depth chart for this game (PG, SG, SF, PF, C). A player listed at two positions shows the one where his rank is better; on a tie, the first in PG, SG, SF, PF, C order.
injury_status
stringnullable—OUT, DOUBTFUL, QUESTIONABLE or PROBABLE. mode=pre: the designation that stood at tip for this game (null when available or unknown). mode=full: the post-game value.
Values:OUTQUESTIONABLEPROBABLEDOUBTFUL
position
stringnullable——
Values:GFCG-FF-C
starter
booleannullable—mode=pre: in the starting lineup known before tip (null when no lineup was known). mode=full: started the game.
Values:falsetrue
status
integernullable—Roster availability: 1=Active, 2=Inactive, 3=Out. mode=pre: as it stood at tip for this game (3 when ruled out, 1 for any other designation, null when nothing was known before tip). mode=full: the post-game value.
e.g. 1