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

Competitions

GET/v1/competitions

Every competition held, with its seasons and games.

Free key and up A list: pages of 50, see paging

Parameters

Name	In	Type	About
`page`	query	integer	Which page, from 1.
`cursor`	query	string	The next_cursor from the last answer, to carry on.
`per_page`	query	integer	Records an answer, from 1 to 200. 50 if left out.

What comes back

data is a list of these:

Field	Type	About
`id`	id	A competition id.
`name`	string
`slug`	string
`country`	string or null
`gender`	string
`kind`	string
`seasons`	integer
`first_season`	string or null
`last_season`	string or null
`games`	integer

Errors

400422401403429 What each one means

Try it

Your key page per_page

Your key stays in this browser.

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

import requests

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

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

200Example answer, in shape

{
  "data": [
    {
      "id": "cp_929127FC",
      "name": "Example name",
      "slug": "example-league",
      "country": "ES",
      "gender": "men",
      "kind": "league",
      "seasons": 12,
      "first_season": "2000-01",
      "last_season": "2025-26",
      "games": 34
    }
  ],
  "meta": {
    "count": 1,
    "next_cursor": null,
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1,
    "next_page": null,
    "prev_page": null,
    "plan": "Free key"
  }
}