NBA API Reference
Every NBA game across the 82-game regular season, the In-Season Tournament, the play-in round, and the four-round playoffs through the Finals — with the players, coaching staffs, depth charts, injuries, betting markets, and possession-level play-by-play behind them.
Main
seasons
nba.seasonsEach NBA league year, running from October through June — the 82-game regular season, the play-in tournament, and the four-round playoffs that end with the NBA Finals.
GET/api/v1/nba/seasonsList seasons for NBA
Parameters
limitqueryintegeroptionaldefault 25Page size. Defaults to 25; max 5000.
from_idquerybigintoptionalReturn 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/seasons?limit=3'Responses
200seasons rows matching the declared filter set, wrapped in { seasons, 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/jsonResponse Schema(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
end_date | timestamptznullable | — | — e.g. 2017-06-12T04:00:00.000Z |
post_season_start_date | timestamptznullable | — | — e.g. 2017-04-15T04:00:00.000Z |
regular_season_start_date | timestamptznullable | — | — e.g. 2016-10-25T04:00:00.000Z |
start_date | timestamptz | — | — e.g. 2016-10-25T04:00:00.000Z |
start_year | integer | — | — e.g. 2016 |
GET/api/v1/nba/seasons/{id}Get a single season by id
Parameters
idpathbigintrequiredPrimary key (id) of the season 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/seasons/{pk_value}'Responses
200Single season row.application/jsonshow example ▸
404Row not found.
Response Schema(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
end_date | timestamptznullable | — | — e.g. 2017-06-12T04:00:00.000Z |
post_season_start_date | timestamptznullable | — | — e.g. 2017-04-15T04:00:00.000Z |
regular_season_start_date | timestamptznullable | — | — e.g. 2016-10-25T04:00:00.000Z |
start_date | timestamptz | — | — e.g. 2016-10-25T04:00:00.000Z |
start_year | integer | — | — e.g. 2016 |
GET/api/v1/nba/weeksList modeled NBA season weeks and matchup summaries (Free navigation endpoint, plus free_game_id for SIM)beta
Parameters
seasonqueryunknownoptionalNBA season year (defaults to 2026).
weekqueryunknownoptionalOptional week number filter.
season_typequeryunknownoptionalModeled season phase (`regular_season`, `in_season_tournament`, `play_in`, `postseason`; preseason is excluded per Rule 3.4).
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/weeks?season=2026'Responses
200List modeled NBA season weeks and matchup summaries (Free navigation endpoint, plus free_game_id for SIM)application/jsonshow example ▸
Response Schema(5 fields)show schema ▸
25 total fields (1 nested object/array groups)
| Field | Type | References | Description |
|---|---|---|---|
season | integer | — | Requested NBA season year (default `2026`). |
available_seasons | integer[] | — | Available NBA seasons in the database (`[2026, 2025, ...]`). |
free_game_id | integer | — | Canonical free 2026 game ID (`6029936`, `DET @ BOS`) unlocked in full for all tiers. |
weeks | integer[] | — | Sorted list of modeled week numbers available in `season`. |
games | NBAMatchupSummary[] | — | Matchup summaries across modeled NBA games in `season` (regular season, NBA Cup, play-in, and playoffs; never preseason). |
↳game_id games.game_id | integer | — | Unique NBA game identifier (`6029936` = `DET @ BOS`). |
↳season games.season | integer | — | NBA season year. |
↳week games.week | integer | — | NBA season week number. |
↳season_type games.season_type | string | — | Modeled NBA season phase (`regular_season`, `in_season_tournament`, `play_in`, `postseason`). |
↳kickoff games.kickoff | stringnullable | — | Scheduled UTC tipoff timestamp (ISO-8601). |
↳day games.day | integernullable | — | Game date integer in `YYYYMMDD` format. |
↳home_team_id games.home_team_id | integer | — | Canonical home team ID. |
↳home_abbr games.home_abbr | string | — | Home team abbreviation (e.g., `BOS`). |
↳away_team_id games.away_team_id | integer | — | Canonical away team ID. |
↳away_abbr games.away_abbr | string | — | Away team abbreviation (e.g., `DET`). |
↳spread_home games.spread_home | number | — | Pre-tip Vegas home spread in points (negative = home favored). |
↳game_total games.game_total | number | — | Pre-tip Vegas over/under game total points. |
↳home_team_total games.home_team_total | number | — | Implied home team total points (`(game_total - spread_home) / 2`). |
↳away_team_total games.away_team_total | number | — | Implied away team total points (`(game_total + spread_home) / 2`). |
↳moneyline_home games.moneyline_home | integernullable | — | Pre-tip American moneyline for the home team. |
↳moneyline_away games.moneyline_away | integernullable | — | Pre-tip American moneyline for the away team. |
↳is_final games.is_final | boolean | — | True if the real NBA game has completed. |
↳real_home_pts games.real_home_pts | integernullable | — | Actual final home points scored (`null` before game completion). |
↳real_away_pts games.real_away_pts | integernullable | — | Actual final away points scored (`null` before game completion). |
↳is_free games.is_free | boolean | — | True when unlocked for free full-depth simulation (`game_id == 6029936`). |
teams
nba.teamsThe 30 NBA franchises, organized into the Eastern and Western Conferences with three divisions in each.
GET/api/v1/nba/teamsList teams for NBA
Parameters
activequerybooleanoptionalFilter by active status (defaults to true to show only currently-active rows; pass active=false to include inactive).
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/teams?limit=3'Responses
200teams rows matching the declared filter set, wrapped in { teams, 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/jsonResponse Schema(10 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_team_id | integernullable | — | Official NBA team ID (issued by the league) e.g. 1610612738 |
stadium_id | bigintnullable | — e.g. — (all-null in sample) | |
abbreviation | string | — | — e.g. BOS |
active | boolean | — | — e.g. true |
city | string | — | — e.g. Los Angeles |
conference | string | — | — Values:EasternWestern |
division | string | — | — Values:AtlanticCentralSoutheastNorthwestPacificSouthwest |
full_name | string | — | — e.g. Boston Celtics |
name | string | — | — e.g. Celtics |
GET/api/v1/nba/teams/{id}Get a single team by id
Parameters
idpathbigintrequiredPrimary key (id) of the team 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/teams/{pk_value}'Responses
200Single team row.application/jsonshow example ▸
404Row not found.
Response Schema(10 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_team_id | integernullable | — | Official NBA team ID (issued by the league) e.g. 1610612738 |
stadium_id | bigintnullable | — e.g. — (all-null in sample) | |
abbreviation | string | — | — e.g. BOS |
active | boolean | — | — e.g. true |
city | string | — | — e.g. Los Angeles |
conference | string | — | — Values:EasternWestern |
division | string | — | — Values:AtlanticCentralSoutheastNorthwestPacificSouthwest |
full_name | string | — | — e.g. Boston Celtics |
name | string | — | — e.g. Celtics |
games
nba.gamesEvery scheduled and played NBA game from the 2020-21 season onward — preseason, the 82-game regular season, the In-Season Tournament, the play-in round, and the four-round playoffs through the NBA Finals. All-Star exhibitions are not included.
GET/api/v1/nba/gamesList games for NBA
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a season. Defaults to the current season.
home_team_idquerybigintoptionalFilter by home team.
away_team_idquerybigintoptionalFilter by away team.
statusquerystringoptionalFilter by game status. Values: Cancelled, Final, Scheduled.
dayqueryintegeroptionalFilter by calendar day (YYYYMMDD integer, US Eastern) — e.g. day=20260609 for tonight's slate. Note season_id defaults to the current season; pass season_id explicitly when querying a past season's day. Range syntax: day__gte=, day__lte=, day__between=.
season_typequerystringoptionalFilter by season phase (regular_season, preseason, postseason, play_in, in_season_tournament, all_star). Values: all_star, in_season_tournament, play_in, postseason, preseason, regular_season.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn 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/games?season_id=2026'Responses
200games rows matching the declared filter set, wrapped in { games, 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/jsonResponse Schema(27 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
away_team_id | bigint | — e.g. 1 | |
home_team_id | bigint | — e.g. 1 | |
league_game_id | stringnullable | — | Official NBA game ID (issued by the league) e.g. 0022500650 |
season_id | bigint | — e.g. 2023 | |
stadium_id | integernullable | — e.g. 19 | |
attendance | integernullable | — | — e.g. 19156 |
away_rotation_number | integernullable | — | — e.g. — (all-null in sample) |
away_team | string | — | — e.g. BOS |
away_team_score | integer | — | — e.g. 113 |
channel | stringnullable | — | — e.g. NBA TV |
day | integer | — | — e.g. 20250413 |
end_time | timestamptznullable | — | — e.g. 2024-10-16T01:46:00.000Z |
game_label | stringnullable | — | — e.g. — (all-null in sample) |
game_sub_label | stringnullable | — | — e.g. — (all-null in sample) |
game_time | timestamptznullable | — | Scheduled tip-off (timezone-aware); null when the league published no time. e.g. 2025-04-13T19:30:00.000Z |
home_rotation_number | integernullable | — | — e.g. — (all-null in sample) |
home_team | string | — | — e.g. BOS |
home_team_score | integer | — | — e.g. 112 |
if_necessary | booleannullable | — | — e.g. — (all-null in sample) |
neutral_venue | boolean | — | — Values:falsetrue |
postponed_status | stringnullable | — | — e.g. — (all-null in sample) |
season_type | string | — | — Values:regular_seasonpostseasonpreseasonplay_inin_season_tournament |
series_game_number | stringnullable | — | — e.g. — (all-null in sample) |
series_name | stringnullable | — | — e.g. — (all-null in sample) |
series_text | stringnullable | — | — e.g. — (all-null in sample) |
status | string | — | — e.g. Final |
GET/api/v1/nba/games/{id}Get a single game by id
Parameters
idpathbigintrequiredPrimary key (id) of the game 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/games/{pk_value}'Responses
200Single game row.application/jsonshow example ▸
404Row not found.
Response Schema(27 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
away_team_id | bigint | — e.g. 1 | |
home_team_id | bigint | — e.g. 1 | |
league_game_id | stringnullable | — | Official NBA game ID (issued by the league) e.g. 0022500650 |
season_id | bigint | — e.g. 2023 | |
stadium_id | integernullable | — e.g. 19 | |
attendance | integernullable | — | — e.g. 19156 |
away_rotation_number | integernullable | — | — e.g. — (all-null in sample) |
away_team | string | — | — e.g. BOS |
away_team_score | integer | — | — e.g. 113 |
channel | stringnullable | — | — e.g. NBA TV |
day | integer | — | — e.g. 20250413 |
end_time | timestamptznullable | — | — e.g. 2024-10-16T01:46:00.000Z |
game_label | stringnullable | — | — e.g. — (all-null in sample) |
game_sub_label | stringnullable | — | — e.g. — (all-null in sample) |
game_time | timestamptznullable | — | Scheduled tip-off (timezone-aware); null when the league published no time. e.g. 2025-04-13T19:30:00.000Z |
home_rotation_number | integernullable | — | — e.g. — (all-null in sample) |
home_team | string | — | — e.g. BOS |
home_team_score | integer | — | — e.g. 112 |
if_necessary | booleannullable | — | — e.g. — (all-null in sample) |
neutral_venue | boolean | — | — Values:falsetrue |
postponed_status | stringnullable | — | — e.g. — (all-null in sample) |
season_type | string | — | — Values:regular_seasonpostseasonpreseasonplay_inin_season_tournament |
series_game_number | stringnullable | — | — e.g. — (all-null in sample) |
series_name | stringnullable | — | — e.g. — (all-null in sample) |
series_text | stringnullable | — | — e.g. — (all-null in sample) |
status | string | — | — e.g. Final |
players
nba.playersEvery individual who has played in the NBA — current rosters, two-way and 10-day contracts, G-League call-ups, free agents, and retired veterans. The roster signal lives in `roster_status` (the canonical cross-league vocabulary) and `team_id` (null for free agents and retired players). Pass `?team_id=` to scope to one franchise's current roster, or omit it to scan the full historical roster pool.
GET/api/v1/nba/playersList players for NBA
Requires one of:
roster_status — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter to players whose current team_id matches. Null team_id rows (free agents, retired) are excluded when this filter is applied.
roster_statusquerystringoptionalFilter by canonical roster status. Defaults to active (current roster); pass roster_status= explicitly for other tiers (injured_reserve, free_agent, retired, inactive). The "on a team now" set is {active, injured_reserve}. Values: active, injured_reserve, free_agent, retired, inactive.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn 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/players?roster_status=example'Responses
200players rows matching the declared filter set, wrapped in { players, 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/jsonResponse Schema(40 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_player_id | integer | — | Official NBA player ID (issued by the league). Stable across seasons; use it to join other data that carries the league id. e.g. 203999 |
team_id | bigintnullable | FK to nba.teams. Null for free agents and retired players. e.g. 12 | |
birth_city | stringnullable | — | City of birth. e.g. Sombor |
birth_country | stringnullable | — | Country of birth (ISO English name). e.g. Serbia |
birth_date | datenullable | — | Birth date in YYYY-MM-DD form. e.g. 1995-02-19 |
birth_state | stringnullable | — | State / province of birth (US/Canadian players). e.g. |
display_fi_last | stringnullable | — | Display name in "F. Last" form. e.g. N. Jokić |
display_last_comma_first | stringnullable | — | Display name in "Last, First" form. Useful for sorted lists. e.g. Jokić, Nikola |
dleague_flag | stringnullable | — | Two-character bit-string from the league: "00" no G-League history, "01" G-League experience, "11" currently G-League-affiliated (two-way / assignment). e.g. 00 |
draft_number | stringnullable | — | Overall pick number within the draft (string). Empty for undrafted. e.g. 41 |
draft_round | stringnullable | — | Draft round (string). Empty for undrafted players. e.g. 2 |
draft_year | stringnullable | — | Year the player was drafted (string form). Empty for undrafted players. e.g. 2014 |
experience | integernullable | — | Years of NBA experience as of the most recent season. Rookies = 0. e.g. 10 |
first_name | string | — | Player's legal first name as registered with the league. e.g. Nikola |
from_year | stringnullable | — | Player's NBA debut year as a string (as the league records it). e.g. 2015 |
full_name | string | — | Convenience concatenation of first_name + last_name. Use this for display. e.g. Nikola Jokić |
full_position_list | stringnullable | — | Hyphenated full-word position list (e.g., "Guard-Forward", "Center-Forward"). Values:GuardForwardCenterGuard-ForwardForward-CenterCenter-ForwardForward-Guard |
games_played_flag | stringnullable | — | String "Y"/"N" indicating whether the player has played at least one regular-season game. Values:YN |
height | integernullable | — | Height in inches. e.g. 83 |
injury_body_part | stringnullable | — | Affected body part for the most recent injury (e.g., "Knee", "Ankle"). Null when injury_status is null. Values:anklekneeillnesshiptoebackwristfootcalfhamstringpelvisabdomenheelrestachillesthumbhand |
injury_detail | stringnullable | — | Free-text injury description from the source feed. e.g. |
injury_since | timestamptznullable | — | Timestamp of the injury status snapshot. Updated when player_news produces a new injury entry. e.g. 2026-04-12T18:30:00Z |
injury_status | stringnullable | — | Current injury status snapshot derived from player_news. Values: "OUT", "QUESTIONABLE"; null = no active injury designation (healthy). Values:OUTQUESTIONABLE |
jersey | stringnullable | — | Current jersey number as a string (some leagues allow leading zeros, e.g., "00"). e.g. 15 |
last_affiliation | stringnullable | — | Most recent pre-NBA affiliation (school, league, or team). e.g. Mega Basket / Serbia |
last_name | string | — | Player's legal last name. e.g. Jokić |
league_slug | stringnullable | — | NBA-issued URL slug of the player (as in the league player page). e.g. nikola-jokic |
nba_flag | stringnullable | — | String "Y"/"N" indicating NBA experience. Almost always "Y" in this table. e.g. Y |
playercode | stringnullable | — | NBA-issued player code (lastname_firstname format). e.g. jokic_nikola |
position_category | stringnullable | — | Coarse positional grouping. One of Guard, Forward, Center, Utility. Values:GuardForwardCenterUtility |
primary_position | string | — | Primary position. One of G, F, C, G-F, F-C. (True PG/SG/SF/PF splits live in team_depth_charts.position.) Values:GFCG-FF-CUnknown |
roster_status | stringnullable | — | Canonical roster status, shared across leagues. NBA source granularity is coarse: "active" (on an NBA roster), "free_agent" (no team), "inactive" (not currently rostered); injured_reserve/retired appear where derivable. The "on a team now" set is {active, injured_reserve}. Values:inactiveactivefree_agent |
school | stringnullable | — | Last school attended before the NBA (college, prep, or international club). e.g. Mega Basket |
team_abbreviation | stringnullable | — | Current team's tri-letter code. e.g. DEN |
team_city | stringnullable | — | Current team's city name. e.g. Denver |
team_code | stringnullable | — | Current team's lowercase URL slug. e.g. nuggets |
team_name | stringnullable | — | Current team's mascot name (denormalized from teams.name for read convenience). e.g. Nuggets |
to_year | stringnullable | — | Player's most recent NBA season year. Equal to from_year for rookies. e.g. 2025 |
weight | integernullable | — | Listed weight in pounds. e.g. 284 |
GET/api/v1/nba/players/{id}Get a single player by id
Parameters
idpathbigintrequiredPrimary key (id) of the player 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/players/{pk_value}'Responses
200Single player row.application/jsonshow example ▸
404Row not found.
Response Schema(40 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_player_id | integer | — | Official NBA player ID (issued by the league). Stable across seasons; use it to join other data that carries the league id. e.g. 203999 |
team_id | bigintnullable | FK to nba.teams. Null for free agents and retired players. e.g. 12 | |
birth_city | stringnullable | — | City of birth. e.g. Sombor |
birth_country | stringnullable | — | Country of birth (ISO English name). e.g. Serbia |
birth_date | datenullable | — | Birth date in YYYY-MM-DD form. e.g. 1995-02-19 |
birth_state | stringnullable | — | State / province of birth (US/Canadian players). e.g. |
display_fi_last | stringnullable | — | Display name in "F. Last" form. e.g. N. Jokić |
display_last_comma_first | stringnullable | — | Display name in "Last, First" form. Useful for sorted lists. e.g. Jokić, Nikola |
dleague_flag | stringnullable | — | Two-character bit-string from the league: "00" no G-League history, "01" G-League experience, "11" currently G-League-affiliated (two-way / assignment). e.g. 00 |
draft_number | stringnullable | — | Overall pick number within the draft (string). Empty for undrafted. e.g. 41 |
draft_round | stringnullable | — | Draft round (string). Empty for undrafted players. e.g. 2 |
draft_year | stringnullable | — | Year the player was drafted (string form). Empty for undrafted players. e.g. 2014 |
experience | integernullable | — | Years of NBA experience as of the most recent season. Rookies = 0. e.g. 10 |
first_name | string | — | Player's legal first name as registered with the league. e.g. Nikola |
from_year | stringnullable | — | Player's NBA debut year as a string (as the league records it). e.g. 2015 |
full_name | string | — | Convenience concatenation of first_name + last_name. Use this for display. e.g. Nikola Jokić |
full_position_list | stringnullable | — | Hyphenated full-word position list (e.g., "Guard-Forward", "Center-Forward"). Values:GuardForwardCenterGuard-ForwardForward-CenterCenter-ForwardForward-Guard |
games_played_flag | stringnullable | — | String "Y"/"N" indicating whether the player has played at least one regular-season game. Values:YN |
height | integernullable | — | Height in inches. e.g. 83 |
injury_body_part | stringnullable | — | Affected body part for the most recent injury (e.g., "Knee", "Ankle"). Null when injury_status is null. Values:anklekneeillnesshiptoebackwristfootcalfhamstringpelvisabdomenheelrestachillesthumbhand |
injury_detail | stringnullable | — | Free-text injury description from the source feed. e.g. |
injury_since | timestamptznullable | — | Timestamp of the injury status snapshot. Updated when player_news produces a new injury entry. e.g. 2026-04-12T18:30:00Z |
injury_status | stringnullable | — | Current injury status snapshot derived from player_news. Values: "OUT", "QUESTIONABLE"; null = no active injury designation (healthy). Values:OUTQUESTIONABLE |
jersey | stringnullable | — | Current jersey number as a string (some leagues allow leading zeros, e.g., "00"). e.g. 15 |
last_affiliation | stringnullable | — | Most recent pre-NBA affiliation (school, league, or team). e.g. Mega Basket / Serbia |
last_name | string | — | Player's legal last name. e.g. Jokić |
league_slug | stringnullable | — | NBA-issued URL slug of the player (as in the league player page). e.g. nikola-jokic |
nba_flag | stringnullable | — | String "Y"/"N" indicating NBA experience. Almost always "Y" in this table. e.g. Y |
playercode | stringnullable | — | NBA-issued player code (lastname_firstname format). e.g. jokic_nikola |
position_category | stringnullable | — | Coarse positional grouping. One of Guard, Forward, Center, Utility. Values:GuardForwardCenterUtility |
primary_position | string | — | Primary position. One of G, F, C, G-F, F-C. (True PG/SG/SF/PF splits live in team_depth_charts.position.) Values:GFCG-FF-CUnknown |
roster_status | stringnullable | — | Canonical roster status, shared across leagues. NBA source granularity is coarse: "active" (on an NBA roster), "free_agent" (no team), "inactive" (not currently rostered); injured_reserve/retired appear where derivable. The "on a team now" set is {active, injured_reserve}. Values:inactiveactivefree_agent |
school | stringnullable | — | Last school attended before the NBA (college, prep, or international club). e.g. Mega Basket |
team_abbreviation | stringnullable | — | Current team's tri-letter code. e.g. DEN |
team_city | stringnullable | — | Current team's city name. e.g. Denver |
team_code | stringnullable | — | Current team's lowercase URL slug. e.g. nuggets |
team_name | stringnullable | — | Current team's mascot name (denormalized from teams.name for read convenience). e.g. Nuggets |
to_year | stringnullable | — | Player's most recent NBA season year. Equal to from_year for rookies. e.g. 2025 |
weight | integernullable | — | Listed weight in pounds. e.g. 284 |
GET/api/v1/nba/players/searchFuzzy search NBA players by name
Parameters
qquerystringrequiredSearch query — matches against full_name (case-insensitive).
limitqueryintegeroptionaldefault 10Max results to return. Default 10; max 50.
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/players/search?q=example&limit=10'Responses
200Fuzzy search NBA players by nameapplication/jsonshow example ▸
400q is empty or exceeds 100 chars
503pg_trgm extension unavailable on the DB
Response Schema(40 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_player_id | integer | — | Official NBA player ID (issued by the league). Stable across seasons; use it to join other data that carries the league id. e.g. 203999 |
team_id | bigintnullable | FK to nba.teams. Null for free agents and retired players. e.g. 12 | |
birth_city | stringnullable | — | City of birth. e.g. Sombor |
birth_country | stringnullable | — | Country of birth (ISO English name). e.g. Serbia |
birth_date | datenullable | — | Birth date in YYYY-MM-DD form. e.g. 1995-02-19 |
birth_state | stringnullable | — | State / province of birth (US/Canadian players). e.g. |
display_fi_last | stringnullable | — | Display name in "F. Last" form. e.g. N. Jokić |
display_last_comma_first | stringnullable | — | Display name in "Last, First" form. Useful for sorted lists. e.g. Jokić, Nikola |
dleague_flag | stringnullable | — | Two-character bit-string from the league: "00" no G-League history, "01" G-League experience, "11" currently G-League-affiliated (two-way / assignment). e.g. 00 |
draft_number | stringnullable | — | Overall pick number within the draft (string). Empty for undrafted. e.g. 41 |
draft_round | stringnullable | — | Draft round (string). Empty for undrafted players. e.g. 2 |
draft_year | stringnullable | — | Year the player was drafted (string form). Empty for undrafted players. e.g. 2014 |
experience | integernullable | — | Years of NBA experience as of the most recent season. Rookies = 0. e.g. 10 |
first_name | string | — | Player's legal first name as registered with the league. e.g. Nikola |
from_year | stringnullable | — | Player's NBA debut year as a string (as the league records it). e.g. 2015 |
full_name | string | — | Convenience concatenation of first_name + last_name. Use this for display. e.g. Nikola Jokić |
full_position_list | stringnullable | — | Hyphenated full-word position list (e.g., "Guard-Forward", "Center-Forward"). Values:GuardForwardCenterGuard-ForwardForward-CenterCenter-ForwardForward-Guard |
games_played_flag | stringnullable | — | String "Y"/"N" indicating whether the player has played at least one regular-season game. Values:YN |
height | integernullable | — | Height in inches. e.g. 83 |
injury_body_part | stringnullable | — | Affected body part for the most recent injury (e.g., "Knee", "Ankle"). Null when injury_status is null. Values:anklekneeillnesshiptoebackwristfootcalfhamstringpelvisabdomenheelrestachillesthumbhand |
injury_detail | stringnullable | — | Free-text injury description from the source feed. e.g. |
injury_since | timestamptznullable | — | Timestamp of the injury status snapshot. Updated when player_news produces a new injury entry. e.g. 2026-04-12T18:30:00Z |
injury_status | stringnullable | — | Current injury status snapshot derived from player_news. Values: "OUT", "QUESTIONABLE"; null = no active injury designation (healthy). Values:OUTQUESTIONABLE |
jersey | stringnullable | — | Current jersey number as a string (some leagues allow leading zeros, e.g., "00"). e.g. 15 |
last_affiliation | stringnullable | — | Most recent pre-NBA affiliation (school, league, or team). e.g. Mega Basket / Serbia |
last_name | string | — | Player's legal last name. e.g. Jokić |
league_slug | stringnullable | — | NBA-issued URL slug of the player (as in the league player page). e.g. nikola-jokic |
nba_flag | stringnullable | — | String "Y"/"N" indicating NBA experience. Almost always "Y" in this table. e.g. Y |
playercode | stringnullable | — | NBA-issued player code (lastname_firstname format). e.g. jokic_nikola |
position_category | stringnullable | — | Coarse positional grouping. One of Guard, Forward, Center, Utility. Values:GuardForwardCenterUtility |
primary_position | string | — | Primary position. One of G, F, C, G-F, F-C. (True PG/SG/SF/PF splits live in team_depth_charts.position.) Values:GFCG-FF-CUnknown |
roster_status | stringnullable | — | Canonical roster status, shared across leagues. NBA source granularity is coarse: "active" (on an NBA roster), "free_agent" (no team), "inactive" (not currently rostered); injured_reserve/retired appear where derivable. The "on a team now" set is {active, injured_reserve}. Values:inactiveactivefree_agent |
school | stringnullable | — | Last school attended before the NBA (college, prep, or international club). e.g. Mega Basket |
team_abbreviation | stringnullable | — | Current team's tri-letter code. e.g. DEN |
team_city | stringnullable | — | Current team's city name. e.g. Denver |
team_code | stringnullable | — | Current team's lowercase URL slug. e.g. nuggets |
team_name | stringnullable | — | Current team's mascot name (denormalized from teams.name for read convenience). e.g. Nuggets |
to_year | stringnullable | — | Player's most recent NBA season year. Equal to from_year for rookies. e.g. 2025 |
weight | integernullable | — | Listed weight in pounds. e.g. 284 |
Plays
game_possessions
nba.game_possessionsEach offensive possession in an NBA game (regular season, play-in, IST, and playoffs — no preseason) — which team had the ball, how the possession started, how it ended (made shot, missed shot, turnover, foul), and how long it lasted.
GET/api/v1/nba/game_possessionsList game_possessions for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team in possession.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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_possessions?game_id=1'Responses
200game_possessions rows matching the declared filter set, wrapped in { game_possessions, 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/jsonResponse Schema(29 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 2357 | |
team_id | bigintnullable | — e.g. 19 | |
ast | integer | — | — e.g. 0 |
away_score | integer | — | — e.g. 38 |
blk | integer | — | — e.g. 0 |
cum_away_poss | integer | — | — e.g. 13 |
cum_home_poss | integer | — | — e.g. 75 |
dreb | integer | — | — e.g. 0 |
end_clock | integernullable | — | — e.g. 0 |
end_nba_event_num | integer | — | — e.g. 7 |
fg3a | integer | — | — e.g. 0 |
fg3m | integer | — | — e.g. 0 |
fga | integer | — | — e.g. 1 |
fgm | integer | — | — e.g. 0 |
fta | integer | — | — e.g. 0 |
ftm | integer | — | — e.g. 0 |
game_seconds_elapsed | integer | — | — e.g. 720 |
home_score | integer | — | — e.g. 82 |
oreb | integer | — | — e.g. 0 |
period | integer | — | — e.g. 1 |
pf | integer | — | — e.g. 0 |
pts | integer | — | — e.g. 0 |
start_clock | integer | — | — e.g. 720 |
start_nba_event_num | integer | — | — e.g. 4 |
stl | integer | — | — e.g. 0 |
time_actual_end | timestamptznullable | — | — e.g. 2024-10-30T02:08:06.000Z |
time_actual_start | timestamptznullable | — | — e.g. 2024-10-28T23:53:48.400Z |
tov | integer | — | — e.g. 0 |
GET/api/v1/nba/game_possessions/{id}Get a single game_possession by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_possession 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_possessions/{pk_value}'Responses
200Single game_possession row.application/jsonshow example ▸
404Row not found.
Response Schema(29 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 2357 | |
team_id | bigintnullable | — e.g. 19 | |
ast | integer | — | — e.g. 0 |
away_score | integer | — | — e.g. 38 |
blk | integer | — | — e.g. 0 |
cum_away_poss | integer | — | — e.g. 13 |
cum_home_poss | integer | — | — e.g. 75 |
dreb | integer | — | — e.g. 0 |
end_clock | integernullable | — | — e.g. 0 |
end_nba_event_num | integer | — | — e.g. 7 |
fg3a | integer | — | — e.g. 0 |
fg3m | integer | — | — e.g. 0 |
fga | integer | — | — e.g. 1 |
fgm | integer | — | — e.g. 0 |
fta | integer | — | — e.g. 0 |
ftm | integer | — | — e.g. 0 |
game_seconds_elapsed | integer | — | — e.g. 720 |
home_score | integer | — | — e.g. 82 |
oreb | integer | — | — e.g. 0 |
period | integer | — | — e.g. 1 |
pf | integer | — | — e.g. 0 |
pts | integer | — | — e.g. 0 |
start_clock | integer | — | — e.g. 720 |
start_nba_event_num | integer | — | — e.g. 4 |
stl | integer | — | — e.g. 0 |
time_actual_end | timestamptznullable | — | — e.g. 2024-10-30T02:08:06.000Z |
time_actual_start | timestamptznullable | — | — e.g. 2024-10-28T23:53:48.400Z |
tov | integer | — | — e.g. 0 |
play_by_plays
nba.play_by_playsEvery individual event in every NBA game (regular season, play-in, IST, and playoffs — no preseason) — made and missed shots, rebounds, assists, fouls, turnovers, blocks, steals, substitutions, and timeouts, with the game clock at the moment. Period and score context live on game_possessions (FK game_possession_id).
GET/api/v1/nba/play_by_playsList play_by_plays for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to plays involving a specific player.
team_idquerybigintoptionalFilter to plays by a specific team.
event_typequeryintegeroptionalFilter by event type code: 1 made shot, 2 missed shot, 3 free throw, 4 rebound, 5 turnover, 6 foul, 7 violation, 8 substitution, 9 timeout, 10 jump ball, 11 ejection, 12 period start, 13 period end, 18 instant replay (the league codes).
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/play_by_plays?game_id=1'Responses
200play_by_plays rows matching the declared filter set, wrapped in { play_by_plays, 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/jsonResponse Schema(21 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 2377 | |
game_possession_id | bigint | — e.g. 16457458 | |
play_id | string | — | — e.g. 0052400111_2 |
player_id | bigintnullable | — e.g. 49 | |
player2_id | bigintnullable | — e.g. 49 | |
player2_team_id | bigintnullable | — e.g. 21 | |
player3_id | bigintnullable | — e.g. 227 | |
player3_team_id | bigintnullable | — e.g. 21 | |
team_id | bigintnullable | — e.g. 21 | |
end_clock | integernullable | — | — e.g. — (all-null in sample) |
event_seq | integer | — | — e.g. 100 |
event_sub_type | integer | — | — e.g. 0 |
event_type | integer | — | — e.g. 8 |
home_description | string | — | — e.g. |
nba_event_num | integer | — | — e.g. 2 |
neutral_description | string | — | — e.g. |
possession_seq | integer | — | — e.g. 142 |
start_clock | integer | — | — e.g. 720 |
time_actual | timestamptznullable | — | — e.g. 2025-04-17T01:56:41.900Z |
visitor_description | string | — | — e.g. |
GET/api/v1/nba/play_by_plays/{id}Get a single play_by_play by id
Parameters
idpathbigintrequiredPrimary key (id) of the play_by_play 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/play_by_plays/{pk_value}'Responses
200Single play_by_play row.application/jsonshow example ▸
404Row not found.
Response Schema(21 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 2377 | |
game_possession_id | bigint | — e.g. 16457458 | |
play_id | string | — | — e.g. 0052400111_2 |
player_id | bigintnullable | — e.g. 49 | |
player2_id | bigintnullable | — e.g. 49 | |
player2_team_id | bigintnullable | — e.g. 21 | |
player3_id | bigintnullable | — e.g. 227 | |
player3_team_id | bigintnullable | — e.g. 21 | |
team_id | bigintnullable | — e.g. 21 | |
end_clock | integernullable | — | — e.g. — (all-null in sample) |
event_seq | integer | — | — e.g. 100 |
event_sub_type | integer | — | — e.g. 0 |
event_type | integer | — | — e.g. 8 |
home_description | string | — | — e.g. |
nba_event_num | integer | — | — e.g. 2 |
neutral_description | string | — | — e.g. |
possession_seq | integer | — | — e.g. 142 |
start_clock | integer | — | — e.g. 720 |
time_actual | timestamptznullable | — | — e.g. 2025-04-17T01:56:41.900Z |
visitor_description | string | — | — e.g. |
Stats
season_team_stats
nba.season_team_statsSeason totals for each NBA team — wins and losses, points scored and allowed, pace, offensive and defensive ratings, rebounding margins, shooting splits, and turnover differentials. Regular-season games only; playoff, play-in, and preseason totals are not included.
GET/api/v1/nba/season_team_statsList season_team_stats for NBA
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a single season. Defaults to the current season.
team_idquerybigintoptionalFilter by team.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/season_team_stats?season_id=2026'Responses
200season_team_stats rows matching the declared filter set, wrapped in { season_team_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/jsonResponse Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2024 | |
team_id | bigint | — e.g. 19 | |
games_played | integer | — | — e.g. 82 |
losses | integer | — | — e.g. 38 |
pts_allowed | integer | — | — e.g. 0 |
pts_scored | integer | — | — e.g. 9372 |
ties | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 44 |
GET/api/v1/nba/season_team_stats/{id}Get a single season_team_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the season_team_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/season_team_stats/{pk_value}'Responses
200Single season_team_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2024 | |
team_id | bigint | — e.g. 19 | |
games_played | integer | — | — e.g. 82 |
losses | integer | — | — e.g. 38 |
pts_allowed | integer | — | — e.g. 0 |
pts_scored | integer | — | — e.g. 9372 |
ties | integer | — | — e.g. 0 |
wins | integer | — | — e.g. 44 |
team_standings
nba.team_standingsConference and division standings throughout the NBA season — wins, losses, win percentage, games behind, last-10 record, win/loss streak, and home/away splits as of each date.
GET/api/v1/nba/team_standingsList team_standings for NBA
Requires one of:
season_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a single season. Defaults to the current season.
team_idquerybigintoptionalFilter by team.
dayqueryintegeroptionalStandings as of this day (YYYYMMDD integer). Omit for all daily snapshots, newest first; pass a day for a point-in-time table. Range syntax: day__gte=, day__lte=, day__between=.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn 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/team_standings?season_id=2026'Responses
200team_standings rows matching the declared filter set, wrapped in { team_standings, 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/jsonResponse Schema(21 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2024 | |
team_id | bigint | — e.g. 1 | |
away_losses | integer | — | — e.g. 6 |
away_wins | integer | — | — e.g. 1 |
conference_gb | decimal | — | Games back from conference leader e.g. 0.0000 |
conference_rank | integer | — | 1-15 within conference e.g. 8 |
day | integer | — | YYYYMMDD — standings as of this date (before games on this day) e.g. 20241103 |
division_rank | integer | — | 1-5 within division e.g. 1 |
games_played | integer | — | — e.g. 1 |
games_remaining | integer | — | — e.g. 81 |
home_losses | integer | — | — e.g. 4 |
home_wins | integer | — | — e.g. 1 |
l10_losses | integer | — | — e.g. 4 |
l10_wins | integer | — | — e.g. 6 |
losses | integer | — | — e.g. 1 |
playin_gb | decimal | — | Games back from 10th seed (play-in cutoff) e.g. 0.0000 |
playoff_gb | decimal | — | Games back from 6th seed (auto-qualify cutoff) e.g. 0.0000 |
streak | integer | — | Positive = win streak, negative = loss streak e.g. -1 |
win_pct | decimal | — | — e.g. 0.5000 |
wins | integer | — | — e.g. 2 |
GET/api/v1/nba/team_standings/{id}Get a single team_standing by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_standing 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/team_standings/{pk_value}'Responses
200Single team_standing row.application/jsonshow example ▸
404Row not found.
Response Schema(21 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
season_id | bigint | — e.g. 2024 | |
team_id | bigint | — e.g. 1 | |
away_losses | integer | — | — e.g. 6 |
away_wins | integer | — | — e.g. 1 |
conference_gb | decimal | — | Games back from conference leader e.g. 0.0000 |
conference_rank | integer | — | 1-15 within conference e.g. 8 |
day | integer | — | YYYYMMDD — standings as of this date (before games on this day) e.g. 20241103 |
division_rank | integer | — | 1-5 within division e.g. 1 |
games_played | integer | — | — e.g. 1 |
games_remaining | integer | — | — e.g. 81 |
home_losses | integer | — | — e.g. 4 |
home_wins | integer | — | — e.g. 1 |
l10_losses | integer | — | — e.g. 4 |
l10_wins | integer | — | — e.g. 6 |
losses | integer | — | — e.g. 1 |
playin_gb | decimal | — | Games back from 10th seed (play-in cutoff) e.g. 0.0000 |
playoff_gb | decimal | — | Games back from 6th seed (auto-qualify cutoff) e.g. 0.0000 |
streak | integer | — | Positive = win streak, negative = loss streak e.g. -1 |
win_pct | decimal | — | — e.g. 0.5000 |
wins | integer | — | — e.g. 2 |
game_player_stats
nba.game_player_statsEach 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_statsList game_player_stats for NBA
Requires one of:
game_id or player_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to a single player — their full game log, newest first. Combine with game_date ranges to window it.
team_idquerybigintoptionalFilter by team.
game_datequeryintegeroptionalFilter by game day (YYYYMMDD integer, US Eastern). Range syntax: game_date__gte=, game_date__lte=, game_date__between=.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/jsonResponse Schema(113 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
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}Get a single game_player_stat by id
Parameters
idpathbigintrequiredPrimary 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 ▸
| Field | Type | References | Description |
|---|---|---|---|
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 |
game_team_stats
nba.game_team_statsEach NBA team's stat line for each game — the same offensive, defensive, rebounding, and shooting counters as the season aggregate, broken out per game with home/away context.
GET/api/v1/nba/game_team_statsList game_team_stats for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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_stats?game_id=1'Responses
200game_team_stats rows matching the declared filter set, wrapped in { game_team_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/jsonResponse Schema(70 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 6 | |
team_id | bigint | — e.g. 12 | |
assist_percentage | decimal | — | — e.g. 0.6670 |
assist_ratio | decimal | — | — e.g. 18.8000 |
assists | integer | — | — e.g. 24 |
assists_to_turnovers | decimal | — | — e.g. 2.0000 |
bench_pts | integer | — | — e.g. 34 |
blocks | integer | — | — e.g. 4 |
conference_rank | integer | — | Conference rank entering game e.g. 10 |
defensive_rating | decimal | — | — e.g. 100.0000 |
defensive_rebound_percentage | decimal | — | — e.g. 0.6670 |
defensive_rebounds | integer | — | — e.g. 32 |
effective_field_goal_percentage | decimal | — | — e.g. 0.5000 |
estimated_defensive_rating | decimal | — | — e.g. 0.0000 |
estimated_net_rating | decimal | — | — e.g. 0.0000 |
estimated_offensive_rating | decimal | — | — e.g. 0.0000 |
estimated_pace | decimal | — | — e.g. 0.0000 |
fast_break_pts | integer | — | — e.g. 11 |
field_goal_percentage | decimal | — | — e.g. 0.5000 |
field_goals_attempted | integer | — | — e.g. 88 |
field_goals_made | integer | — | — e.g. 42 |
fouls | integer | — | — e.g. 19 |
free_throw_attempt_rate | decimal | — | — e.g. 0.2500 |
free_throw_percentage | decimal | — | — e.g. 0.7500 |
free_throws_attempted | integer | — | — e.g. 21 |
free_throws_made | integer | — | — e.g. 17 |
loss | integer | — | — e.g. 1 |
losses | integer | — | Cumulative losses e.g. 3 |
minutes | integer | — | — e.g. 48 |
net_rating | decimal | — | — e.g. 2.0000 |
offensive_rating | decimal | — | — e.g. 100.0000 |
offensive_rebound_percentage | decimal | — | — e.g. 0.3330 |
offensive_rebounds | integer | — | — e.g. 10 |
pace | decimal | — | — e.g. 101.0000 |
pace_per40 | decimal | — | — e.g. 0.0000 |
pct_ast_2pm | decimal | — | — e.g. 0.5000 |
pct_ast_3pm | decimal | — | — e.g. 1.0000 |
pct_ast_fgm | decimal | — | — e.g. 0.6670 |
pct_fga_2pt | decimal | — | — e.g. 0.6670 |
pct_fga_3pt | decimal | — | — e.g. 0.3330 |
pct_pts_2pt | decimal | — | — e.g. 0.5000 |
pct_pts_2pt_mr | decimal | — | — e.g. 0.0000 |
pct_pts_3pt | decimal | — | — e.g. 0.3330 |
pct_pts_fb | decimal | — | — e.g. 0.0960 |
pct_pts_ft | decimal | — | — e.g. 0.1670 |
pct_pts_off_tov | decimal | — | — e.g. 0.1430 |
pct_pts_paint | decimal | — | — e.g. 0.4000 |
pct_uast_2pm | decimal | — | — e.g. 0.5000 |
pct_uast_3pm | decimal | — | — e.g. 0.0000 |
pct_uast_fgm | decimal | — | — e.g. 0.3330 |
player_impact_estimate | decimal | — | — e.g. 0.4620 |
possessions | integer | — | — e.g. 101 |
pts | integer | — | — e.g. 113 |
pts_in_paint | integer | — | — e.g. 50 |
pts_off_turnovers | integer | — | — e.g. 17 |
rebound_percentage | decimal | — | — e.g. 0.5000 |
rebounds | integer | — | — e.g. 42 |
second_chance_pts | integer | — | — e.g. 12 |
steals | integer | — | — e.g. 7 |
steals_to_turnovers | decimal | — | — e.g. 0.5000 |
three_point_percentage | decimal | — | — e.g. 0.3330 |
three_pointers_attempted | integer | — | — e.g. 34 |
three_pointers_made | integer | — | — e.g. 12 |
timeouts_remaining | integer | — | — e.g. 0 |
true_shooting_percentage | decimal | — | — e.g. 0.5760 |
turnover_percentage | decimal | — | — e.g. 0.1172 |
turnovers | integer | — | — e.g. 13 |
win | integer | — | — e.g. 0 |
wins | integer | — | Cumulative wins e.g. 1 |
GET/api/v1/nba/game_team_stats/{id}Get a single game_team_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_team_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_team_stats/{pk_value}'Responses
200Single game_team_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(70 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 6 | |
team_id | bigint | — e.g. 12 | |
assist_percentage | decimal | — | — e.g. 0.6670 |
assist_ratio | decimal | — | — e.g. 18.8000 |
assists | integer | — | — e.g. 24 |
assists_to_turnovers | decimal | — | — e.g. 2.0000 |
bench_pts | integer | — | — e.g. 34 |
blocks | integer | — | — e.g. 4 |
conference_rank | integer | — | Conference rank entering game e.g. 10 |
defensive_rating | decimal | — | — e.g. 100.0000 |
defensive_rebound_percentage | decimal | — | — e.g. 0.6670 |
defensive_rebounds | integer | — | — e.g. 32 |
effective_field_goal_percentage | decimal | — | — e.g. 0.5000 |
estimated_defensive_rating | decimal | — | — e.g. 0.0000 |
estimated_net_rating | decimal | — | — e.g. 0.0000 |
estimated_offensive_rating | decimal | — | — e.g. 0.0000 |
estimated_pace | decimal | — | — e.g. 0.0000 |
fast_break_pts | integer | — | — e.g. 11 |
field_goal_percentage | decimal | — | — e.g. 0.5000 |
field_goals_attempted | integer | — | — e.g. 88 |
field_goals_made | integer | — | — e.g. 42 |
fouls | integer | — | — e.g. 19 |
free_throw_attempt_rate | decimal | — | — e.g. 0.2500 |
free_throw_percentage | decimal | — | — e.g. 0.7500 |
free_throws_attempted | integer | — | — e.g. 21 |
free_throws_made | integer | — | — e.g. 17 |
loss | integer | — | — e.g. 1 |
losses | integer | — | Cumulative losses e.g. 3 |
minutes | integer | — | — e.g. 48 |
net_rating | decimal | — | — e.g. 2.0000 |
offensive_rating | decimal | — | — e.g. 100.0000 |
offensive_rebound_percentage | decimal | — | — e.g. 0.3330 |
offensive_rebounds | integer | — | — e.g. 10 |
pace | decimal | — | — e.g. 101.0000 |
pace_per40 | decimal | — | — e.g. 0.0000 |
pct_ast_2pm | decimal | — | — e.g. 0.5000 |
pct_ast_3pm | decimal | — | — e.g. 1.0000 |
pct_ast_fgm | decimal | — | — e.g. 0.6670 |
pct_fga_2pt | decimal | — | — e.g. 0.6670 |
pct_fga_3pt | decimal | — | — e.g. 0.3330 |
pct_pts_2pt | decimal | — | — e.g. 0.5000 |
pct_pts_2pt_mr | decimal | — | — e.g. 0.0000 |
pct_pts_3pt | decimal | — | — e.g. 0.3330 |
pct_pts_fb | decimal | — | — e.g. 0.0960 |
pct_pts_ft | decimal | — | — e.g. 0.1670 |
pct_pts_off_tov | decimal | — | — e.g. 0.1430 |
pct_pts_paint | decimal | — | — e.g. 0.4000 |
pct_uast_2pm | decimal | — | — e.g. 0.5000 |
pct_uast_3pm | decimal | — | — e.g. 0.0000 |
pct_uast_fgm | decimal | — | — e.g. 0.3330 |
player_impact_estimate | decimal | — | — e.g. 0.4620 |
possessions | integer | — | — e.g. 101 |
pts | integer | — | — e.g. 113 |
pts_in_paint | integer | — | — e.g. 50 |
pts_off_turnovers | integer | — | — e.g. 17 |
rebound_percentage | decimal | — | — e.g. 0.5000 |
rebounds | integer | — | — e.g. 42 |
second_chance_pts | integer | — | — e.g. 12 |
steals | integer | — | — e.g. 7 |
steals_to_turnovers | decimal | — | — e.g. 0.5000 |
three_point_percentage | decimal | — | — e.g. 0.3330 |
three_pointers_attempted | integer | — | — e.g. 34 |
three_pointers_made | integer | — | — e.g. 12 |
timeouts_remaining | integer | — | — e.g. 0 |
true_shooting_percentage | decimal | — | — e.g. 0.5760 |
turnover_percentage | decimal | — | — e.g. 0.1172 |
turnovers | integer | — | — e.g. 13 |
win | integer | — | — e.g. 0 |
wins | integer | — | Cumulative wins e.g. 1 |
season_player_stats
nba.season_player_statsSeason totals for each NBA player — scoring, rebounding, assists, steals, blocks, shooting splits, advanced metrics, plus-minus, and minutes played. Regular-season games only; playoff, play-in, and preseason totals are not included. Players traded mid-season have one merged row (no per-team split).
GET/api/v1/nba/season_player_statsList season_player_stats for NBA
Requires one of:
season_id or player_id — requests satisfying none of these return 400.Parameters
season_idquerybigintoptionalFilter to a single season. Defaults to the current season.
player_idquerybigintoptionalFilter to a single player.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/season_player_stats?season_id=2026'Responses
200season_player_stats rows matching the declared filter set, wrapped in { season_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/jsonResponse Schema(49 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 176 | |
season_id | bigint | — e.g. 2021 | |
assist_percentage | decimal | — | — e.g. 0.0000 |
assist_ratio | decimal | — | — e.g. 0.0000 |
assist_to_turnover | decimal | — | — e.g. 0.0000 |
assists | integer | — | — e.g. 0 |
avg_dribbles_per_touch | decimal | — | — e.g. 0.0000 |
avg_seconds_per_touch | decimal | — | — e.g. 1.6400 |
blocks | integer | — | — e.g. 0 |
defensive_rating | decimal | — | — e.g. 111.1000 |
defensive_rebound_percentage | decimal | — | — e.g. 0.0000 |
defensive_rebounds | integer | — | — e.g. 0 |
double_doubles | integer | — | — e.g. 0 |
effective_field_goal_percentage | decimal | — | — e.g. 0.5000 |
field_goal_percentage | decimal | — | — e.g. 0.5000 |
field_goals_attempted | integer | — | — e.g. 6 |
field_goals_made | integer | — | — e.g. 0 |
fouls | integer | — | — e.g. 0 |
free_throw_percentage | decimal | — | — e.g. 0.0000 |
free_throws_attempted | integer | — | — e.g. 0 |
free_throws_made | integer | — | — e.g. 0 |
front_court_touches | integer | — | — e.g. 0 |
games_played | integer | — | — e.g. 68 |
losses | integer | — | — e.g. 1 |
minutes | decimal | — | — e.g. 1297.0367 |
net_rating | decimal | — | — e.g. 0.3000 |
offensive_rating | decimal | — | — e.g. 113.9000 |
offensive_rebound_percentage | decimal | — | — e.g. 0.0000 |
offensive_rebounds | integer | — | — e.g. 0 |
pace | decimal | — | — e.g. 100.6900 |
player_impact_estimate | decimal | — | — e.g. 0.0730 |
plus_minus | integer | — | — e.g. -7 |
possessions | integer | — | — e.g. 41 |
pts | integer | — | — e.g. 0 |
rebound_percentage | decimal | — | — e.g. 0.0620 |
rebounds | integer | — | — e.g. 0 |
steals | integer | — | — e.g. 0 |
three_point_percentage | decimal | — | — e.g. 0.0000 |
three_pointers_attempted | integer | — | — e.g. 0 |
three_pointers_made | integer | — | — e.g. 0 |
time_of_possession | decimal | — | — e.g. 0.0000 |
touches | integer | — | — e.g. 0 |
triple_doubles | integer | — | — e.g. 0 |
true_shooting_percentage | decimal | — | — e.g. 0.0000 |
turnover_percentage | decimal | — | — e.g. 0.0000 |
turnovers | integer | — | — e.g. 0 |
usage_percentage | decimal | — | — e.g. 0.1360 |
wins | integer | — | — e.g. 1 |
GET/api/v1/nba/season_player_stats/{id}Get a single season_player_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the season_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/season_player_stats/{pk_value}'Responses
200Single season_player_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(49 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 176 | |
season_id | bigint | — e.g. 2021 | |
assist_percentage | decimal | — | — e.g. 0.0000 |
assist_ratio | decimal | — | — e.g. 0.0000 |
assist_to_turnover | decimal | — | — e.g. 0.0000 |
assists | integer | — | — e.g. 0 |
avg_dribbles_per_touch | decimal | — | — e.g. 0.0000 |
avg_seconds_per_touch | decimal | — | — e.g. 1.6400 |
blocks | integer | — | — e.g. 0 |
defensive_rating | decimal | — | — e.g. 111.1000 |
defensive_rebound_percentage | decimal | — | — e.g. 0.0000 |
defensive_rebounds | integer | — | — e.g. 0 |
double_doubles | integer | — | — e.g. 0 |
effective_field_goal_percentage | decimal | — | — e.g. 0.5000 |
field_goal_percentage | decimal | — | — e.g. 0.5000 |
field_goals_attempted | integer | — | — e.g. 6 |
field_goals_made | integer | — | — e.g. 0 |
fouls | integer | — | — e.g. 0 |
free_throw_percentage | decimal | — | — e.g. 0.0000 |
free_throws_attempted | integer | — | — e.g. 0 |
free_throws_made | integer | — | — e.g. 0 |
front_court_touches | integer | — | — e.g. 0 |
games_played | integer | — | — e.g. 68 |
losses | integer | — | — e.g. 1 |
minutes | decimal | — | — e.g. 1297.0367 |
net_rating | decimal | — | — e.g. 0.3000 |
offensive_rating | decimal | — | — e.g. 113.9000 |
offensive_rebound_percentage | decimal | — | — e.g. 0.0000 |
offensive_rebounds | integer | — | — e.g. 0 |
pace | decimal | — | — e.g. 100.6900 |
player_impact_estimate | decimal | — | — e.g. 0.0730 |
plus_minus | integer | — | — e.g. -7 |
possessions | integer | — | — e.g. 41 |
pts | integer | — | — e.g. 0 |
rebound_percentage | decimal | — | — e.g. 0.0620 |
rebounds | integer | — | — e.g. 0 |
steals | integer | — | — e.g. 0 |
three_point_percentage | decimal | — | — e.g. 0.0000 |
three_pointers_attempted | integer | — | — e.g. 0 |
three_pointers_made | integer | — | — e.g. 0 |
time_of_possession | decimal | — | — e.g. 0.0000 |
touches | integer | — | — e.g. 0 |
triple_doubles | integer | — | — e.g. 0 |
true_shooting_percentage | decimal | — | — e.g. 0.0000 |
turnover_percentage | decimal | — | — e.g. 0.0000 |
turnovers | integer | — | — e.g. 0 |
usage_percentage | decimal | — | — e.g. 0.1360 |
wins | integer | — | — e.g. 1 |
Projections
projected_player_stats
nba.projected_player_statsOur projection of each NBA player in each game before tip — the chance to play and to start, minutes with their range, usage rate, points, rebounds, assists, steals, blocks, threes and turnovers, the common combos, and double-double and triple-double chances. One current row per game, player and engine version, the same stat line for every DFS operator; it updates until tip and never changes after. GET /api/v1/dfs/slates/{slate_id}/projections serves this stat line for every seat of a DFS slate with its fantasy points, and GET /api/v1/dfs/contests/{contest_id}/projections adds the contest's projected ownership.
GET/api/v1/nba/projected_player_statsList projected_player_stats for NBA
Requires one of:
game_id or player_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to a single player.
team_idquerybigintoptionalFilter by team.
projection_idquerybigintoptionalFilter by engine version (one id per version of our NBA engine).
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn 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/projected_player_stats?game_id=1'Responses
200projected_player_stats rows matching the declared filter set, wrapped in { projected_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/jsonResponse Schema(37 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 6029937 | |
player_id | bigint | — e.g. 221 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NBA 2.2, the NFL engine's version). e.g. 3 |
team_id | bigint | — e.g. 17 | |
ast | float | — | Projected assists (mean). e.g. 0 |
blk | float | — | Projected blocks (mean). e.g. 0 |
double_double_probability | float | — | Chance of a double-double, 0 to 1. e.g. 0 |
expected_starter | booleannullable | — | True when the player was in the expected starting lineup when the projection ran; null when no lineup was known. Values:falsetrue |
fg3m | float | — | Projected three-pointers made (mean). e.g. 0 |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's tip. e.g. 2026-01-31T00:29:59.999Z |
lineup_confirmed | booleannullable | — | True when that starting lineup was confirmed; null when no lineup was known. e.g. true |
minutes_mean | float | — | Projected minutes (mean). e.g. 0 |
minutes_p10 | float | — | Projected minutes, 10th percentile. e.g. 0 |
minutes_p25 | float | — | Projected minutes, 25th percentile. e.g. 0 |
minutes_p50 | float | — | Projected minutes, median. e.g. 0 |
minutes_p75 | float | — | Projected minutes, 75th percentile. e.g. 0 |
minutes_p90 | float | — | Projected minutes, 90th percentile. e.g. 0 |
minutes_std | float | — | Standard deviation of the projected minutes. e.g. 0 |
play_probability | float | — | Chance the player plays, 0 to 1. e.g. 1 |
position | stringnullable | — | The player's position as the roster service gave it for this game. Values:GFCG-FF-C |
pra | float | — | Projected points + rebounds + assists (mean). e.g. 0 |
pts | float | — | Projected points (mean). e.g. 0 |
pts_ast | float | — | Projected points + assists (mean). e.g. 0 |
pts_reb | float | — | Projected points + rebounds (mean). e.g. 0 |
reb | float | — | Projected rebounds (mean). e.g. 0 |
reb_ast | float | — | Projected rebounds + assists (mean). e.g. 0 |
start_probability | float | — | Chance the player starts, 0 to 1. e.g. 0 |
stat_quantiles | jsonb | — | The 10th percentile, median and 90th percentile of each projected stat, keyed by stat name (pts, reb, ast, stl, blk, fg3m, tov), each an object of p10, p50 and p90. e.g. {"ast":{"p10":0,"p50":0,"p90":0},"blk":{"p10":0,"p50":0,"p9… |
status | stringnullable | — | The player's status for this game when the projection ran, the newest change before tip from any source (the official injury report, the league's inactive list, DraftKings, FanDuel or a media report); null when no source gave one. Values:availableoutquestionableprobable |
status_source | stringnullable | — | Which source gave the status: an operator (draftkings, fanduel), a media report (media), or the league: league_report (the official injury report) or league_inactive_list (the league's inactive list). Values:fandueldraftkingsleague_reportmedia |
stl | float | — | Projected steals (mean). e.g. 0 |
stocks | float | — | Projected steals + blocks (mean). e.g. 0 |
tov | float | — | Projected turnovers (mean). e.g. 0 |
triple_double_probability | float | — | Chance of a triple-double, 0 to 1. e.g. 0 |
usage_rate | float | — | Projected usage rate (USG%) while on the floor — the player's share of the possessions his team uses (field-goal attempts + 0.44 × free-throw attempts + turnovers), scaled to five players on the floor. It sets his share of the team's projected points; 0 when he does not play. e.g. 0 |
zero_reason | stringnullable | — | Why the player projects 0 minutes (ruled out, inactive, not on the roster); null for a player who may play. e.g. out |
GET/api/v1/nba/projected_player_stats/{id}Get a single projected_player_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the projected_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/projected_player_stats/{pk_value}'Responses
200Single projected_player_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(37 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 6029937 | |
player_id | bigint | — e.g. 221 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NBA 2.2, the NFL engine's version). e.g. 3 |
team_id | bigint | — e.g. 17 | |
ast | float | — | Projected assists (mean). e.g. 0 |
blk | float | — | Projected blocks (mean). e.g. 0 |
double_double_probability | float | — | Chance of a double-double, 0 to 1. e.g. 0 |
expected_starter | booleannullable | — | True when the player was in the expected starting lineup when the projection ran; null when no lineup was known. Values:falsetrue |
fg3m | float | — | Projected three-pointers made (mean). e.g. 0 |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's tip. e.g. 2026-01-31T00:29:59.999Z |
lineup_confirmed | booleannullable | — | True when that starting lineup was confirmed; null when no lineup was known. e.g. true |
minutes_mean | float | — | Projected minutes (mean). e.g. 0 |
minutes_p10 | float | — | Projected minutes, 10th percentile. e.g. 0 |
minutes_p25 | float | — | Projected minutes, 25th percentile. e.g. 0 |
minutes_p50 | float | — | Projected minutes, median. e.g. 0 |
minutes_p75 | float | — | Projected minutes, 75th percentile. e.g. 0 |
minutes_p90 | float | — | Projected minutes, 90th percentile. e.g. 0 |
minutes_std | float | — | Standard deviation of the projected minutes. e.g. 0 |
play_probability | float | — | Chance the player plays, 0 to 1. e.g. 1 |
position | stringnullable | — | The player's position as the roster service gave it for this game. Values:GFCG-FF-C |
pra | float | — | Projected points + rebounds + assists (mean). e.g. 0 |
pts | float | — | Projected points (mean). e.g. 0 |
pts_ast | float | — | Projected points + assists (mean). e.g. 0 |
pts_reb | float | — | Projected points + rebounds (mean). e.g. 0 |
reb | float | — | Projected rebounds (mean). e.g. 0 |
reb_ast | float | — | Projected rebounds + assists (mean). e.g. 0 |
start_probability | float | — | Chance the player starts, 0 to 1. e.g. 0 |
stat_quantiles | jsonb | — | The 10th percentile, median and 90th percentile of each projected stat, keyed by stat name (pts, reb, ast, stl, blk, fg3m, tov), each an object of p10, p50 and p90. e.g. {"ast":{"p10":0,"p50":0,"p90":0},"blk":{"p10":0,"p50":0,"p9… |
status | stringnullable | — | The player's status for this game when the projection ran, the newest change before tip from any source (the official injury report, the league's inactive list, DraftKings, FanDuel or a media report); null when no source gave one. Values:availableoutquestionableprobable |
status_source | stringnullable | — | Which source gave the status: an operator (draftkings, fanduel), a media report (media), or the league: league_report (the official injury report) or league_inactive_list (the league's inactive list). Values:fandueldraftkingsleague_reportmedia |
stl | float | — | Projected steals (mean). e.g. 0 |
stocks | float | — | Projected steals + blocks (mean). e.g. 0 |
tov | float | — | Projected turnovers (mean). e.g. 0 |
triple_double_probability | float | — | Chance of a triple-double, 0 to 1. e.g. 0 |
usage_rate | float | — | Projected usage rate (USG%) while on the floor — the player's share of the possessions his team uses (field-goal attempts + 0.44 × free-throw attempts + turnovers), scaled to five players on the floor. It sets his share of the team's projected points; 0 when he does not play. e.g. 0 |
zero_reason | stringnullable | — | Why the player projects 0 minutes (ruled out, inactive, not on the roster); null for a player who may play. e.g. out |
projected_team_stats
nba.projected_team_statsOur projection of each NBA team in each game before tip — possessions and pace, total points with their range, win and overtime chances, team stat totals, and the betting lines the projection used. One current row per game, team and engine version; it updates until tip and never changes after. GET /api/v1/dfs/slates/{slate_id}/projections serves the same rows in its `teams` block for the games of a DFS slate.
GET/api/v1/nba/projected_team_statsList projected_team_stats for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
projection_idquerybigintoptionalFilter by engine version (one id per version of our NBA engine).
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 1000.
from_idquerybigintoptionalReturn 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/projected_team_stats?game_id=1'Responses
200projected_team_stats rows matching the declared filter set, wrapped in { projected_team_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/jsonResponse Schema(33 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 6029936 | |
opponent_team_id | bigint | The team this team plays in the game. e.g. 24 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NBA 2.2, the NFL engine's version). e.g. 3 |
team_id | bigint | — e.g. 24 | |
ast_mean | float | — | Projected team assists. e.g. 26.193 |
blk_mean | float | — | Projected team blocks. e.g. 4.514 |
fg3m_mean | float | — | Projected team three-pointers made. e.g. 13.099 |
implied_team_total | floatnullable | — | This team's implied points from the betting total and spread; null when no line was captured. e.g. 115.5 |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's tip. e.g. 2025-04-13T19:29:59.999Z |
is_home | boolean | — | True when this team is the home team. Values:truefalse |
lines_captured_at | timestamptznullable | — | When the betting lines the projection used were captured (UTC). e.g. 2024-11-04T05:00:00.000Z |
offensive_rating | float | — | Projected points per 100 possessions. e.g. 113.57116578410486 |
opponent_points_mean | float | — | Projected points the opponent scores (mean). e.g. 115.5 |
overtime_probability | float | — | Chance the game goes to overtime, 0 to 1. e.g. 0.056 |
pace_per_48 | float | — | Projected pace — possessions per 48 minutes. e.g. 95.80466291019982 |
possessions_mean | float | — | Projected possessions of the game (mean). e.g. 96.42541443256545 |
possessions_p10 | float | — | Projected possessions, 10th percentile. e.g. 90.95248584451933 |
possessions_p50 | float | — | Projected possessions, median. e.g. 95.89911660868471 |
possessions_p90 | float | — | Projected possessions, 90th percentile. e.g. 102.29353326932566 |
reb_mean | float | — | Projected team rebounds (the sum of its players' projected rebounds). e.g. 44.12 |
stl_mean | float | — | Projected team steals. e.g. 7.564 |
team_points_mean | float | — | Projected points this team scores (mean) — the team's total output. e.g. 115.5 |
team_points_p10 | float | — | This team's projected points, 10th percentile. e.g. 101 |
team_points_p25 | float | — | This team's projected points, 25th percentile. e.g. 107 |
team_points_p50 | float | — | This team's projected points, median. e.g. 114 |
team_points_p75 | float | — | This team's projected points, 75th percentile. e.g. 123 |
team_points_p90 | float | — | This team's projected points, 90th percentile. e.g. 130 |
team_points_std | float | — | Standard deviation of this team's projected points. e.g. 11.765627905046122 |
tov_mean | float | — | Projected team turnovers. e.g. 13.687 |
vegas_spread | floatnullable | — | Betting spread from this team's side that the projection used; null when no line was captured. e.g. 3.5 |
vegas_total | floatnullable | — | Betting game total the projection used; null when no line was captured before the projection. e.g. 227.5 |
win_probability | float | — | Chance this team wins, 0 to 1 (0.62 = 62%). e.g. 0.613 |
GET/api/v1/nba/projected_team_stats/{id}Get a single projected_team_stat by id
Parameters
idpathbigintrequiredPrimary key (id) of the projected_team_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/projected_team_stats/{pk_value}'Responses
200Single projected_team_stat row.application/jsonshow example ▸
404Row not found.
Response Schema(33 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 6029936 | |
opponent_team_id | bigint | The team this team plays in the game. e.g. 24 | |
projection_id | bigint | — | Engine version id (main.projections; STAT_API_NBA 2.2, the NFL engine's version). e.g. 3 |
team_id | bigint | — e.g. 24 | |
ast_mean | float | — | Projected team assists. e.g. 26.193 |
blk_mean | float | — | Projected team blocks. e.g. 4.514 |
fg3m_mean | float | — | Projected team three-pointers made. e.g. 13.099 |
implied_team_total | floatnullable | — | This team's implied points from the betting total and spread; null when no line was captured. e.g. 115.5 |
inputs_as_of | timestamptz | — | Time of the newest input the projection used (UTC). Always before the game's tip. e.g. 2025-04-13T19:29:59.999Z |
is_home | boolean | — | True when this team is the home team. Values:truefalse |
lines_captured_at | timestamptznullable | — | When the betting lines the projection used were captured (UTC). e.g. 2024-11-04T05:00:00.000Z |
offensive_rating | float | — | Projected points per 100 possessions. e.g. 113.57116578410486 |
opponent_points_mean | float | — | Projected points the opponent scores (mean). e.g. 115.5 |
overtime_probability | float | — | Chance the game goes to overtime, 0 to 1. e.g. 0.056 |
pace_per_48 | float | — | Projected pace — possessions per 48 minutes. e.g. 95.80466291019982 |
possessions_mean | float | — | Projected possessions of the game (mean). e.g. 96.42541443256545 |
possessions_p10 | float | — | Projected possessions, 10th percentile. e.g. 90.95248584451933 |
possessions_p50 | float | — | Projected possessions, median. e.g. 95.89911660868471 |
possessions_p90 | float | — | Projected possessions, 90th percentile. e.g. 102.29353326932566 |
reb_mean | float | — | Projected team rebounds (the sum of its players' projected rebounds). e.g. 44.12 |
stl_mean | float | — | Projected team steals. e.g. 7.564 |
team_points_mean | float | — | Projected points this team scores (mean) — the team's total output. e.g. 115.5 |
team_points_p10 | float | — | This team's projected points, 10th percentile. e.g. 101 |
team_points_p25 | float | — | This team's projected points, 25th percentile. e.g. 107 |
team_points_p50 | float | — | This team's projected points, median. e.g. 114 |
team_points_p75 | float | — | This team's projected points, 75th percentile. e.g. 123 |
team_points_p90 | float | — | This team's projected points, 90th percentile. e.g. 130 |
team_points_std | float | — | Standard deviation of this team's projected points. e.g. 11.765627905046122 |
tov_mean | float | — | Projected team turnovers. e.g. 13.687 |
vegas_spread | floatnullable | — | Betting spread from this team's side that the projection used; null when no line was captured. e.g. 3.5 |
vegas_total | floatnullable | — | Betting game total the projection used; null when no line was captured before the projection. e.g. 227.5 |
win_probability | float | — | Chance this team wins, 0 to 1 (0.62 = 62%). e.g. 0.613 |
Odds
game_lines
nba.game_linesNBA game betting lines — point spreads, moneylines, and over/under totals from sportsbooks, captured over time as the lines move from opening to closing.
GET/api/v1/nba/game_linesList game_lines for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
season_idquerybigintoptionalFilter by season.
operator_idquerybigintoptionalFilter by sportsbook id: 6 Consensus (full history), 1 DraftKings, 2 FanDuel, 1683 Pinnacle, 1684 BetMGM, 1685 Caesars, 1686 BetRivers, 1687 ESPN BET (per-book rows begin 2026-05).
is_openingquerybooleanoptionalFilter to opening lines only. Reliable from the 2025-26 season; earlier seasons largely lack opener flags.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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_lines?game_id=1'Responses
200game_lines rows matching the declared filter set, wrapped in { game_lines, 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/jsonResponse Schema(30 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 16082 | |
operator_id | bigint | Sportsbook id: 6 Consensus (full history); per-book ids (1 DraftKings, 2 FanDuel, 1683 Pinnacle, 1684 BetMGM, 1685 Caesars, 1686 BetRivers, 1687 ESPN BET) begin 2026-05. e.g. 6 | |
season_id | bigint | Denormalized for efficient season-level queries e.g. 2021 | |
captured_at | timestamptz | — | When this snapshot was captured e.g. 2022-04-10T00:00:00.000Z |
implied_away_score | decimalnullable | — | — e.g. 109.0000 |
implied_away_win_pct | decimalnullable | — | — e.g. 0.4082 |
implied_home_score | decimalnullable | — | Calculated from spread + total e.g. 109.7500 |
implied_home_win_pct | decimalnullable | — | From moneyline, 0-1 e.g. 0.6296 |
is_opening | boolean | — | True if this is the opening line Values:falsetrue |
moneyline_away | integernullable | — | American odds for away team win e.g. 145 |
moneyline_bet_pct_away | integernullable | — | — e.g. — (all-null in sample) |
moneyline_bet_pct_home | integernullable | — | — e.g. — (all-null in sample) |
moneyline_home | integernullable | — | American odds for home team win e.g. -170 |
moneyline_money_pct_away | integernullable | — | — e.g. — (all-null in sample) |
moneyline_money_pct_home | integernullable | — | — e.g. — (all-null in sample) |
over_odds | integernullable | — | American odds for over e.g. -110 |
spread | decimalnullable | — | Home team spread (e.g., -3.5 means home favored by 3.5) e.g. -2.5000 |
spread_away_odds | integernullable | — | American odds for away spread e.g. -110 |
spread_bet_pct_away | integernullable | — | — e.g. — (all-null in sample) |
spread_bet_pct_home | integernullable | — | — e.g. — (all-null in sample) |
spread_home_odds | integernullable | — | American odds for home spread (e.g., -110) e.g. -110 |
spread_money_pct_away | integernullable | — | — e.g. — (all-null in sample) |
spread_money_pct_home | integernullable | — | — e.g. — (all-null in sample) |
total | decimalnullable | — | Combined score total line (e.g., 224.5) e.g. 225.5000 |
total_bet_pct_over | integernullable | — | — e.g. — (all-null in sample) |
total_bet_pct_under | integernullable | — | — e.g. — (all-null in sample) |
total_money_pct_over | integernullable | — | — e.g. — (all-null in sample) |
total_money_pct_under | integernullable | — | — e.g. — (all-null in sample) |
under_odds | integernullable | — | American odds for under e.g. -110 |
GET/api/v1/nba/game_lines/{id}Get a single game_line by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_line 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_lines/{pk_value}'Responses
200Single game_line row.application/jsonshow example ▸
404Row not found.
Response Schema(30 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 16082 | |
operator_id | bigint | Sportsbook id: 6 Consensus (full history); per-book ids (1 DraftKings, 2 FanDuel, 1683 Pinnacle, 1684 BetMGM, 1685 Caesars, 1686 BetRivers, 1687 ESPN BET) begin 2026-05. e.g. 6 | |
season_id | bigint | Denormalized for efficient season-level queries e.g. 2021 | |
captured_at | timestamptz | — | When this snapshot was captured e.g. 2022-04-10T00:00:00.000Z |
implied_away_score | decimalnullable | — | — e.g. 109.0000 |
implied_away_win_pct | decimalnullable | — | — e.g. 0.4082 |
implied_home_score | decimalnullable | — | Calculated from spread + total e.g. 109.7500 |
implied_home_win_pct | decimalnullable | — | From moneyline, 0-1 e.g. 0.6296 |
is_opening | boolean | — | True if this is the opening line Values:falsetrue |
moneyline_away | integernullable | — | American odds for away team win e.g. 145 |
moneyline_bet_pct_away | integernullable | — | — e.g. — (all-null in sample) |
moneyline_bet_pct_home | integernullable | — | — e.g. — (all-null in sample) |
moneyline_home | integernullable | — | American odds for home team win e.g. -170 |
moneyline_money_pct_away | integernullable | — | — e.g. — (all-null in sample) |
moneyline_money_pct_home | integernullable | — | — e.g. — (all-null in sample) |
over_odds | integernullable | — | American odds for over e.g. -110 |
spread | decimalnullable | — | Home team spread (e.g., -3.5 means home favored by 3.5) e.g. -2.5000 |
spread_away_odds | integernullable | — | American odds for away spread e.g. -110 |
spread_bet_pct_away | integernullable | — | — e.g. — (all-null in sample) |
spread_bet_pct_home | integernullable | — | — e.g. — (all-null in sample) |
spread_home_odds | integernullable | — | American odds for home spread (e.g., -110) e.g. -110 |
spread_money_pct_away | integernullable | — | — e.g. — (all-null in sample) |
spread_money_pct_home | integernullable | — | — e.g. — (all-null in sample) |
total | decimalnullable | — | Combined score total line (e.g., 224.5) e.g. 225.5000 |
total_bet_pct_over | integernullable | — | — e.g. — (all-null in sample) |
total_bet_pct_under | integernullable | — | — e.g. — (all-null in sample) |
total_money_pct_over | integernullable | — | — e.g. — (all-null in sample) |
total_money_pct_under | integernullable | — | — e.g. — (all-null in sample) |
under_odds | integernullable | — | American odds for under e.g. -110 |
game_period_lines
nba.game_period_linesPeriod-specific NBA betting lines — first-half, second-half, and individual-quarter spreads, moneylines, and totals offered alongside the full-game markets.
GET/api/v1/nba/game_period_linesList game_period_lines for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
season_idquerybigintoptionalFilter by season.
operator_idquerybigintoptionalFilter by sportsbook.
period_codequerystringoptionalFilter by period (1H, 2H, Q1, Q2, Q3, Q4).
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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_period_lines?game_id=1'Responses
200game_period_lines rows matching the declared filter set, wrapped in { game_period_lines, 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/jsonResponse Schema(17 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 769 | |
operator_id | bigint | Data source (consensus, DraftKings, FanDuel, etc.) e.g. 6 | |
season_id | bigint | Denormalized for efficient season-level queries e.g. 2025 | |
captured_at | timestamptz | — | When this snapshot was captured e.g. 2024-01-05T05:00:00.000Z |
implied_away_win_pct | decimalnullable | — | — e.g. 0.5121951219512195 |
implied_home_win_pct | decimalnullable | — | From moneyline, 0-1 e.g. 0.5121951219512195 |
is_opening | boolean | — | True if this is the first captured line for this period e.g. false |
moneyline_away | integernullable | — | American odds for away team win in this period e.g. -105 |
moneyline_home | integernullable | — | American odds for home team win in this period e.g. -105 |
over_odds | integernullable | — | American odds for over e.g. -110 |
period_code | string | — | Market period code (1H, 2H, Q1, Q2, Q3, Q4) Values:1HQ1Q3Q4Q22H |
spread | decimalnullable | — | Home team spread for this period e.g. -0.5 |
spread_away_odds | integernullable | — | American odds for away spread e.g. -110 |
spread_home_odds | integernullable | — | American odds for home spread (e.g., -110) e.g. -110 |
total | decimalnullable | — | Combined score total line for this period e.g. 57.5 |
under_odds | integernullable | — | American odds for under e.g. -110 |
GET/api/v1/nba/game_period_lines/{id}Get a single game_period_line by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_period_line 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_period_lines/{pk_value}'Responses
200Single game_period_line row.application/jsonshow example ▸
404Row not found.
Response Schema(17 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 769 | |
operator_id | bigint | Data source (consensus, DraftKings, FanDuel, etc.) e.g. 6 | |
season_id | bigint | Denormalized for efficient season-level queries e.g. 2025 | |
captured_at | timestamptz | — | When this snapshot was captured e.g. 2024-01-05T05:00:00.000Z |
implied_away_win_pct | decimalnullable | — | — e.g. 0.5121951219512195 |
implied_home_win_pct | decimalnullable | — | From moneyline, 0-1 e.g. 0.5121951219512195 |
is_opening | boolean | — | True if this is the first captured line for this period e.g. false |
moneyline_away | integernullable | — | American odds for away team win in this period e.g. -105 |
moneyline_home | integernullable | — | American odds for home team win in this period e.g. -105 |
over_odds | integernullable | — | American odds for over e.g. -110 |
period_code | string | — | Market period code (1H, 2H, Q1, Q2, Q3, Q4) Values:1HQ1Q3Q4Q22H |
spread | decimalnullable | — | Home team spread for this period e.g. -0.5 |
spread_away_odds | integernullable | — | American odds for away spread e.g. -110 |
spread_home_odds | integernullable | — | American odds for home spread (e.g., -110) e.g. -110 |
total | decimalnullable | — | Combined score total line for this period e.g. 57.5 |
under_odds | integernullable | — | American odds for under e.g. -110 |
game_player_props
nba.game_player_propsNBA player prop bets for each game — points, rebounds, assists, threes made, steals, blocks, and other player-statistic markets offered by sportsbooks.
GET/api/v1/nba/game_player_propsList game_player_props for NBA
Requires one of:
game_id or player_id + season_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
player_idquerybigintoptionalFilter to a single player. With season_id: the player's prop history across a season.
season_idquerybigintoptionalFilter by season.
operator_idquerybigintoptionalFilter by sportsbook. Historical rows are operator 6 (Consensus); per-book rows (1 DraftKings, 2 FanDuel, 1683 Pinnacle, 1684 BetMGM, 1685 Caesars, 1686 BetRivers, 1687 ESPN BET) begin 2026-05.
categoryquerystringoptionalFilter by prop category (points, rebounds, assists, pra, etc.). Values: assists, blocks, double_double, points, pts_assists, pts_rebounds, pts_rebounds_assists, rebounds, rebounds_assists, steals, steals_blocks, three_pointers_made, triple_double, turnovers.
market_keyquerystringoptionalFilter by raw market key (e.g., player_points). Values: player_assists, player_blocks, player_blocks_steals, player_double_double, player_points, player_points_assists, player_points_rebounds, player_points_rebounds_assists, player_rebounds, player_rebounds_assists, player_steals, player_threes, player_triple_double, player_turnovers.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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_props?game_id=1'Responses
200game_player_props rows matching the declared filter set, wrapped in { game_player_props, 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/jsonResponse Schema(18 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 126 | |
operator_id | bigint | Usually consensus e.g. 6 | |
player_id | bigint | — e.g. 157 | |
season_id | bigint | Denormalized for efficient season-level queries e.g. 2025 | |
book_count | integer | — | Number of curated books contributing to this consensus value e.g. 3 |
captured_at | timestamptz | — | When this snapshot was captured e.g. 2025-10-22T04:00:00.000Z |
category | string | — | Canonical category (points, rebounds, assists, pra, etc.) Values:pointsreboundsthree_pointers_madepts_reboundsdouble_doubleassistspts_rebounds_assistsrebounds_assistspts_assiststriple_doubleblockssteals |
is_opening | boolean | — | True if this is the first captured line for this player/market e.g. false |
line | decimalnullable | — | Prop line for over/under markets (e.g., 24.5) e.g. 1.5 |
market_key | string | — | Raw market key from source API (e.g., player_points) Values:player_pointsplayer_reboundsplayer_threesplayer_points_reboundsplayer_double_doubleplayer_assistsplayer_points_rebounds_…player_rebounds_assistsplayer_points_assistsplayer_triple_doubleplayer_blocksplayer_steals |
no_odds | integernullable | — | American odds for no e.g. -10000 |
outcome_type | string | — | ou | yes_no Values:ouyes_no |
over_odds | integernullable | — | American odds for over e.g. -120 |
period_code | stringnullable | — | Optional period code (Q1, 1H) e.g. — (all-null in sample) |
subcategory | stringnullable | — | Optional subtype (alternate, boosted, etc.) e.g. — (all-null in sample) |
under_odds | integernullable | — | American odds for under e.g. -110 |
yes_odds | integernullable | — | American odds for yes e.g. 1100 |
GET/api/v1/nba/game_player_props/{id}Get a single game_player_prop by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_player_prop 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_props/{pk_value}'Responses
200Single game_player_prop row.application/jsonshow example ▸
404Row not found.
Response Schema(18 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 126 | |
operator_id | bigint | Usually consensus e.g. 6 | |
player_id | bigint | — e.g. 157 | |
season_id | bigint | Denormalized for efficient season-level queries e.g. 2025 | |
book_count | integer | — | Number of curated books contributing to this consensus value e.g. 3 |
captured_at | timestamptz | — | When this snapshot was captured e.g. 2025-10-22T04:00:00.000Z |
category | string | — | Canonical category (points, rebounds, assists, pra, etc.) Values:pointsreboundsthree_pointers_madepts_reboundsdouble_doubleassistspts_rebounds_assistsrebounds_assistspts_assiststriple_doubleblockssteals |
is_opening | boolean | — | True if this is the first captured line for this player/market e.g. false |
line | decimalnullable | — | Prop line for over/under markets (e.g., 24.5) e.g. 1.5 |
market_key | string | — | Raw market key from source API (e.g., player_points) Values:player_pointsplayer_reboundsplayer_threesplayer_points_reboundsplayer_double_doubleplayer_assistsplayer_points_rebounds_…player_rebounds_assistsplayer_points_assistsplayer_triple_doubleplayer_blocksplayer_steals |
no_odds | integernullable | — | American odds for no e.g. -10000 |
outcome_type | string | — | ou | yes_no Values:ouyes_no |
over_odds | integernullable | — | American odds for over e.g. -120 |
period_code | stringnullable | — | Optional period code (Q1, 1H) e.g. — (all-null in sample) |
subcategory | stringnullable | — | Optional subtype (alternate, boosted, etc.) e.g. — (all-null in sample) |
under_odds | integernullable | — | American odds for under e.g. -110 |
yes_odds | integernullable | — | American odds for yes e.g. 1100 |
Lineups & Roster
coaching_staffs
nba.coaching_staffsNBA coaches and staff — head coaches, lead assistants, player-development coaches, and other basketball-operations staff who appear on team benches.
GET/api/v1/nba/coaching_staffsList coaching_staffs for NBA
Parameters
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/coaching_staffs?limit=3'Responses
200coaching_staffs rows matching the declared filter set, wrapped in { coaching_staffs, 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/jsonResponse Schema(5 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
coach_id | integer | — | Official NBA coach/staff ID (issued by the league) e.g. 57 |
first_name | string | — | — e.g. Mike |
last_name | string | — | — e.g. Jones |
name | string | — | — e.g. Stacey Augmon |
GET/api/v1/nba/coaching_staffs/{id}Get a single coaching_staff by id
Parameters
idpathbigintrequiredPrimary key (id) of the coaching_staff 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/coaching_staffs/{pk_value}'Responses
200Single coaching_staff row.application/jsonshow example ▸
404Row not found.
Response Schema(5 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
coach_id | integer | — | Official NBA coach/staff ID (issued by the league) e.g. 57 |
first_name | string | — | — e.g. Mike |
last_name | string | — | — e.g. Jones |
name | string | — | — e.g. Stacey Augmon |
team_coaching_staffs
nba.team_coaching_staffsThe coaching staff each NBA team carries through the season — head coach, assistants, trainers — with the dates each staff member started and ended their tenure.
GET/api/v1/nba/team_coaching_staffsList team_coaching_staffs for NBA
Requires one of:
team_id — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter by team.
season_idquerybigintoptionalFilter to a season.
coach_typequerystringoptionalFilter by coach role (Head Coach, Assistant Coach, Trainer). Values: Assistant Coach, Assistant Coach for Player Development, Assistant Trainer, Associate Head Coach, Director of Athletic Development, Head Coach, Interim Head Coach, Lead Assistant Coach, Strength and Conditioning Coach, Trainer.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/team_coaching_staffs?team_id=1'Responses
200team_coaching_staffs rows matching the declared filter set, wrapped in { team_coaching_staffs, 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/jsonResponse Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
coaching_staff_id | bigint | — e.g. 96 | |
season_id | bigint | First season of this tenure e.g. 2026 | |
team_id | bigint | — e.g. 26 | |
coach_type | string | — | Head Coach, Assistant Coach, Trainer Values:Assistant CoachHead CoachTrainerAssistant Coach for Pla…Associate Head CoachLead Assistant CoachAssistant TrainerStrength and Conditioni…Director of Athletic De…Interim Head Coach |
end_date | datenullable | — | Tenure end date. NULL = still active. e.g. 2021-10-18 |
is_assistant | boolean | — | — Values:truefalse |
sort_sequence | integernullable | — | — e.g. 4 |
start_date | date | — | Tenure start date (derived from season start) e.g. 2025-10-21 |
GET/api/v1/nba/team_coaching_staffs/{id}Get a single team_coaching_staff by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_coaching_staff 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/team_coaching_staffs/{pk_value}'Responses
200Single team_coaching_staff row.application/jsonshow example ▸
404Row not found.
Response Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
coaching_staff_id | bigint | — e.g. 96 | |
season_id | bigint | First season of this tenure e.g. 2026 | |
team_id | bigint | — e.g. 26 | |
coach_type | string | — | Head Coach, Assistant Coach, Trainer Values:Assistant CoachHead CoachTrainerAssistant Coach for Pla…Associate Head CoachLead Assistant CoachAssistant TrainerStrength and Conditioni…Director of Athletic De…Interim Head Coach |
end_date | datenullable | — | Tenure end date. NULL = still active. e.g. 2021-10-18 |
is_assistant | boolean | — | — Values:truefalse |
sort_sequence | integernullable | — | — e.g. 4 |
start_date | date | — | Tenure start date (derived from season start) e.g. 2025-10-21 |
game_team_lineup_stints
nba.game_team_lineup_stintsEach continuous stretch an NBA team had the same five players on the floor (regular season, play-in, IST, and playoffs — no preseason) — the five-man unit, when it started and ended, and the team's net production while it was in.
GET/api/v1/nba/game_team_lineup_stintsList game_team_lineup_stints for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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_lineup_stints?game_id=1'Responses
200game_team_lineup_stints rows matching the declared filter set, wrapped in { game_team_lineup_stints, 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/jsonResponse Schema(25 fields)show schema ▸
45 total fields (1 nested object/array groups)
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 127 | |
player1_id | bigint | — e.g. 57 | |
player2_id | bigint | — e.g. 197 | |
player3_id | bigint | — e.g. 187 | |
player4_id | bigint | — e.g. 294 | |
player5_id | bigint | — e.g. 258 | |
team_id | bigint | — e.g. 12 | |
assist_pct | decimal | — | — e.g. 0.0000 |
defensive_rating | decimal | — | — e.g. 0.0000 |
defensive_rebound_pct | decimal | — | — e.g. 1.0000 |
end_clock | integer | — | — e.g. 0 |
end_event_seq | integer | — | — e.g. 7200 |
net_rating | decimal | — | — e.g. 0.0000 |
offensive_rating | decimal | — | — e.g. 0.0000 |
offensive_rebound_pct | decimal | — | — e.g. 0.0000 |
pace | decimal | — | — e.g. 0.0000 |
period | integer | — | — e.g. 2 |
player_stats | jsonb | — | Array of individual player box scores and metrics recorded during this lineup stint. e.g. [{"ast":0,"astShare":0,"blk":0,"corner3Rate":0,"dreb":0,"fg… |
↳playerId player_stats.playerId | integernullable | — | NBA Player ID |
↳pts player_stats.pts | integernullable | — | Points scored during stint |
↳ast player_stats.ast | integernullable | — | Assists recorded |
↳dreb player_stats.dreb | integernullable | — | Defensive rebounds |
↳oreb player_stats.oreb | integernullable | — | Offensive rebounds |
↳stl player_stats.stl | integernullable | — | Steals |
↳blk player_stats.blk | integernullable | — | Blocks |
↳tov player_stats.tov | integernullable | — | Turnovers |
↳pf player_stats.pf | integernullable | — | Personal fouls |
↳fga player_stats.fga | integernullable | — | Field goal attempts |
↳fgm player_stats.fgm | integernullable | — | Field goals made |
↳fta player_stats.fta | integernullable | — | Free throw attempts |
↳ftm player_stats.ftm | integernullable | — | Free throws made |
↳astShare player_stats.astShare | decimalnullable | — | Share of team assists |
↳rebShare player_stats.rebShare | decimalnullable | — | Share of team rebounds |
↳usagePct player_stats.usagePct | decimalnullable | — | Usage percentage during stint |
↳teammateTs player_stats.teammateTs | decimalnullable | — | Teammate true shooting percentage |
↳corner3Rate player_stats.corner3Rate | decimalnullable | — | Corner 3 attempt rate |
↳oppFoulRate player_stats.oppFoulRate | decimalnullable | — | Opponent foul rate |
↳teammateAstPct player_stats.teammateAstPct | decimalnullable | — | Teammate assist percentage |
possessions | integer | — | — e.g. 1 |
pts_allowed | integer | — | — e.g. 0 |
pts_scored | integer | — | — e.g. 0 |
start_clock | integer | — | — e.g. 720 |
start_event_seq | integer | — | — e.g. 100 |
turnover_pct | decimal | — | — e.g. 0.0000 |
GET/api/v1/nba/game_team_lineup_stints/{id}Get a single game_team_lineup_stint by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_team_lineup_stint 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_team_lineup_stints/{pk_value}'Responses
200Single game_team_lineup_stint row.application/jsonshow example ▸
404Row not found.
Response Schema(25 fields)show schema ▸
45 total fields (1 nested object/array groups)
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 127 | |
player1_id | bigint | — e.g. 57 | |
player2_id | bigint | — e.g. 197 | |
player3_id | bigint | — e.g. 187 | |
player4_id | bigint | — e.g. 294 | |
player5_id | bigint | — e.g. 258 | |
team_id | bigint | — e.g. 12 | |
assist_pct | decimal | — | — e.g. 0.0000 |
defensive_rating | decimal | — | — e.g. 0.0000 |
defensive_rebound_pct | decimal | — | — e.g. 1.0000 |
end_clock | integer | — | — e.g. 0 |
end_event_seq | integer | — | — e.g. 7200 |
net_rating | decimal | — | — e.g. 0.0000 |
offensive_rating | decimal | — | — e.g. 0.0000 |
offensive_rebound_pct | decimal | — | — e.g. 0.0000 |
pace | decimal | — | — e.g. 0.0000 |
period | integer | — | — e.g. 2 |
player_stats | jsonb | — | Array of individual player box scores and metrics recorded during this lineup stint. e.g. [{"ast":0,"astShare":0,"blk":0,"corner3Rate":0,"dreb":0,"fg… |
↳playerId player_stats.playerId | integernullable | — | NBA Player ID |
↳pts player_stats.pts | integernullable | — | Points scored during stint |
↳ast player_stats.ast | integernullable | — | Assists recorded |
↳dreb player_stats.dreb | integernullable | — | Defensive rebounds |
↳oreb player_stats.oreb | integernullable | — | Offensive rebounds |
↳stl player_stats.stl | integernullable | — | Steals |
↳blk player_stats.blk | integernullable | — | Blocks |
↳tov player_stats.tov | integernullable | — | Turnovers |
↳pf player_stats.pf | integernullable | — | Personal fouls |
↳fga player_stats.fga | integernullable | — | Field goal attempts |
↳fgm player_stats.fgm | integernullable | — | Field goals made |
↳fta player_stats.fta | integernullable | — | Free throw attempts |
↳ftm player_stats.ftm | integernullable | — | Free throws made |
↳astShare player_stats.astShare | decimalnullable | — | Share of team assists |
↳rebShare player_stats.rebShare | decimalnullable | — | Share of team rebounds |
↳usagePct player_stats.usagePct | decimalnullable | — | Usage percentage during stint |
↳teammateTs player_stats.teammateTs | decimalnullable | — | Teammate true shooting percentage |
↳corner3Rate player_stats.corner3Rate | decimalnullable | — | Corner 3 attempt rate |
↳oppFoulRate player_stats.oppFoulRate | decimalnullable | — | Opponent foul rate |
↳teammateAstPct player_stats.teammateAstPct | decimalnullable | — | Teammate assist percentage |
possessions | integer | — | — e.g. 1 |
pts_allowed | integer | — | — e.g. 0 |
pts_scored | integer | — | — e.g. 0 |
start_clock | integer | — | — e.g. 720 |
start_event_seq | integer | — | — e.g. 100 |
turnover_pct | decimal | — | — e.g. 0.0000 |
game_team_rosters
nba.game_team_rostersThe 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.
GET/api/v1/nba/game_team_rostersList game_team_rosters for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
player_idquerybigintoptionalFilter to a single player.
positionquerystringoptionalFilter by player position (G, F, C, G-F, F-C).
statusqueryintegeroptionalFilter by roster availability code (1=Active, 2=Inactive, 3=Out), as the mode shows it.
injury_statusquerystringoptionalFilter by injury designation, as the mode shows it. Values: DOUBTFUL, OUT, PROBABLE, QUESTIONABLE.
depth_orderqueryintegeroptionalFilter by depth-chart rank (e.g., 1 for the first player at each position). Range syntax: depth_order__lte=.
modequerystringoptionaldefault preTime 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 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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, 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/jsonResponse Schema(12 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
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. e.g. — (all-null in sample) |
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. e.g. — (all-null in sample) |
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}Get a single game_team_roster by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_team_roster row.
modequerystringoptionaldefault preTime 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 ▸
| Field | Type | References | Description |
|---|---|---|---|
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. e.g. — (all-null in sample) |
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. e.g. — (all-null in sample) |
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 |
team_depth_charts
nba.team_depth_chartsEach NBA team's depth chart by position on each date — the starter, second-unit, and bench order at point guard, shooting guard, small forward, power forward, and center, with injury designations layered in.
GET/api/v1/nba/team_depth_chartsList team_depth_charts for NBA
Requires one of:
team_id + season_id — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter by team.
season_idquerybigintoptionalFilter to a season. Defaults to the current season.
positionquerystringoptionalFilter by position (PG, SG, SF, PF, C). Values: C, PF, PG, SF, SG.
dayqueryintegeroptionalSnapshot day (YYYYMMDD integer). The table holds one snapshot per day; pass the latest day for the current depth chart. Range syntax: day__gte=, day__lte=, day__between=.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn 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/team_depth_charts?team_id=1&season_id=2026'Responses
200team_depth_charts rows matching the declared filter set, wrapped in { team_depth_charts, 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/jsonResponse Schema(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 428 | |
season_id | bigint | — e.g. 2025 | |
team_id | bigint | — e.g. 4 | |
day | integer | — | YYYYMMDD snapshot day e.g. 20260214 |
depth_rank | integer | — | 1-based rank within position (1 = starter) e.g. 1 |
injury_status | stringnullable | — | Injury designation (Day-To-Day, Out, etc.) Values:OutDay-To-DaySuspension |
position | string | — | PG, SG, SF, PF, C Values:SFSGPFPGC |
GET/api/v1/nba/team_depth_charts/{id}Get a single team_depth_chart by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_depth_chart 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/team_depth_charts/{pk_value}'Responses
200Single team_depth_chart row.application/jsonshow example ▸
404Row not found.
Response Schema(8 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
player_id | bigint | — e.g. 428 | |
season_id | bigint | — e.g. 2025 | |
team_id | bigint | — e.g. 4 | |
day | integer | — | YYYYMMDD snapshot day e.g. 20260214 |
depth_rank | integer | — | 1-based rank within position (1 = starter) e.g. 1 |
injury_status | stringnullable | — | Injury designation (Day-To-Day, Out, etc.) Values:OutDay-To-DaySuspension |
position | string | — | PG, SG, SF, PF, C Values:SFSGPFPGC |
Misc
stadiums
nba.stadiumsNBA arenas — current home venues and historical buildings the league's teams have played in.
GET/api/v1/nba/stadiumsList stadiums for NBA
Parameters
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/stadiums?limit=3'Responses
200stadiums rows matching the declared filter set, wrapped in { stadiums, 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/jsonResponse Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_stadium_id | integernullable | — | Official NBA arena ID (issued by the league) e.g. 643 |
address | stringnullable | — | — e.g. — (all-null in sample) |
capacity | integernullable | — | — e.g. — (all-null in sample) |
city | string | — | — e.g. Orlando |
closed_date | timestamptznullable | — | — e.g. — (all-null in sample) |
country | stringnullable | — | — Values:USGBFRDEAEJPCAMX |
description | stringnullable | — | — e.g. Home of the Toronto Raptors. Multi-purpose arena in downtow… |
elevation | floatnullable | — | Elevation in feet above sea level e.g. 198 |
image_url | stringnullable | — | URL to aerial/overview image of arena e.g. — (all-null in sample) |
latitude | floatnullable | — | — e.g. 25.7814 |
longitude | floatnullable | — | — e.g. -80.187 |
name | string | — | — e.g. Scotiabank Arena |
opened_date | timestamptznullable | — | — e.g. — (all-null in sample) |
roof_type | stringnullable | — | Arena roof type (all indoor) e.g. — (all-null in sample) |
state | stringnullable | — | — e.g. FL |
surface | stringnullable | — | — e.g. — (all-null in sample) |
team_name | stringnullable | — | — e.g. — (all-null in sample) |
timezone | stringnullable | — | IANA timezone (e.g., America/New_York) Values:America/New_YorkAmerica/ChicagoAmerica/Los_AngelesAmerica/DenverAmerica/PhoenixAmerica/Mexico_CityAmerica/TorontoAmerica/Indiana/Indiana…Europe/LondonEurope/ParisEurope/BerlinAsia/DubaiAmerica/Puerto_RicoAmerica/VancouverAsia/ShanghaiPacific/HonoluluAsia/TokyoAmerica/EdmontonAmerica/Montreal |
GET/api/v1/nba/stadiums/{id}Get a single stadium by id
Parameters
idpathbigintrequiredPrimary key (id) of the stadium 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/stadiums/{pk_value}'Responses
200Single stadium row.application/jsonshow example ▸
404Row not found.
Response Schema(19 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
league_stadium_id | integernullable | — | Official NBA arena ID (issued by the league) e.g. 643 |
address | stringnullable | — | — e.g. — (all-null in sample) |
capacity | integernullable | — | — e.g. — (all-null in sample) |
city | string | — | — e.g. Orlando |
closed_date | timestamptznullable | — | — e.g. — (all-null in sample) |
country | stringnullable | — | — Values:USGBFRDEAEJPCAMX |
description | stringnullable | — | — e.g. Home of the Toronto Raptors. Multi-purpose arena in downtow… |
elevation | floatnullable | — | Elevation in feet above sea level e.g. 198 |
image_url | stringnullable | — | URL to aerial/overview image of arena e.g. — (all-null in sample) |
latitude | floatnullable | — | — e.g. 25.7814 |
longitude | floatnullable | — | — e.g. -80.187 |
name | string | — | — e.g. Scotiabank Arena |
opened_date | timestamptznullable | — | — e.g. — (all-null in sample) |
roof_type | stringnullable | — | Arena roof type (all indoor) e.g. — (all-null in sample) |
state | stringnullable | — | — e.g. FL |
surface | stringnullable | — | — e.g. — (all-null in sample) |
team_name | stringnullable | — | — e.g. — (all-null in sample) |
timezone | stringnullable | — | IANA timezone (e.g., America/New_York) Values:America/New_YorkAmerica/ChicagoAmerica/Los_AngelesAmerica/DenverAmerica/PhoenixAmerica/Mexico_CityAmerica/TorontoAmerica/Indiana/Indiana…Europe/LondonEurope/ParisEurope/BerlinAsia/DubaiAmerica/Puerto_RicoAmerica/VancouverAsia/ShanghaiPacific/HonoluluAsia/TokyoAmerica/EdmontonAmerica/Montreal |
broadcasters
nba.broadcastersNetworks, regional sports networks, and streaming services that air NBA games — ESPN, TNT, ABC, NBA TV, plus team-local RSNs like YES, MSG, and Bally Sports.
GET/api/v1/nba/broadcastersList broadcasters for NBA
Parameters
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/broadcasters?limit=3'Responses
200broadcasters rows matching the declared filter set, wrapped in { broadcasters, 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/jsonResponse Schema(11 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
broadcaster_team_id | integer | — | — e.g. 0 |
region_id | integer | — | — e.g. 0 |
broadcaster_abbreviation | string | — | — e.g. BSIN |
broadcaster_description | stringnullable | — | — e.g. — (all-null in sample) |
broadcaster_display | string | — | — e.g. BSIN |
broadcaster_media | string | — | — e.g. tv |
broadcaster_ranking | integer | — | — e.g. 0 |
broadcaster_scope | string | — | — Values:localnational |
broadcaster_video_link | stringnullable | — | — e.g. — (all-null in sample) |
tape_delay_comments | stringnullable | — | — e.g. — (all-null in sample) |
GET/api/v1/nba/broadcasters/{id}Get a single broadcaster by id
Parameters
idpathbigintrequiredPrimary key (id) of the broadcaster 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/broadcasters/{pk_value}'Responses
200Single broadcaster row.application/jsonshow example ▸
404Row not found.
Response Schema(11 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
broadcaster_team_id | integer | — | — e.g. 0 |
region_id | integer | — | — e.g. 0 |
broadcaster_abbreviation | string | — | — e.g. BSIN |
broadcaster_description | stringnullable | — | — e.g. — (all-null in sample) |
broadcaster_display | string | — | — e.g. BSIN |
broadcaster_media | string | — | — e.g. tv |
broadcaster_ranking | integer | — | — e.g. 0 |
broadcaster_scope | string | — | — Values:localnational |
broadcaster_video_link | stringnullable | — | — e.g. — (all-null in sample) |
tape_delay_comments | stringnullable | — | — e.g. — (all-null in sample) |
referees
nba.refereesNBA officials — the three-person crew of referees who work each game.
GET/api/v1/nba/refereesList referees for NBA
Parameters
activequerybooleanoptionalFilter by active status (defaults to true to show only currently-active rows; pass active=false to include inactive).
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/referees?limit=3'Responses
200referees rows matching the declared filter set, wrapped in { referees, 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/jsonResponse Schema(13 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
nba_referee_id | integer | — | — e.g. 202027 |
active | boolean | — | — e.g. true |
birth_city | stringnullable | — | — e.g. — (all-null in sample) |
birth_country | stringnullable | — | — e.g. — (all-null in sample) |
birth_date | datenullable | — | — e.g. — (all-null in sample) |
birth_state | stringnullable | — | — e.g. — (all-null in sample) |
college | stringnullable | — | — e.g. — (all-null in sample) |
experience | integernullable | — | — e.g. — (all-null in sample) |
first_name | string | — | — e.g. Biniam |
full_name | string | — | — e.g. Biniam Maru |
jersey_number | stringnullable | — | — e.g. 94 |
last_name | string | — | — e.g. Scott |
GET/api/v1/nba/referees/{id}Get a single referee by id
Parameters
idpathbigintrequiredPrimary key (id) of the referee 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/referees/{pk_value}'Responses
200Single referee row.application/jsonshow example ▸
404Row not found.
Response Schema(13 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
nba_referee_id | integer | — | — e.g. 202027 |
active | boolean | — | — e.g. true |
birth_city | stringnullable | — | — e.g. — (all-null in sample) |
birth_country | stringnullable | — | — e.g. — (all-null in sample) |
birth_date | datenullable | — | — e.g. — (all-null in sample) |
birth_state | stringnullable | — | — e.g. — (all-null in sample) |
college | stringnullable | — | — e.g. — (all-null in sample) |
experience | integernullable | — | — e.g. — (all-null in sample) |
first_name | string | — | — e.g. Biniam |
full_name | string | — | — e.g. Biniam Maru |
jersey_number | stringnullable | — | — e.g. 94 |
last_name | string | — | — e.g. Scott |
operator_team_lookups
nba.operator_team_lookupsHow each sportsbook and fantasy operator names every NBA team — the mapping from each operator's team code to the unified franchise record.
GET/api/v1/nba/operator_team_lookupsList operator_team_lookups for NBA
Requires one of:
operator_id — requests satisfying none of these return 400.Parameters
operator_idquerybigintoptionalFilter by operator.
team_idquerybigintoptionalFilter by team.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/operator_team_lookups?operator_id=1'Responses
200operator_team_lookups rows matching the declared filter set, wrapped in { operator_team_lookups, 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/jsonResponse Schema(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Reference to main.operator entity e.g. 1 | |
operator_team_id | string | — | External team ID from operator e.g. 2003 |
team_id | bigint | Internal nba.teams.id reference e.g. 11 | |
abbreviation | stringnullable | — | Team abbreviation for reconciliation e.g. ATL |
team_name | stringnullable | — | Team name for reconciliation e.g. Atlanta Hawks |
GET/api/v1/nba/operator_team_lookups/{id}Get a single operator_team_lookup by id
Parameters
idpathbigintrequiredPrimary key (id) of the operator_team_lookup 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/operator_team_lookups/{pk_value}'Responses
200Single operator_team_lookup row.application/jsonshow example ▸
404Row not found.
Response Schema(6 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Reference to main.operator entity e.g. 1 | |
operator_team_id | string | — | External team ID from operator e.g. 2003 |
team_id | bigint | Internal nba.teams.id reference e.g. 11 | |
abbreviation | stringnullable | — | Team abbreviation for reconciliation e.g. ATL |
team_name | stringnullable | — | Team name for reconciliation e.g. Atlanta Hawks |
playoffs
nba.playoffsThe NBA postseason bracket — the play-in tournament, the four conference series rounds, and the NBA Finals, tracked as best-of-seven matchups with seeds, wins, and outcomes.
GET/api/v1/nba/playoffsList playoffs for NBA
Parameters
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/playoffs?limit=3'Responses
200playoffs rows matching the declared filter set, wrapped in { playoffs, 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/jsonResponse Schema(12 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
away_team_id | bigint | — e.g. 13 | |
home_team_id | bigint | — e.g. 1 | |
season_id | bigint | — e.g. 2020 | |
series_id | bigint | — | — e.g. 202001 |
away_team_wins | integer | — | — e.g. 0 |
games_played | integer | — | — e.g. 1 |
home_team_wins | integer | — | — e.g. 4 |
max_games | integer | — | — e.g. 7 |
series_name | string | — | — Values:East First RoundWest First RoundEast Play-InWest Play-InEast Conference Semifin…West Conference Semifin…West Conference FinalsEast Conference FinalsNBA Finals |
series_text | string | — | — e.g. MIA won 1-0 |
status | string | — | — e.g. Completed |
GET/api/v1/nba/playoffs/{id}Get a single playoff by id
Parameters
idpathbigintrequiredPrimary key (id) of the playoff 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/playoffs/{pk_value}'Responses
200Single playoff row.application/jsonshow example ▸
404Row not found.
Response Schema(12 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
away_team_id | bigint | — e.g. 13 | |
home_team_id | bigint | — e.g. 1 | |
season_id | bigint | — e.g. 2020 | |
series_id | bigint | — | — e.g. 202001 |
away_team_wins | integer | — | — e.g. 0 |
games_played | integer | — | — e.g. 1 |
home_team_wins | integer | — | — e.g. 4 |
max_games | integer | — | — e.g. 7 |
series_name | string | — | — Values:East First RoundWest First RoundEast Play-InWest Play-InEast Conference Semifin…West Conference Semifin…West Conference FinalsEast Conference FinalsNBA Finals |
series_text | string | — | — e.g. MIA won 1-0 |
status | string | — | — e.g. Completed |
game_broadcasters
nba.game_broadcastersWhich networks broadcast each NBA game — the national TV partner, home and away regional carriers, radio calls, and streaming providers.
GET/api/v1/nba/game_broadcastersList game_broadcasters for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
broadcaster_idquerybigintoptionalFilter by broadcaster.
broadcaster_typequerystringoptionalFilter by broadcaster role. Values: awayTv, homeTv, nationalTv.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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_broadcasters?game_id=1'Responses
200game_broadcasters rows matching the declared filter set, wrapped in { game_broadcasters, 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/jsonResponse Schema(4 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
broadcaster_id | bigint | — e.g. 10 | |
game_id | bigint | — e.g. 15975 | |
broadcaster_type | string | — | — Values:awayTvhomeTvnationalTv |
GET/api/v1/nba/game_broadcasters/{id}Get a single game_broadcaster by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_broadcaster 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_broadcasters/{pk_value}'Responses
200Single game_broadcaster row.application/jsonshow example ▸
404Row not found.
Response Schema(4 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
broadcaster_id | bigint | — e.g. 10 | |
game_id | bigint | — e.g. 15975 | |
broadcaster_type | string | — | — Values:awayTvhomeTvnationalTv |
game_referees
nba.game_refereesThe officiating crew assigned to each NBA game — the three referees who worked the matchup.
GET/api/v1/nba/game_refereesList game_referees for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
referee_idquerybigintoptionalFilter by referee.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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_referees?game_id=1'Responses
200game_referees rows matching the declared filter set, wrapped in { game_referees, 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/jsonResponse Schema(4 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 4727 | |
referee_id | bigint | — e.g. 58 | |
position | stringnullable | — | — Values:RefereeCrew ChiefUmpireALTERNATE |
GET/api/v1/nba/game_referees/{id}Get a single game_referee by id
Parameters
idpathbigintrequiredPrimary key (id) of the game_referee 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_referees/{pk_value}'Responses
200Single game_referee row.application/jsonshow example ▸
404Row not found.
Response Schema(4 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 4727 | |
referee_id | bigint | — e.g. 58 | |
position | stringnullable | — | — Values:RefereeCrew ChiefUmpireALTERNATE |
operator_player_lookups
nba.operator_player_lookupsHow each sportsbook and fantasy operator names every NBA player — the mapping from each operator's player identifier to a unified player record.
GET/api/v1/nba/operator_player_lookupsList operator_player_lookups for NBA
Requires one of:
operator_id — requests satisfying none of these return 400.Parameters
operator_idquerybigintoptionalFilter by operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators.
player_idquerybigintoptionalFilter to a single player.
limitqueryintegeroptionaldefault 100Page size. Defaults to 100; max 5000.
from_idquerybigintoptionalReturn 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/operator_player_lookups?operator_id=1'Responses
200operator_player_lookups rows matching the declared filter set, wrapped in { operator_player_lookups, 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/jsonResponse Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators. e.g. 83 | |
operator_player_id | string | — | External player ID from operator e.g. 76001 |
player_id | bigintnullable | Internal nba.players.id reference e.g. 521 | |
decided_at | timestamptznullable | — | When the pin or block was decided. e.g. — (all-null in sample) |
decided_reason | stringnullable | — | Evidence behind a pinned or blocked decision. e.g. — (all-null in sample) |
decision | stringnullable | — | How this mapping was decided: 'derived' (finder answer, overwritable), 'pinned' (decided on evidence, trigger-protected), 'blocked' (no player we hold is this id; player_id NULL, never retried). DB default 'derived'; a BEFORE UPDATE trigger preserves non-derived rows. e.g. derived |
player_name | stringnullable | — | Player name for reconciliation e.g. George Johnson |
position | stringnullable | — | Position for reconciliation Values:GFCG-FF-CUnknown |
GET/api/v1/nba/operator_player_lookups/{id}Get a single operator_player_lookup by id
Parameters
idpathbigintrequiredPrimary key (id) of the operator_player_lookup 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/operator_player_lookups/{pk_value}'Responses
200Single operator_player_lookup row.application/jsonshow example ▸
404Row not found.
Response Schema(9 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
operator_id | bigint | Operator id: 1 DraftKings, 2 FanDuel, 3 Yahoo; every id is listed at /api/v1/reference/operators. e.g. 83 | |
operator_player_id | string | — | External player ID from operator e.g. 76001 |
player_id | bigintnullable | Internal nba.players.id reference e.g. 521 | |
decided_at | timestamptznullable | — | When the pin or block was decided. e.g. — (all-null in sample) |
decided_reason | stringnullable | — | Evidence behind a pinned or blocked decision. e.g. — (all-null in sample) |
decision | stringnullable | — | How this mapping was decided: 'derived' (finder answer, overwritable), 'pinned' (decided on evidence, trigger-protected), 'blocked' (no player we hold is this id; player_id NULL, never retried). DB default 'derived'; a BEFORE UPDATE trigger preserves non-derived rows. e.g. derived |
player_name | stringnullable | — | Player name for reconciliation e.g. George Johnson |
position | stringnullable | — | Position for reconciliation Values:GFCG-FF-CUnknown |
player_news
nba.player_newsNews about NBA players — trades, injuries, lineup decisions, suspensions, and general beat-reporter updates.
GET/api/v1/nba/player_newsList player_news for NBA
Requires one of:
player_id or team_id — requests satisfying none of these return 400.Parameters
player_idquerybigintoptionalFilter to news about a single player.
team_idquerybigintoptionalFilter by team — a team-level news feed, newest first.
categoryquerystringoptionalFilter by news category (injury, transaction, lineup, general). Values: general, injury, lineup, transaction.
status_enumquerystringoptionalFilter by player status designation. Values: RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, OUT_SEASON, TRADED, RELEASED, SIGNED, ROUTINE, UNSIGNED.
urgencyquerystringoptionalFilter by news urgency. Values: BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE.
news_timequerytimestamptzoptionalFilter by publication time (ISO 8601). Use news_time__gte to poll for items since your last check. Range syntax: news_time__gte=, news_time__lte=, news_time__between=.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/player_news?player_id=1'Responses
200player_news rows matching the declared filter set, wrapped in { player_news, 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/jsonResponse Schema(18 fields)show schema ▸
25 total fields (1 nested object/array groups)
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigintnullable | Associated game ID when this news item relates to a specific game. e.g. — (all-null in sample) | |
opponent_team_id | bigintnullable | Opponent team ID when this news item relates to an upcoming or active game matchup. e.g. — (all-null in sample) | |
player_id | bigintnullable | Player ID associated with the news report. e.g. 165 | |
team_id | bigintnullable | Team ID of the player at the time of publication. e.g. 16 | |
ai_processed | boolean | — | Whether this story was generated or enriched via LLM summarization. e.g. false |
analysis | stringnullable | — | Fantasy and tactical analysis of the news. e.g. Barton had to be helped back to the locker room during the … |
author | stringnullable | — | Reporter or author of the article. e.g. — (all-null in sample) |
category | stringnullable | — | injury, transaction, lineup, general e.g. — (all-null in sample) |
content | stringnullable | — | Full text content of the news report. e.g. — (all-null in sample) |
description | stringnullable | — | Brief synopsis or summary of the news event. e.g. Murray was assigned Sunday to the D-League's Austin Spurs. |
first_reported_at | timestamptznullable | — | Timestamp when this story was first reported before multi-source compaction. e.g. — (all-null in sample) |
news_time | timestamptz | — | Publication timestamp of the news story. e.g. 2016-11-27T19:29:13.000Z |
priority | integer | — | Display priority score (1-10). e.g. 3 |
situational_impact | jsonbnullable | — | Structured situational impact assessment and fantasy implications for the player. e.g. — (all-null in sample) |
↳type situational_impact.type | stringnullable | — | Impact direction: positive, negative, or neutral. |
↳impact_enum situational_impact.impact_enum | stringnullable | — | Standardized impact state (ACTIVE, CLEARED, QUESTIONABLE, etc.). |
↳reason situational_impact.reason | stringnullable | — | Narrative explaining the fantasy and playing-time impact. |
↳ripple_effect situational_impact.ripple_effect | stringnullable | — | Downstream tactical or fantasy consequences. |
↳affected_players situational_impact.affected_players | listnullable | — | Teammates whose opportunity or role is impacted. |
↳affectedPlayers situational_impact.affectedPlayers | listnullable | — | Teammates whose opportunity or role is impacted (camelCase). |
↳affected_player_ids situational_impact.affected_player_ids | listnullable | — | IDs of impacted teammates. |
status_enum | stringnullable | — | Standardized player status designation (RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, TRADED, RELEASED, SIGNED, ROUTINE). e.g. — (all-null in sample) |
title | string | — | Headline of the news report. e.g. Assigned to D-League |
urgency | stringnullable | — | Urgency level of the news event (BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE). e.g. — (all-null in sample) |
GET/api/v1/nba/player_news/{id}Get a single player_new by id
Parameters
idpathbigintrequiredPrimary key (id) of the player_new 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/player_news/{pk_value}'Responses
200Single player_new row.application/jsonshow example ▸
404Row not found.
Response Schema(18 fields)show schema ▸
25 total fields (1 nested object/array groups)
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigintnullable | Associated game ID when this news item relates to a specific game. e.g. — (all-null in sample) | |
opponent_team_id | bigintnullable | Opponent team ID when this news item relates to an upcoming or active game matchup. e.g. — (all-null in sample) | |
player_id | bigintnullable | Player ID associated with the news report. e.g. 165 | |
team_id | bigintnullable | Team ID of the player at the time of publication. e.g. 16 | |
ai_processed | boolean | — | Whether this story was generated or enriched via LLM summarization. e.g. false |
analysis | stringnullable | — | Fantasy and tactical analysis of the news. e.g. Barton had to be helped back to the locker room during the … |
author | stringnullable | — | Reporter or author of the article. e.g. — (all-null in sample) |
category | stringnullable | — | injury, transaction, lineup, general e.g. — (all-null in sample) |
content | stringnullable | — | Full text content of the news report. e.g. — (all-null in sample) |
description | stringnullable | — | Brief synopsis or summary of the news event. e.g. Murray was assigned Sunday to the D-League's Austin Spurs. |
first_reported_at | timestamptznullable | — | Timestamp when this story was first reported before multi-source compaction. e.g. — (all-null in sample) |
news_time | timestamptz | — | Publication timestamp of the news story. e.g. 2016-11-27T19:29:13.000Z |
priority | integer | — | Display priority score (1-10). e.g. 3 |
situational_impact | jsonbnullable | — | Structured situational impact assessment and fantasy implications for the player. e.g. — (all-null in sample) |
↳type situational_impact.type | stringnullable | — | Impact direction: positive, negative, or neutral. |
↳impact_enum situational_impact.impact_enum | stringnullable | — | Standardized impact state (ACTIVE, CLEARED, QUESTIONABLE, etc.). |
↳reason situational_impact.reason | stringnullable | — | Narrative explaining the fantasy and playing-time impact. |
↳ripple_effect situational_impact.ripple_effect | stringnullable | — | Downstream tactical or fantasy consequences. |
↳affected_players situational_impact.affected_players | listnullable | — | Teammates whose opportunity or role is impacted. |
↳affectedPlayers situational_impact.affectedPlayers | listnullable | — | Teammates whose opportunity or role is impacted (camelCase). |
↳affected_player_ids situational_impact.affected_player_ids | listnullable | — | IDs of impacted teammates. |
status_enum | stringnullable | — | Standardized player status designation (RULED_OUT, DOUBTFUL, QUESTIONABLE, PROBABLE, CLEARED, MINUTES_LIMIT, MINUTES_LIFTED, STARTING, BENCHED, INACTIVE, ACTIVE, IR_PLACED, IR_ACTIVATED, TRADED, RELEASED, SIGNED, ROUTINE). e.g. — (all-null in sample) |
title | string | — | Headline of the news report. e.g. Assigned to D-League |
urgency | stringnullable | — | Urgency level of the news event (BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE). e.g. — (all-null in sample) |
team_game_contexts
nba.team_game_contextsSituational context for each NBA team in each game — how much the game matters (playoff push, tanking, contender mode, In-Season Tournament stakes), what phase of the season it's in, and how far along the schedule the team is.
GET/api/v1/nba/team_game_contextsList team_game_contexts for NBA
Requires one of:
game_id — requests satisfying none of these return 400.Parameters
game_idquerybigintoptionalFilter to a single game.
team_idquerybigintoptionalFilter by team.
season_idquerybigintoptionalFilter by season.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/team_game_contexts?game_id=1'Responses
200team_game_contexts rows matching the declared filter set, wrapped in { team_game_contexts, 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/jsonResponse Schema(20 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 2374 | |
opponent_team_id | bigint | — e.g. 9 | |
season_id | bigint | — e.g. 2024 | |
team_id | bigint | — e.g. 9 | |
conference_rank | integer | — | — e.g. 8 |
game_type | string | — | regular, playoff, play_in, ist_group, ist_knockout, preseason, allstar Values:regularplayoffist_group |
games_remaining | integer | — | — e.g. 0 |
intensity | integer | — | 1-10 motivation intensity scale e.g. 5 |
is_back_to_back | boolean | — | — Values:falsetrue |
is_clinch | boolean | — | — Values:falsetrue |
is_elimination | boolean | — | — Values:falsetrue |
ist_group_rank | integernullable | — | — e.g. — (all-null in sample) |
ist_group_record | stringnullable | — | e.g. 2-1 e.g. — (all-null in sample) |
motivation | string | — | contender, playoff_lock, seeding_battle, playoff_push, play_in, fringe, tanking, eliminated, early_season, playoff_comfortable, playoff_competitive, playoff_desperate, playoff_elimination, playoff_clinch, ist_contending, ist_eliminated, ist_knockout
Values:play_infringeearly_seasonseeding_battlecontendertankingplayoff_lockplayoff_competitiveplayoff_comfortableplayoff_desperateplayoff_clinchplayoff_eliminationist_contending |
rest_days | integer | — | — e.g. 1 |
season_pct | decimal | — | 0.0-1.0 how far through regular season e.g. 1.0000 |
season_phase | string | — | early, mid, late, final_push, postseason Values:midlateearlyfinal_pushpostseason |
team_series_wins | integer | — | — e.g. 0 |
win_pct | decimal | — | — e.g. 0.5000 |
GET/api/v1/nba/team_game_contexts/{id}Get a single team_game_context by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_game_context 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/team_game_contexts/{pk_value}'Responses
200Single team_game_context row.application/jsonshow example ▸
404Row not found.
Response Schema(20 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigint | — e.g. 2374 | |
opponent_team_id | bigint | — e.g. 9 | |
season_id | bigint | — e.g. 2024 | |
team_id | bigint | — e.g. 9 | |
conference_rank | integer | — | — e.g. 8 |
game_type | string | — | regular, playoff, play_in, ist_group, ist_knockout, preseason, allstar Values:regularplayoffist_group |
games_remaining | integer | — | — e.g. 0 |
intensity | integer | — | 1-10 motivation intensity scale e.g. 5 |
is_back_to_back | boolean | — | — Values:falsetrue |
is_clinch | boolean | — | — Values:falsetrue |
is_elimination | boolean | — | — Values:falsetrue |
ist_group_rank | integernullable | — | — e.g. — (all-null in sample) |
ist_group_record | stringnullable | — | e.g. 2-1 e.g. — (all-null in sample) |
motivation | string | — | contender, playoff_lock, seeding_battle, playoff_push, play_in, fringe, tanking, eliminated, early_season, playoff_comfortable, playoff_competitive, playoff_desperate, playoff_elimination, playoff_clinch, ist_contending, ist_eliminated, ist_knockout
Values:play_infringeearly_seasonseeding_battlecontendertankingplayoff_lockplayoff_competitiveplayoff_comfortableplayoff_desperateplayoff_clinchplayoff_eliminationist_contending |
rest_days | integer | — | — e.g. 1 |
season_pct | decimal | — | 0.0-1.0 how far through regular season e.g. 1.0000 |
season_phase | string | — | early, mid, late, final_push, postseason Values:midlateearlyfinal_pushpostseason |
team_series_wins | integer | — | — e.g. 0 |
win_pct | decimal | — | — e.g. 0.5000 |
team_news
nba.team_newsNews and updates about NBA teams — game previews, coaching changes, front-office moves, and beat reports.
⚠️ This endpoint is documented but not yet live. Calls return
503 until data is wired in.GET/api/v1/nba/team_newsList team_news for NBA
Requires one of:
team_id — requests satisfying none of these return 400.Parameters
team_idquerybigintoptionalFilter by team.
categoryquerystringoptionalFilter by category (game_preview, coaching, transaction, general, draft, depth_chart). Values: game_preview, coaching, transaction, general, draft, depth_chart.
urgencyquerystringoptionalFilter by news urgency. Values: BREAKING_GAME_TIME, HIGH, MEDIUM, ROUTINE.
news_timequerytimestamptzoptionalFilter by publication time (ISO 8601). Use news_time__gte to poll for items since your last check. Range syntax: news_time__gte=, news_time__lte=, news_time__between=.
limitqueryintegeroptionaldefault 50Page size. Defaults to 50; max 5000.
from_idquerybigintoptionalReturn 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/team_news?team_id=1'Responses
200team_news rows matching the declared filter set, wrapped in { team_news, 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/json503Coming soon — handler returns 503 until data is wired in.
Response Schema(10 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigintnullable | Associated game ID when news relates to a specific game. e.g. — (all-null in sample) | |
opponent_team_id | bigintnullable | Opponent team ID when news relates to an upcoming or completed game matchup. e.g. — (all-null in sample) | |
team_id | bigint | Team ID that this news event pertains to. e.g. 7 | |
ai_processed | booleannullable | — | Whether this story was generated or enriched via LLM summarization. e.g. true |
category | stringnullable | — | game_preview, coaching, transaction, general e.g. transaction |
news_time | timestamptz | — | Publication timestamp of the team story. e.g. 2026-09-02T20:04:17.734Z |
summary | string | — | Concise journalistic summary of the team news event. e.g. The Cavaliers officially signed 2022 draft pick Khalifa Dio… |
title | string | — | Headline of the team news story. e.g. Cavaliers sign Khalifa Diop to four-year contract after two… |
urgency | stringnullable | — | ROUTINE, MEDIUM, HIGH, BREAKING_GAME_TIME e.g. ROUTINE |
GET/api/v1/nba/team_news/{id}Get a single team_new by id
Parameters
idpathbigintrequiredPrimary key (id) of the team_new 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/team_news/{pk_value}'Responses
200Single team_new row.application/jsonshow example ▸
404Row not found.
503Coming soon — handler returns 503 until data is wired in.
Response Schema(10 fields)show schema ▸
| Field | Type | References | Description |
|---|---|---|---|
idkey | bigint | — | Primary Key |
game_id | bigintnullable | Associated game ID when news relates to a specific game. e.g. — (all-null in sample) | |
opponent_team_id | bigintnullable | Opponent team ID when news relates to an upcoming or completed game matchup. e.g. — (all-null in sample) | |
team_id | bigint | Team ID that this news event pertains to. e.g. 7 | |
ai_processed | booleannullable | — | Whether this story was generated or enriched via LLM summarization. e.g. true |
category | stringnullable | — | game_preview, coaching, transaction, general e.g. transaction |
news_time | timestamptz | — | Publication timestamp of the team story. e.g. 2026-09-02T20:04:17.734Z |
summary | string | — | Concise journalistic summary of the team news event. e.g. The Cavaliers officially signed 2022 draft pick Khalifa Dio… |
title | string | — | Headline of the team news story. e.g. Cavaliers sign Khalifa Diop to four-year contract after two… |
urgency | stringnullable | — | ROUTINE, MEDIUM, HIGH, BREAKING_GAME_TIME e.g. ROUTINE |