NBA

List players for NBA

get/api/v1/nba/players

Request

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

Query parameters

team_idinteger

Example:12

Filter to players whose current team_id matches. Null team_id rows (free agents, retired) are excluded when this filter is applied.

roster_status'active' | 'injured_reserve' | 'free_agent' | 'retired' | 'inactive'

Example:active

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

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

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

Example response

{
  "players": [
    {
      "birth_city": "Sombor",
      "birth_country": "Serbia",
      "birth_date": "1995-02-19",
      "display_fi_last": "N. Jokić",
      "display_last_comma_first": "Jokić, Nikola",
      "dleague_flag": "00",
      "draft_number": "41",
      "draft_round": "2",
      "draft_year": "2014",
      "experience": 10,
      "first_name": "Nikola",
      "from_year": "2015",
      "full_name": "Nikola Jokić",
      "full_position_list": "Guard-Forward",
      "games_played_flag": "Y",
      "height": 83,
      "injury_since": "2026-04-12T18:30:00Z",
      "injury_status": "OUT",
      "jersey": "15",
      "last_affiliation": "Mega Basket / Serbia",
      "last_name": "Jokić",
      "league_player_id": 203999,
      "league_slug": "nikola-jokic",
      "nba_flag": "Y",
      "playercode": "jokic_nikola",
      "position_category": "Center",
      "primary_position": "C",
      "roster_status": "active",
      "school": "Mega Basket",
      "team_abbreviation": "DEN",
      "team_city": "Denver",
      "team_code": "nuggets",
      "team_id": 12,
      "team_name": "Nuggets",
      "to_year": "2025",
      "weight": 284
    }
  ]
}

Changes

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