Get the guide settings

GET/epg/settings/

read Read: looks, changes nothing. Scopes

The Minimus EPG connection and the import schedule. The key is never returned: has_key says whether one is saved. Panel operators only.

Response

200 OK

farm_urlstring (uri)
Where the guide is downloaded from. Leave the default unless Minimus support gives you another address.
has_keybooleanrequiredread-only
refresh_hoursinteger
How often the panel checks for a newer guide. Unchanged files are not downloaded again.
keep_daysinteger
Programmes further ahead are not imported, and the past is dropped after a day. More days means a bigger database.
auto_assignboolean
When a stream is created or imported without an EPG channel, give it the channel its name clearly matches.
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/epg/settings/' \
  -H "Authorization: Bearer $MINIMUS_API_KEY"

Python

import os
import requests

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

{
  "farm_url": "https://example.com/",
  "has_key": true,
  "refresh_hours": 1,
  "keep_days": 1,
  "auto_assign": true,
  "updated_at": "2026-11-13T12:00:00Z"
}

Get the guide settings

Response#

200 OK

Errors#

Response

Errors