---
title: "NBA players (3,252 seeded)"
method: GET
path: "/v1/nba/players"
tags: ["NBA"]
---

# NBA players (3,252 seeded)

`GET /v1/nba/players`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/nba/players`
- Auth: API key in header `X-PlayCaller-Key`

3,252 NBA players from player_identities (same identity-resolution pipeline as MLB). Searchable by name, position, or team. No jersey number or headshot URL is currently returned (despite earlier docs claiming otherwise — corrected 2026-06-24 against a live response).

**Tier access:** Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha

## Query parameters

- `search` string
- `position` 'PG' | 'SG' | 'SF' | 'PF' | 'C'
- `team` string
- `limit` integer
- `offset` integer

## Response `200`

NBA players

- object
  - `success` boolean
  - `endpoint` string
  - `total` integer
  - `count` integer
  - `offset` integer
  - `limit` integer
  - `data` object[]
    - `id` string
    - `full_name` string
    - `first_name` string
    - `last_name` string
    - `position` string, nullable
    - `team` string
    - `status` string
  - `meta` ResponseMeta
    - `sport` string
    - `league` string: Present on multi-sport (ESPN-backed) endpoints; mirrors sport unless a sport has sub-leagues (e.g. soccer: epl/mls).
    - `tier` string
    - `calls_remaining_this_month` integer
    - `documentation_url` string, uri

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)