STAT-API

NBA game_player_stats API

game_player_statsnba.game_player_stats
Each NBA player's stat line for each game — points, rebounds, assists, steals, blocks, shooting line, three-point line, free-throw line, plus-minus, and minutes played. Every counting stat and the minutes follow the league's official box score: read at the final whistle, 1 hour later, and each morning for the 3 days after the game. A later correction by the league replaces the value in place (no revision history). A DFS contest's points stay the operator's settled values (see /api/v1/dfs/contests/{contest_id}/download).
GET/api/v1/nba/game_player_stats
Requires one of: game_id or player_id — requests satisfying none of these return 400.
Parameters
game_idquerybigintoptional
Filter to a single game.
player_idquerybigintoptional
Filter to a single player — their full game log, newest first. Combine with game_date ranges to window it.
team_idquerybigintoptional
Filter by team.
game_datequeryintegeroptional
Filter by game day (YYYYMMDD integer, US Eastern). Range syntax: game_date__gte=, game_date__lte=, game_date__between=.
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_player_stats?game_id=1'
Responses
200game_player_stats rows matching the declared filter set, wrapped in { game_player_stats, limit, next_from_id, has_more }. has_more is true when another row follows this page. To walk every row, start with ?from_id=0 and pass each next_from_id back as from_id until it is null; the filters stay. A first page without from_id comes in the default order and gives next_from_id null.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(113 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 122
player_id
bigint—
e.g. 75
team_id
bigint—
e.g. 17
abnormal_exit_clock
integer——
e.g. 0
abnormal_exit_period
integer——
e.g. 0
alley_oops
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
and_ones
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
assist_percentage
decimalnullable——
e.g. 0.0000
assist_ratio
decimalnullable——
e.g. 0.0000
assist_to_turnover
decimalnullable——
e.g. 0.0000
assists
integer——
e.g. 0
avg_dribbles_per_touch
decimalnullable——
e.g. 0.0000
avg_seconds_per_touch
decimalnullable——
e.g. 0.0000
backcourt_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
balls_stolen
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
basket_interference_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
blocks
integer——
e.g. 0
box_outs
integernullable——
e.g. 0
carrying_palming_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
challenges_requested
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
charges_taken
integernullable——
e.g. 0
comment
stringnullable——
e.g. — (all-null in sample)
competitive_minutes
decimal——
e.g. 0.0
contests
integernullable——
e.g. 1
defensive_rating
decimalnullable——
e.g. 100.0000
defensive_rebound_percentage
decimalnullable——
e.g. 0.0000
defensive_rebounds
integer——
e.g. 1
deflections
integernullable——
e.g. 1
double_doubles
integer——
e.g. 0
double_dribble_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
drives
integernullable——
e.g. 0
dunks
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
effective_field_goal_percentage
decimalnullable——
e.g. 0.0000
ejections
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
elbow_touches
integernullable——
e.g. 0
estimated_defensive_rating
decimalnullable——
e.g. 100.0000
estimated_net_rating
decimalnullable——
e.g. 0.0000
estimated_offensive_rating
decimalnullable——
e.g. 100.0000
estimated_pace
decimalnullable——
e.g. 84.7100
estimated_usage_percentage
decimalnullable——
e.g. 0.0000
fast_break_pts
integernullable—Fast-break points. Null when the source of the game gives none (most games): never a made-up 0.
e.g. — (all-null in sample)
field_goal_percentage
decimalnullable——
e.g. 0.0000
field_goals_attempted
integer——
e.g. 5
field_goals_made
integer——
e.g. 1
foul_trouble_severity
integer——
e.g. 0
fouls
integer—Total fouls: personal_fouls + technical_fouls. Use personal_fouls, not this, to judge foul trouble — a player fouls out on 6 PERSONAL fouls and technicals do not count toward that.
e.g. 1
fouls_drawn
integer——
e.g. 0
free_throw_percentage
decimalnullable——
e.g. 0.0000
free_throws_attempted
integer——
e.g. 0
free_throws_made
integer——
e.g. 0
front_court_touches
integernullable——
e.g. 19
game_date
integer——
e.g. 20251112
garbage_time_minutes
decimal——
e.g. 0
goaltending_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
hockey_assists
integernullable——
e.g. 0
jump_balls_lost
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
jump_balls_won
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
lane_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
layups
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
loose_balls_recovered
integernullable——
e.g. 0
minutes
decimal——
e.g. 12.0000
minutes_deviation_pct
decimal——
e.g. 0
net_rating
decimalnullable——
e.g. 0.0000
offensive_fouls
integernullable—Offensive fouls. A SUBSET of personal_fouls, not an addition to it. Null when the source of the game gives no count (the league's official box has none): never a made-up 0.
e.g. — (all-null in sample)
offensive_rating
decimalnullable——
e.g. 100.0000
offensive_rebound_percentage
decimalnullable——
e.g. 0.0000
offensive_rebounds
integer——
e.g. 0
paint_touches
integernullable——
e.g. 0
pass_percentage
decimalnullable——
e.g. 0.0000
passes
integernullable——
e.g. 21
passes_deflected
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
personal_fouls
integer—Personal fouls only — the count a player fouls out on at 6. Includes offensive and flagrant fouls, which the NBA scores as personal fouls.
e.g. 1
player_impact_estimate
decimal——
e.g. 0.0000
plus_minus
integer——
e.g. -2
possessions
integer——
e.g. 53
post_touches
integernullable——
e.g. 0
potential_assists
integernullable——
e.g. 0
pts
integer——
e.g. 0
pts_per_elbow_touch
decimalnullable——
e.g. — (all-null in sample)
pts_per_paint_touch
decimalnullable——
e.g. — (all-null in sample)
pts_per_post_touch
decimalnullable——
e.g. — (all-null in sample)
pts_per_touch
decimalnullable——
e.g. 0.0000
put_backs
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
rebound_percentage
decimalnullable——
e.g. 0.0000
rebounds
integer——
e.g. 2
role_anomalous_game
boolean——
Values:falsetrue
role_archetype
stringnullable——
Values:deep_benchco_starcore_starterrotationend_of_benchalphasixth_mantwo_way
role_archetype_confidence
decimal——
e.g. 0.6
rotation_context
stringnullable——
Values:normalgarbage_time_boostambiguous_anomalyblowout_restfoul_troublefoul_outinjury_exitdnp_coach
rotation_context_confidence
decimal——
e.g. 0.5
screen_assists
integernullable——
e.g. 0
second_chance_pts
integernullable—Second-chance points. Null when the source of the game gives none (most games): never a made-up 0.
e.g. — (all-null in sample)
shot_clock_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
shot_contested_count
integernullable——
e.g. 1
shots_blocked
integernullable——
e.g. 0
start_position
stringnullable——
Values:GFC
steals
integer——
e.g. 0
substitutions_in
integernullable—Times the player came on the floor: each change of the team's five between two lineup stints of the game (nba/game_team_lineup_stints). The first five of the game, and a period that starts with the same five, count none. Null when the game has no lineup stints. Written by the next morning's load.
e.g. 3
substitutions_out
integernullable—Times the player went off the floor: each change of the team's five between two lineup stints of the game (nba/game_team_lineup_stints). Null when the game has no lineup stints. Written by the next morning's load.
e.g. 3
technical_fouls
integernullable—Technical fouls. The one foul type the NBA keeps OUT of the personal count; 2 means ejection. Null when the source of the game gives no count (the league's official box has none): never a made-up 0.
e.g. — (all-null in sample)
three_point_percentage
decimalnullable——
e.g. 0.0000
three_pointers_attempted
integer——
e.g. 0
three_pointers_made
integer——
e.g. 0
time_of_possession
decimalnullable——
e.g. 0.2000
timeouts_called
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
touches
integernullable——
e.g. 26
traveling_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
triple_doubles
integer——
e.g. 0
true_shooting_percentage
decimalnullable——
e.g. 0.0000
turnover_ratio
decimalnullable——
e.g. 0.0000
turnovers
integer——
e.g. 0
usage_percentage
decimalnullable——
e.g. 0.0000
GET/api/v1/nba/game_player_stats/{id}
Parameters
idpathbigintrequired
Primary key (id) of the game_player_stat row.
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_player_stats/{pk_value}'
Responses
200Single game_player_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(113 fields)show schema ▸
FieldTypeReferencesDescription
idkey
bigint—Primary Key
game_id
bigint—
e.g. 122
player_id
bigint—
e.g. 75
team_id
bigint—
e.g. 17
abnormal_exit_clock
integer——
e.g. 0
abnormal_exit_period
integer——
e.g. 0
alley_oops
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
and_ones
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
assist_percentage
decimalnullable——
e.g. 0.0000
assist_ratio
decimalnullable——
e.g. 0.0000
assist_to_turnover
decimalnullable——
e.g. 0.0000
assists
integer——
e.g. 0
avg_dribbles_per_touch
decimalnullable——
e.g. 0.0000
avg_seconds_per_touch
decimalnullable——
e.g. 0.0000
backcourt_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
balls_stolen
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
basket_interference_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
blocks
integer——
e.g. 0
box_outs
integernullable——
e.g. 0
carrying_palming_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
challenges_requested
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
charges_taken
integernullable——
e.g. 0
comment
stringnullable——
e.g. — (all-null in sample)
competitive_minutes
decimal——
e.g. 0.0
contests
integernullable——
e.g. 1
defensive_rating
decimalnullable——
e.g. 100.0000
defensive_rebound_percentage
decimalnullable——
e.g. 0.0000
defensive_rebounds
integer——
e.g. 1
deflections
integernullable——
e.g. 1
double_doubles
integer——
e.g. 0
double_dribble_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
drives
integernullable——
e.g. 0
dunks
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
effective_field_goal_percentage
decimalnullable——
e.g. 0.0000
ejections
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
elbow_touches
integernullable——
e.g. 0
estimated_defensive_rating
decimalnullable——
e.g. 100.0000
estimated_net_rating
decimalnullable——
e.g. 0.0000
estimated_offensive_rating
decimalnullable——
e.g. 100.0000
estimated_pace
decimalnullable——
e.g. 84.7100
estimated_usage_percentage
decimalnullable——
e.g. 0.0000
fast_break_pts
integernullable—Fast-break points. Null when the source of the game gives none (most games): never a made-up 0.
e.g. — (all-null in sample)
field_goal_percentage
decimalnullable——
e.g. 0.0000
field_goals_attempted
integer——
e.g. 5
field_goals_made
integer——
e.g. 1
foul_trouble_severity
integer——
e.g. 0
fouls
integer—Total fouls: personal_fouls + technical_fouls. Use personal_fouls, not this, to judge foul trouble — a player fouls out on 6 PERSONAL fouls and technicals do not count toward that.
e.g. 1
fouls_drawn
integer——
e.g. 0
free_throw_percentage
decimalnullable——
e.g. 0.0000
free_throws_attempted
integer——
e.g. 0
free_throws_made
integer——
e.g. 0
front_court_touches
integernullable——
e.g. 19
game_date
integer——
e.g. 20251112
garbage_time_minutes
decimal——
e.g. 0
goaltending_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
hockey_assists
integernullable——
e.g. 0
jump_balls_lost
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
jump_balls_won
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
lane_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
layups
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
loose_balls_recovered
integernullable——
e.g. 0
minutes
decimal——
e.g. 12.0000
minutes_deviation_pct
decimal——
e.g. 0
net_rating
decimalnullable——
e.g. 0.0000
offensive_fouls
integernullable—Offensive fouls. A SUBSET of personal_fouls, not an addition to it. Null when the source of the game gives no count (the league's official box has none): never a made-up 0.
e.g. — (all-null in sample)
offensive_rating
decimalnullable——
e.g. 100.0000
offensive_rebound_percentage
decimalnullable——
e.g. 0.0000
offensive_rebounds
integer——
e.g. 0
paint_touches
integernullable——
e.g. 0
pass_percentage
decimalnullable——
e.g. 0.0000
passes
integernullable——
e.g. 21
passes_deflected
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
personal_fouls
integer—Personal fouls only — the count a player fouls out on at 6. Includes offensive and flagrant fouls, which the NBA scores as personal fouls.
e.g. 1
player_impact_estimate
decimal——
e.g. 0.0000
plus_minus
integer——
e.g. -2
possessions
integer——
e.g. 53
post_touches
integernullable——
e.g. 0
potential_assists
integernullable——
e.g. 0
pts
integer——
e.g. 0
pts_per_elbow_touch
decimalnullable——
e.g. — (all-null in sample)
pts_per_paint_touch
decimalnullable——
e.g. — (all-null in sample)
pts_per_post_touch
decimalnullable——
e.g. — (all-null in sample)
pts_per_touch
decimalnullable——
e.g. 0.0000
put_backs
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
rebound_percentage
decimalnullable——
e.g. 0.0000
rebounds
integer——
e.g. 2
role_anomalous_game
boolean——
Values:falsetrue
role_archetype
stringnullable——
Values:deep_benchco_starcore_starterrotationend_of_benchalphasixth_mantwo_way
role_archetype_confidence
decimal——
e.g. 0.6
rotation_context
stringnullable——
Values:normalgarbage_time_boostambiguous_anomalyblowout_restfoul_troublefoul_outinjury_exitdnp_coach
rotation_context_confidence
decimal——
e.g. 0.5
screen_assists
integernullable——
e.g. 0
second_chance_pts
integernullable—Second-chance points. Null when the source of the game gives none (most games): never a made-up 0.
e.g. — (all-null in sample)
shot_clock_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
shot_contested_count
integernullable——
e.g. 1
shots_blocked
integernullable——
e.g. 0
start_position
stringnullable——
Values:GFC
steals
integer——
e.g. 0
substitutions_in
integernullable—Times the player came on the floor: each change of the team's five between two lineup stints of the game (nba/game_team_lineup_stints). The first five of the game, and a period that starts with the same five, count none. Null when the game has no lineup stints. Written by the next morning's load.
e.g. 3
substitutions_out
integernullable—Times the player went off the floor: each change of the team's five between two lineup stints of the game (nba/game_team_lineup_stints). Null when the game has no lineup stints. Written by the next morning's load.
e.g. 3
technical_fouls
integernullable—Technical fouls. The one foul type the NBA keeps OUT of the personal count; 2 means ejection. Null when the source of the game gives no count (the league's official box has none): never a made-up 0.
e.g. — (all-null in sample)
three_point_percentage
decimalnullable——
e.g. 0.0000
three_pointers_attempted
integer——
e.g. 0
three_pointers_made
integer——
e.g. 0
time_of_possession
decimalnullable——
e.g. 0.2000
timeouts_called
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
touches
integernullable——
e.g. 26
traveling_violations
integernullable—No source fills this field yet: null, never a made-up 0 (2026-10-26).
e.g. — (all-null in sample)
triple_doubles
integer——
e.g. 0
true_shooting_percentage
decimalnullable——
e.g. 0.0000
turnover_ratio
decimalnullable——
e.g. 0.0000
turnovers
integer——
e.g. 0
usage_percentage
decimalnullable——
e.g. 0.0000