nba

NBA games list (legacy v1 shape, 1946-2025)

Each game carries match_id, the canonical match UUID usable with every /v1 UUID-keyed endpoint (availability, lineups, odds). It is null for games our canonical coverage cannot reach: anything before 2019-10-22, plus preseason and All-Star games. This response shape is stable through 2027-03-31; migrate list reads to /v1/matches?league=nba.

get/v1/nba/games

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/nba/games
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

seasoninteger

Season LABEL, not a calendar year: the year a season STARTS in. 2025 means the 2025-26 campaign for leagues that cross the new year (EPL, NBA, NHL) and the 2025 season for those that do not (MLB, MLS, WNBA). Filtering resolves each league's own start month, so a season never spans two calendar years' worth of rows.

teamstring

Team abbreviation (e.g. LAL)

type'REG' | 'POST' | 'PRE' | 'ALLSTAR' | 'Regular Season' | 'Playoffs' | 'Pre Season' | 'All Star'
limitinteger
offsetinteger

Response

ok

Example response

{
  "meta": {
    "rebound_split": {
      "data_type": "stored_team_totals"
    }
  }
}

Changes

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