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

Usage

GET/v1/usage

Your plan, calls today and this month, limits and the days your plan reaches. Not counted.

Free key and up

What comes back

data is one of these:

Field	Type	About
`key`	string
`plan`	string
`calls_today`	integer
`calls_this_month`	integer
`limits`	object
`limits.per_minute`	integer or null
`limits.per_day`	integer or null
`limits.per_month`	integer or null
`remaining`	integer or null
`resets_at`	string or null
`window`	object
`window.from`	date or null
`window.to`	date or null

Errors

400422401403429 What each one means

Try it

Your key

Your key stays in this browser.

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

import requests

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

const r = await fetch("https://api.basketballapi.net/v1/usage", {
  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/usage", false, $ctx), true);

200Example answer, in shape

{
  "data": {
    "key": "bba_live_7f3c",
    "plan": "Free key",
    "calls_today": 37,
    "calls_this_month": 412,
    "limits": {
      "per_minute": 12,
      "per_day": 12,
      "per_month": 12
    },
    "remaining": 63,
    "resets_at": "2026-10-03T00:00:00Z",
    "window": {
      "from": "2026-10-01",
      "to": "2026-10-01"
    }
  },
  "meta": { "plan": "Free key" }
}