NewPlay by play and shot charts Sign in Get a free keyFree key

One player

GET/v1/players/{id}

One player, with the teams played for.

Live and up

Parameters

Name	In	Type	About
`id` required	path	id	The player, by its id (pl_…). e.g. `pl_4S9RZVWN`

What comes back

data is one of these:

Field	Type	About
`id`	id	A player id.
`name`	string
`birth_date`	date or null
`height_cm`	integer or null
`weight_kg`	integer or null
`country`	string or null	Nationality as a three-letter IOC code, such as LTU or USA.
`position`	string or null	PG, SG, SF, PF, C, G or F, or two joined (G-F), as the league lists it.
`games`	integer
`teams`	array of object
`awards`	array of object	Honours the player has received, newest first; empty where none are known.

Errors

400422401403429404 What each one means

Try it

Your key idrequired

Your key stays in this browser.

curl "https://api.basketballapi.net/v1/players/pl_4S9RZVWN" \
  -H "Authorization: Bearer bba_live_your_key"

import requests

r = requests.get("https://api.basketballapi.net/v1/players/pl_4S9RZVWN",
                 headers={"Authorization": "Bearer bba_live_your_key"})
print(r.json()["data"])

const r = await fetch("https://api.basketballapi.net/v1/players/pl_4S9RZVWN", {
  headers: { Authorization: "Bearer bba_live_your_key" }
});
const { data } = await r.json();

$ctx = stream_context_create(['http' => [
    'header' => "Authorization: Bearer bba_live_your_key",
]]);
$r = json_decode(file_get_contents("https://api.basketballapi.net/v1/players/pl_4S9RZVWN", false, $ctx), true);

200Example answer, in shape

{
  "data": {
    "id": "pl_EDA561C6",
    "name": "Example name",
    "birth_date": "2026-10-01",
    "height_cm": 12,
    "weight_kg": 12,
    "country": "ES",
    "position": "text",
    "games": 34,
    "teams": [
      {
        "id": "tm_8EB4D858",
        "name": "Example name",
        "games": 34,
        "first_date": "2026-10-01",
        "last_date": "2026-10-01"
      }
    ],
    "awards": [
      { "name": "Example name", "year": 12 }
    ]
  },
  "meta": { "plan": "Free key" }
}