Get a season

GET/tv/seasons/{id}/

read Read: looks, changes nothing. Scopes

One season.

Path parameters

idstring (uuid)required
The season's id.

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.
404 Nothing with this id, or nothing the account can see.
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/1/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY"

Python

import os
import requests

response = requests.get(
    "https://panel.example.com/tv/seasons/1/",
    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/1/', {
  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"
}

Get a season

Path parameters#

Response#

200 OK

Errors#

Path parameters

Response

Errors