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

Seasons

GET/v1/seasons

Seasons of a competition, newest first.

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

Parameters

Name	In	Type	About
`competition`	query	id	Only this competition, by its id (cp_…). e.g. `cp_11A6HQXJ`
`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 season id.
`name`	string
`start_year`	integer
`competition`	object
`competition.id`	id	A competition id.
`competition.name`	string
`games`	integer
`first_date`	date or null
`last_date`	date or null

Errors

400422401403429 What each one means

Try it

Your key competition page per_page

Your key stays in this browser.

curl "https://api.basketballapi.net/v1/seasons?competition=cp_11A6HQXJ" \
  -H "Authorization: Bearer bba_live_your_key"

import requests

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

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

200Example answer, in shape

{
  "data": [
    {
      "id": "ss_EBC81C6D",
      "name": "Example name",
      "start_year": 2025,
      "competition": {
        "id": "cp_929127FC",
        "name": "Example name"
      },
      "games": 34,
      "first_date": "2026-10-01",
      "last_date": "2026-10-01"
    }
  ],
  "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"
  }
}