List seasons

GET/tv/seasons/

read Read: looks, changes nothing. Scopes

Seasons of the TV shows you may manage, by number. Not paged.

Query parameters

seriesstring (uuid)
Only this TV show's seasons.

Response

200 OK

idstring (uuid)requiredread-only
seriesstring (uuid)required
numberintegerrequired
0 for specials.
namestring
labelstringrequiredread-only
plotstring
poster_urlstring (uri)
air_datestring (date)can be null
episode_countintegerrequiredread-only
created_atstring (date-time)requiredread-only
updated_atstring (date-time)requiredread-only

Errors

401 No credential, or one that is wrong, expired or revoked.
403 The account, or the key's or app's scopes, may not do this.
429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means

cURL

curl 'https://panel.example.com/tv/seasons/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY"

Python

import os
import requests

response = requests.get(
    "https://panel.example.com/tv/seasons/",
    headers={"Authorization": f"Bearer {os.environ['MINIMUS_API_KEY']}"},
)
response.raise_for_status()
print(response.json())

JavaScript

const response = await fetch('https://panel.example.com/tv/seasons/', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.MINIMUS_API_KEY}` },
});
if (!response.ok) throw new Error(`${response.status}`);
console.log(await response.json());

Response 200

[
  {
    "id": "3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b",
    "series": "3f2b8c1e-5a4d-4e6f-9b7a-1c2d3e4f5a6b",
    "number": 1,
    "name": "Channel A",
    "label": "string",
    "plot": "string",
    "poster_url": "https://example.com/",
    "air_date": "2026-11-13",
    "episode_count": 0,
    "created_at": "2026-11-13T12:00:00Z",
    "updated_at": "2026-11-13T12:00:00Z"
  }
]

List seasons

Query parameters#

Response#

200 OK

Errors#

Query parameters

Response

Errors