NBA

List games for NBA

get/api/v1/nba/games

Request

  • Base URL: https://api.stat-api.com
  • URL: https://api.stat-api.com/api/v1/nba/games
  • Auth: HTTP bearer

Query parameters

season_idinteger

Filter to a season. Defaults to the current season.

home_team_idinteger

Filter by home team.

away_team_idinteger

Filter by away team.

status'Cancelled' | 'Final' | 'Scheduled'

Filter by game status.

dayinteger

Filter 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.

day__gteinteger

Filter 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. (greater-than-or-equal)

day__lteinteger

Filter 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. (less-than-or-equal)

day__betweeninteger

Filter 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. (comma-separated min,max range (inclusive))

season_type'all_star' | 'in_season_tournament' | 'play_in' | 'postseason' | 'preseason' | 'regular_season'

Filter by season phase (regular_season, preseason, postseason, play_in, in_season_tournament, all_star).

limitinteger

Page size; defaults to (and is capped at) 5000.

from_idinteger

Return rows with id strictly greater than this value, in ascending id order. To walk every row, start at 0 and then pass the previous response's next_from_id. Without it, the first page uses the table's default sort and returns no cursor.

format'json' | 'csv'

Response format: json (default) or csv — the same rows as CSV with raw values, a blank cell for null, and X-Next-From-Id when another page exists. With format=csv only, the API key may be passed as the key query param (for Google Sheets IMPORTDATA); use a separate, revocable key for that.

Response

games rows matching the declared filter set.

has_moreboolean required

True when a full page came back, so more rows can exist.

limitinteger required

Page size used for this response.

next_from_idinteger nullable required

Pass this as from_id on the next request to page forward. null on the terminal page, and on a first page requested without from_id (that page uses the default sort): to walk every row, start with from_id=0.

Changes

No recorded changes to this operation across all 2 revisions of this API.