---
title: "List game_player_stats for NBA"
method: GET
path: "/api/v1/nba/game_player_stats"
tags: ["NBA"]
---

# List game_player_stats for NBA

`GET /api/v1/nba/game_player_stats`

## Request

- Base URL: `https://api.stat-api.com`
- URL: `https://api.stat-api.com/api/v1/nba/game_player_stats`
- Auth: HTTP bearer

## Query parameters

- `game_id` integer
- `player_id` integer
- `team_id` integer
- `game_date` integer
- `game_date__gte` integer
- `game_date__lte` integer
- `game_date__between` integer
- `limit` integer
- `from_id` integer
- `format` 'json' | 'csv'

## Response `200`

game_player_stats rows matching the declared filter set.

- NBAGamePlayerStatsListResponse
  - `game_player_stats` NBAGamePlayerStats[], required
    - `abnormal_exit_clock` integer, required
    - `abnormal_exit_period` integer, required
    - `alley_oops` integer, required
    - `and_ones` integer, required
    - `assist_percentage` number, double, nullable
    - `assist_ratio` number, double, nullable
    - `assist_to_turnover` number, double, nullable
    - `assists` integer, required
    - `avg_dribbles_per_touch` number, double, nullable
    - `avg_seconds_per_touch` number, double, nullable
    - `backcourt_violations` integer, required
    - `balls_stolen` integer, nullable
    - `basket_interference_violations` integer, required
    - `blocks` integer, required
    - `box_outs` integer, nullable
    - `carrying_palming_violations` integer, required
    - `challenges_requested` integer, required
    - `charges_taken` integer, nullable
    - `comment` string, nullable
    - `competitive_minutes` number, double, required
    - `contests` integer, nullable
    - `defensive_rating` number, double, nullable
    - `defensive_rebound_percentage` number, double, nullable
    - `defensive_rebounds` integer, required
    - `deflections` integer, nullable
    - `double_doubles` integer, required
    - `double_dribble_violations` integer, required
    - `drives` integer, nullable
    - `dunks` integer, required
    - `effective_field_goal_percentage` number, double, nullable
    - `ejections` integer, required
    - `elbow_touches` integer, nullable
    - `estimated_defensive_rating` number, double, nullable
    - `estimated_net_rating` number, double, nullable
    - `estimated_offensive_rating` number, double, nullable
    - `estimated_pace` number, double, nullable
    - `estimated_usage_percentage` number, double, nullable
    - `fast_break_pts` integer, required
    - `field_goal_percentage` number, double, nullable
    - `field_goals_attempted` integer, required
    - `field_goals_made` integer, required
    - `foul_trouble_severity` integer, required
    - `fouls` integer, required: 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.
    - `fouls_drawn` integer, required
    - `free_throw_percentage` number, double, nullable
    - `free_throws_attempted` integer, required
    - `free_throws_made` integer, required
    - `front_court_touches` integer, nullable
    - `game_date` integer, required
    - `game_id` integer, required
    - `garbage_time_minutes` number, double, required
    - `goaltending_violations` integer, required
    - `hockey_assists` integer, nullable
    - `id` integer, required: Primary Key
    - `jump_balls_lost` integer, required
    - `jump_balls_won` integer, required
    - `lane_violations` integer, required
    - `layups` integer, required
    - `loose_balls_recovered` integer, nullable
    - `minutes` number, double, required
    - `minutes_deviation_pct` number, double, required
    - `net_rating` number, double, nullable
    - `offensive_fouls` integer, required: Offensive fouls. A SUBSET of personal_fouls, not an addition to it.
    - `offensive_rating` number, double, nullable
    - `offensive_rebound_percentage` number, double, nullable
    - `offensive_rebounds` integer, required
    - `paint_touches` integer, nullable
    - `pass_percentage` number, double, nullable
    - `passes` integer, nullable
    - `passes_deflected` integer, nullable
    - `personal_fouls` integer, required: Personal fouls only — the count a player fouls out on at 6. Includes offensive and flagrant fouls, which the NBA scores as personal fouls.
    - `player_id` integer, required
    - `player_impact_estimate` number, double, required
    - `plus_minus` integer, required
    - `possessions` integer, required
    - `post_touches` integer, nullable
    - `potential_assists` integer, nullable
    - `pts` integer, required
    - `pts_per_elbow_touch` number, double, nullable
    - `pts_per_paint_touch` number, double, nullable
    - `pts_per_post_touch` number, double, nullable
    - `pts_per_touch` number, double, nullable
    - `put_backs` integer, required
    - `rebound_percentage` number, double, nullable
    - `rebounds` integer, required
    - `role_anomalous_game` boolean, required
    - `role_archetype` string, nullable
    - `role_archetype_confidence` number, double, required
    - `rotation_context` string, nullable
    - `rotation_context_confidence` number, double, required
    - `screen_assists` integer, nullable
    - `second_chance_pts` integer, required
    - `shot_clock_violations` integer, required
    - `shot_contested_count` integer, nullable
    - `shots_blocked` integer, nullable
    - `start_position` string, nullable
    - `steals` integer, required
    - `substitutions_in` integer, required
    - `substitutions_out` integer, required
    - `team_id` integer, required
    - `technical_fouls` integer, required: Technical fouls. The one foul type the NBA keeps OUT of the personal count; 2 means ejection.
    - `three_point_percentage` number, double, nullable
    - `three_pointers_attempted` integer, required
    - `three_pointers_made` integer, required
    - `time_of_possession` number, double, nullable
    - `timeouts_called` integer, required
    - `touches` integer, nullable
    - `traveling_violations` integer, required
    - `triple_doubles` integer, required
    - `true_shooting_percentage` number, double, nullable
    - `turnover_ratio` number, double, nullable
    - `turnovers` integer, required
    - `usage_percentage` number, double, nullable
  - `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.
  - `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/23b66b957723?raw)