Xtream-Masters Admin API

Full administrative control over your Xtream-Masters panel. Manage lines, devices, resellers, streams, servers, security, and system configuration through a comprehensive REST-style API.

Admin API - Full Access This API provides unrestricted administrative access. Keep your API key secure and never expose it in client-side code or public repositories.

Authentication

All API requests require your api_key parameter. Include it as a query parameter or POST field on every request.

Where do I find my API key? Your admin API key is available in the admin panel under Menu > Admin API page. This key grants full administrative privileges.

Base URL

All requests are made to the following base URL format:

http://{server-dns}:{stream-port}/{api-access-code}/admin/index.php

Replace {server-dns}, {stream-port}, and {api-access-code} with your server details.

Quick Start

Get up and running in minutes 1. Obtain your admin API key from the admin panel.
2. Note your server DNS, streaming port, and API access code.
3. Make your first request to user_info to verify connectivity.

Quick Test

curl "http://your-server:port/access-code/admin/index.php?api_key=YOUR_KEY&action=user_info"

Global Parameters

These parameters are available on all or most endpoints.

Parameter	Type	Required	Description
api_key	string	Required	Your unique admin API key for authentication
action	string	Required	The API action to perform
start	int	Optional	Pagination offset for list endpoints (default: 0)
limit	int	Optional	Number of records to return (default: 50)
show_columns	string	Optional	Comma-separated list of column names to include in the response
hide_columns	string	Optional	Comma-separated list of column names to exclude from the response

Warnings

A call that cannot do everything you asked still succeeds, and says what it skipped. Nothing is dropped in silence. Each entry names the parameter, why it was ignored, and — where a panel setting is the cause — the exact path that would make it work.

Response

{
  "status": "STATUS_SUCCESS",
  "ticket_status": "closed",
  "changed": 1,
  "ids": [4],
  "warnings": [
    { "code": "ticket_not_found", "field": "id", "message": "No ticket with id 999999999." }
  ]
}

Failures carry error_code, and where one field is at fault, field and a one-sentence hint. The status string is unchanged, so existing clients keep working.

What’s New

Everything additive. A request that sends none of the new parameters behaves exactly as it always did.

Movies, series and episodes from a script

Add a TV series and its episodes with create_series and create_episode, the same way the Watch Folder does. Send a TMDB id and the title, cover, plot, cast and seasons are filled in; each episode gets its own title, still image, plot and air date. See Adding movies and series from a script.
create_movie with just a TMDB id now fills name, poster, backdrop, plot, cast, genre, runtime, rating and year.
Encode starts by itself. A new movie or episode is encoded right after it is added when Watch Folder › Settings › Auto Encode is on, or when you send encode=1. start_movie, stop_movie, start_episode and stop_episode now work (they answered “not served by this core yet”).
Safe to run again. The same movie source, the same series, or an episode number the series already has is refused with error_code: "duplicate" and the existing id, so a script can re-run without making copies.
The next episode goes where the others are. create_episode without a server uses the servers of the series’ other episodes.
Fixed: episodes added through the API had no plot, image or runtime in the apps; the container was stored as mkv instead of ["mkv"]; a movie added with bouquets was missing from the m3u playlist (it went into a list get.php does not read); an episode added with bouquets was put into the bouquet’s series list by its stream id; and create_series&dry_run=1 created a real series.

New endpoint families

Support tickets — the whole queue: list, read with its conversation, open, reply, close, reopen, edit and delete. The panel has had Tickets for years and no API touched it.
Activation codes on the admin API — all eight actions. They existed on the reseller API only, so an operator could give a reseller code management and have none themselves. An admin sees every code.
ASN blocking — get_blocked_asns, add_blocked_asn, edit_blocked_asn, delete_blocked_asn. Usually the largest security table on an install; page it with limit.
MAG claims — the viewer reports raised from a set-top box.
Content and catalogue writes — create, edit and delete for live channels, movies, series, episodes, radio stations, categories, bouquets, packages, groups and servers.
Connection control — kill a live connection; list servers.

Fixed — actions that never worked

get_providers / create_provider / edit_provider / delete_provider. They read and wrote a table called providers, which does not exist — the query failed and the action answered with an empty body. The panel keeps providers in streams_providers. They now serve the table the panel uses. Note provider_id is the key, not id.
get_blocked_uas / add_blocked_ua / delete_blocked_ua. Same fault: the table is blocked_user_agents, not blocked_uas. get_blocked_uas returned the ISP list, and every block silently blocked nothing. The parameter is user_agent; the documented ua is still accepted.
edit_settings. Every call that named a real settings column failed outright. A call naming no real column appeared to succeed, which made it look intermittent.
create_mag / create_enigma / create_line / create_activecode. Refused with STATUS_INSUFFICIENT_CREDITS against an admin key. The admin was being priced with the reseller’s rules — but an admin has no credit balance: the panel routes them to a different page that has no pricing at all. An admin is no longer charged, and cannot be refused for a balance. Resellers are charged exactly as before.
create_user / edit_user. Refused with “Sub-reseller creation is not enabled for your group” against an admin key. That is the reseller’s rule (create_sub_resellers plus Sub-Reseller Setup); the admin’s own page requires neither and offers every group. An admin may now create a reseller in any group, seed it with credits, and name any owner.
create_user / edit_user take api_access=0|1 — the Allow API Access switch (Reseller Members → Edit). Off removes the account’s key and cascades to every sub-reseller below it, as the panel does. A key whose account switch is off is refused with Invalid API key. (T-0000182)
adjust_credits. An admin’s adjustment was debited from the admin’s own reg_users balance — a number the panel never shows and never refills, so the action worked until that hidden balance hit zero and then refused. An admin now grants: the reseller is credited, nobody is debited, and the movement is recorded in credits_log against the admin.
Bouquets, categories and episodes were written without the rows that make them mean something. A bouquet had no categories blob, so it produced no catalogue; a new category was never counted, so player_api hid it; an episode was never filed into series_episodes, so its series reported no seasons; and movies and radio went into columns get.php does not read. Content created through the API now reaches customers — verified end to end against player_api.php and get.php with a real line.
Category item counts are maintained again. The count that decides whether a category is visible at all had not been recomputed since this core took over the panel’s cron work, so any category created since — in the panel as much as through the API — was invisible to every client. It is recomputed whenever content changes.
A stream can no longer be created with no server behind it. The panel refuses that save (“Select at least one server.”) and writes the binding; the API did not, so a stream created without the panel’s server_tree_data was listed in every playlist and in player_api with nothing to play. Send server_id=3, server_ids=3,4,5, or the panel’s server_tree_data; parent_id names the server the others take their feed from and on_demand marks the on-demand ones. An edit that does not mention servers keeps the ones the stream has — but no save may leave a stream with none.
Deleting a stream now removes its server binding. It did not, so every deleted stream left rows behind — and stream ids are reused, so a later stream could inherit a dead binding nobody gave it. Deleting a series now removes its episodes too, instead of leaving them as orphaned rows playable through no series. A series with a locked episode is refused rather than silently skipped.
Reseller actions are logged the way the panel logs them. Every purchase, extension and deletion now writes the reseller’s history row (Reg User Log) as well as the credit row, in the panel’s own wording — New M3U User: <user> - LineID: <id> - Pack-ID: <pkg> and its balance line. Sales made through the API used to be missing from that screen entirely while the credits still left the balance. A deletion by a reseller whose group has refunds switched off is now logged too; it used to leave no trace at all.
Audit rows say when the API did it. Every credit line the API writes ends with Via api, so the ledger distinguishes a charge made in the panel from one made by an integration. The amount cell is also signed correctly now — a top-up read --1 instead of +1.
close_ticket reply shape. Its reply carried status twice — once for the request outcome and once for the ticket — and a JSON parser keeps the last. The ticket’s state is ticket_status.

Across every endpoint

Dry runs. dry_run=1 on any write validates it and answers with the record it would have created — without writing.
Idempotent creates. request_id=<your id> makes a retried create safe.
Bulk. ids=1,2,3 on delete / disable / enable / close, with a per-item result.
Pagination and filters on every list — total, start, limit, returned, has_more, plus search, order_by, order_dir and column filters.
Delta sync. since / until, so a client can poll for what changed.
Machine-readable errors — error_code, field, hint.
Refusals name the setting. A refusal caused by a permission carries the exact panel path and the permission key, in the reply and in the log, so the operator can fix it without guessing.
Every action is permission-checked. The published API declared its permission list empty, so every check inside it passed and any valid key could do anything. All 182 actions now map to the Manage Groups permission the equivalent panel page requires.

General

Retrieve admin account information and package details.

GET user_info Get Admin Account Info

Returns your admin account details including server info and account settings.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=user_info"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 1,
    "username": "admin",
    "email": "admin@example.com",
    "status": 1,
    "server_name": "Main Server",
    "total_lines": 1250,
    "total_resellers": 34,
    "created_at": "2024-01-01 00:00:00"
  }
}

GET get_packages List All Packages

Returns all packages configured in the system.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_packages"

Response

{
  "status": "STATUS_SUCCESS",
  "data": [
    {
      "id": 1,
      "package_name": "1 Month",
      "credits": 5.00,
      "duration_months": 1,
      "is_trial": 0,
      "is_official": 1,
      "groups": [1, 3, 5]
    }
  ]
}

GET get_package Get Single Package

Retrieve details of a single package by its ID.

Parameter	Type	Required	Description
id	int	Required	Package ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_package&id=1"

Line Management

Create, manage, and control M3U lines. Admin creates lines with direct parameters (exp_date, bouquets, max_connections) rather than packages.

POST create_line Create Line

Creates a new M3U line with direct parameter control. Username and password are auto-generated if not provided.

Parameter	Type	Required	Description
exp_date	string	Required	Expiration date (YYYY-MM-DD format)
username	string	Optional	Custom username (auto-generated if empty)
password	string	Optional	Custom password (auto-generated if empty)
bouquets_selected	json	Optional	JSON array of bouquet IDs, e.g. [1,2,3]
max_connections	int	Optional	Maximum simultaneous connections (default: 1)
member_id	int	Optional	Assign to a specific reseller by ID
is_restreamer	int	Optional	0 = normal, 1 = restreamer account
is_trial	int	Optional	0 = regular, 1 = trial
is_isplock	int	Optional	0 = disabled, 1 = enable ISP lock
allowed_ips[]	array	Optional	Array of allowed IP addresses
allowed_ua[]	array	Optional	Array of allowed User-Agent strings
admin_notes	string	Optional	Admin-only notes
reseller_notes	string	Optional	Notes visible to reseller

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_line" \
  -d "exp_date=2026-12-31" \
  -d "username=customer1" \
  -d "password=securepass" \
  -d "max_connections=2" \
  -d "bouquets_selected=[1,2,5]" \
  -d "admin_notes=VIP customer"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 4521,
    "username": "customer1",
    "password": "securepass",
    "exp_date": "2026-12-31",
    "max_connections": 2,
    "is_trial": 0,
    "status": 1,
    "admin_notes": "VIP customer",
    "created_at": "2026-03-15 14:30:00"
  }
}

POST edit_line Edit Line

Edit an existing line's properties. Only provided parameters are updated.

Parameter	Type	Required	Description
id	int	Required	Line ID to edit
exp_date	string	Optional	New expiration date (YYYY-MM-DD)
username	string	Optional	New username
password	string	Optional	New password
bouquets_selected	json	Optional	JSON array of bouquet IDs
max_connections	int	Optional	Max simultaneous connections
member_id	int	Optional	Reassign to a reseller
is_restreamer	int	Optional	0 or 1
is_trial	int	Optional	0 or 1
is_isplock	int	Optional	0 or 1
allowed_ips[]	array	Optional	Allowed IPs
allowed_ua[]	array	Optional	Allowed User-Agents
admin_notes	string	Optional	Admin notes
reseller_notes	string	Optional	Reseller notes

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_line" \
  -d "id=4521" \
  -d "exp_date=2027-06-30" \
  -d "max_connections=3"

POST extend_line Extend Line

Extend a line's expiry only — all other properties (bouquets, max connections, username, password) are preserved. The duration is added to the line's current expiry, or from now if already expired. Provide exactly ONE of: package, months, days, or an absolute exp_date. No credits are charged (admin action).

Parameter	Type	Required	Description
id	int	Required	Line ID to extend
package	int	Optional	Package ID — adds its official duration
months	int	Optional	Number of months to add
days	int	Optional	Number of days to add
exp_date	string	Optional	Absolute new expiry (YYYY-MM-DD)

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=extend_line" \
  -d "id=4521" \
  -d "package=2"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 4521,
    "exp_date": "2028-01-31 00:00:00"
  }
}

GET get_line Get Single Line

Retrieve details of a single M3U line by its ID.

Parameter	Type	Required	Description
id	int	Required	Line ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_line&id=4521"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 4521,
    "username": "customer1",
    "password": "securepass",
    "exp_date": "2026-12-31",
    "max_connections": 2,
    "is_trial": 0,
    "is_isplock": 0,
    "is_restreamer": 0,
    "enabled": 1,
    "admin_enabled": 1,
    "allowed_ips": [],
    "allowed_ua": [],
    "admin_notes": "VIP customer",
    "reseller_notes": "",
    "bouquets": [1, 2, 5],
    "member_id": 0,
    "created_at": "2026-03-15 14:30:00"
  }
}

GET get_lines List All Lines

Retrieve a paginated list of all M3U lines. Supports search and status filtering.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset (default: 0)
limit	int	Optional	Records per page (default: 50)
search[value]	string	Optional	Search by username or other fields
filter	int	Optional	1=Active, 2=Disabled, 3=Banned, 4=Expired, 5=Trial
line_username	string	Optional	One line by its exact username. `username=` is ignored on this listing (third-party panels send it with every call, and the PHP API ignored it too).

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_lines&start=0&limit=25&filter=1"

POST delete_line Delete Line

Permanently delete a line. This action cannot be undone.

Parameter	Type	Required	Description
id	int	Required	Line ID to delete

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_line" \
  -d "id=4521"

POST disable_line Disable Line

Temporarily disable a line (sets enabled=0). The line can be re-enabled later.

Parameter	Type	Required	Description
id	int	Required	Line ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=disable_line" \
  -d "id=4521"

POST enable_line Enable Line

Re-enable a previously disabled line (sets enabled=1).

Parameter	Type	Required	Description
id	int	Required	Line ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=enable_line" \
  -d "id=4521"

POST ban_line Ban Line

Admin-ban a line (sets admin_enabled=0). Unlike disable, banned lines cannot be re-enabled by resellers.

Parameter	Type	Required	Description
id	int	Required	Line ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=ban_line" \
  -d "id=4521"

POST unban_line Unban Line

Remove admin ban from a line (sets admin_enabled=1).

Parameter	Type	Required	Description
id	int	Required	Line ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=unban_line" \
  -d "id=4521"

MAG Device Management

Create and manage MAG device subscriptions with direct parameter control.

POST create_mag Create MAG Device

Parameter	Type	Required	Description
mac	string	Required	MAC address (format: 00:1A:79:XX:XX:XX)
exp_date	string	Optional	Expiration date (YYYY-MM-DD)
bouquets_selected	json	Optional	JSON array of bouquet IDs
max_connections	int	Optional	Max connections (default: 1)
member_id	int	Optional	Assign to reseller by ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_mag" \
  -d "mac=00:1A:79:AB:CD:EF" \
  -d "exp_date=2026-12-31" \
  -d "bouquets_selected=[1,2,5]"

POST edit_mag Edit MAG Device

Edit a MAG device's properties.

Parameter	Type	Required	Description
id	int	Required	MAG device ID
mac	string	Optional	New MAC address
exp_date	string	Optional	New expiration date
bouquets_selected	json	Optional	JSON array of bouquet IDs

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_mag" \
  -d "id=301" \
  -d "exp_date=2027-06-30"

GETget_magGet Single MAG

Retrieve details of a single MAG device.

Parameter	Type	Required	Description
id	int	Required	MAG device ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_mag&id=301"

GETget_magsList MAG Devices

Retrieve a paginated list of all MAG devices.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term
filter	int	Optional	1=Active, 2=Disabled, 3=Banned, 4=Expired

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_mags&start=0&limit=25"

POSTdelete_magDelete MAG

Permanently delete a MAG device entry.

Parameter	Type	Required	Description
id	int	Required	MAG device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_mag" \
  -d "id=301"

POSTdisable_magDisable MAG

Temporarily disable a MAG device (sets enabled=0).

Parameter	Type	Required	Description
id	int	Required	MAG device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=disable_mag" \
  -d "id=301"

POSTenable_magEnable MAG

Re-enable a previously disabled MAG device (sets enabled=1).

Parameter	Type	Required	Description
id	int	Required	MAG device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=enable_mag" \
  -d "id=301"

POSTban_magBan MAG

Admin-ban a MAG device (sets admin_enabled=0).

Parameter	Type	Required	Description
id	int	Required	MAG device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=ban_mag" \
  -d "id=301"

POSTunban_magUnban MAG

Remove admin ban from a MAG device (sets admin_enabled=1).

Parameter	Type	Required	Description
id	int	Required	MAG device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=unban_mag" \
  -d "id=301"

POSTconvert_magConvert MAG to M3U

Convert a MAG device subscription to an M3U line. Returns the newly created line with username and password.

Parameter	Type	Required	Description
id	int	Required	MAG device ID to convert

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=convert_mag" \
  -d "id=301"

MAG Claims

Viewer reports raised from a MAG box — Panel → MAG Claims. A claim names the stream, the device and when it was reported, and is how a set-top user tells you a channel is down. New in this core: previously panel-only.

POSTget_mag_claimsList MAG Claims

Page the claim list, newest ids last.

Parameter	Type	Required	Description
limit	int	Optional	Rows to return
start	int	Optional	Offset

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=get_mag_claims" \
  -d "limit=50"

POSTget_mag_claimGet MAG Claim

One claim.

Parameter	Type	Required	Description
id	int	Required	Claim ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=get_mag_claim" \
  -d "id=1"

POSTdelete_mag_claimClear MAG Claim

Remove a claim once it has been dealt with.

Parameter	Type	Required	Description
id	int	Required	Claim ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_mag_claim" \
  -d "id=1"

Enigma2 Device Management

Create and manage Enigma2 device subscriptions.

POSTcreate_enigmaCreate Enigma2 Device

Parameter	Type	Required	Description
mac	string	Required	Device MAC address
exp_date	string	Optional	Expiration date (YYYY-MM-DD)
bouquets_selected	json	Optional	JSON array of bouquet IDs
max_connections	int	Optional	Max connections
member_id	int	Optional	Assign to reseller

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_enigma" \
  -d "mac=AA:BB:CC:DD:EE:FF" \
  -d "exp_date=2026-12-31"

POSTedit_enigmaEdit Enigma2

Edit an Enigma2 device's properties.

Parameter	Type	Required	Description
id	int	Required	Enigma2 device ID
mac	string	Optional	New MAC address
exp_date	string	Optional	New expiration date
bouquets_selected	json	Optional	JSON array of bouquet IDs

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_enigma" \
  -d "id=501" \
  -d "exp_date=2027-06-30"

GETget_enigmaGet Single Enigma2

Retrieve details of a single Enigma2 device.

Parameter	Type	Required	Description
id	int	Required	Enigma2 device ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_enigma&id=501"

GETget_enigmasList Enigma2 Devices

Retrieve a paginated list of all Enigma2 devices.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term
filter	int	Optional	1=Active, 2=Disabled, 3=Banned, 4=Expired

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_enigmas&start=0&limit=25"

POSTdelete_enigmaDelete Enigma2

Permanently delete an Enigma2 device.

Parameter	Type	Required	Description
id	int	Required	Enigma2 device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_enigma" \
  -d "id=501"

POSTdisable_enigmaDisable Enigma2

Temporarily disable an Enigma2 device.

Parameter	Type	Required	Description
id	int	Required	Enigma2 device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=disable_enigma" \
  -d "id=501"

POSTenable_enigmaEnable Enigma2

Re-enable a previously disabled Enigma2 device.

Parameter	Type	Required	Description
id	int	Required	Enigma2 device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=enable_enigma" \
  -d "id=501"

POSTban_enigmaBan Enigma2

Admin-ban an Enigma2 device (sets admin_enabled=0).

Parameter	Type	Required	Description
id	int	Required	Enigma2 device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=ban_enigma" \
  -d "id=501"

POSTunban_enigmaUnban Enigma2

Remove admin ban from an Enigma2 device (sets admin_enabled=1).

Parameter	Type	Required	Description
id	int	Required	Enigma2 device ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=unban_enigma" \
  -d "id=501"

POSTconvert_enigmaConvert Enigma2 to M3U

Convert an Enigma2 device subscription to an M3U line.

Parameter	Type	Required	Description
id	int	Required	Enigma2 device ID to convert

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=convert_enigma" \
  -d "id=501"

Sub-Reseller Management

Create and manage reseller accounts and their credits.

POSTcreate_userCreate Sub-Reseller

Create a new reseller account.

New in this version

api_access=0|1 — Allow API Access for the account, the T-0000182 switch. Not sent = on, like the admin form. An admin may always set it.

Parameter	Type	Required	Description
username	string	Optional	Username (auto-generated if empty)
password	string	Optional	Password (auto-generated if empty)
email	string	Optional	Email address
member_group_id	int	Optional	Member group to assign
notes	string	Optional	Internal notes
api_access	0 \| 1	Optional	Allow API Access for the new account (the switch on Reseller Members → Edit). Not sent = `1`, the same as the admin’s form. `0` creates the account without an API key and the API page blocked for it. The account still needs its group’s Can Use Reseller API to actually use the API.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_user" \
  -d "username=reseller1" \
  -d "password=strongpass123" \
  -d "email=reseller@example.com" \
  -d "member_group_id=3" \
  -d "api_access=1"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 88,
    "username": "reseller1",
    "email": "reseller@example.com",
    "member_group_id": 3,
    "credits": 0,
    "api_access": 1,
    "status": 1,
    "created_at": "2026-03-15 14:30:00"
  }
}

POSTedit_userEdit Sub-Reseller

Edit a reseller account's properties.

New in this version

api_access=0|1 — Allow API Access for the account, the T-0000182 switch. Off removes the key at once and cascades to every sub-reseller below the account.

Parameter	Type	Required	Description
id	int	Required	Reseller ID
username	string	Optional	New username
password	string	Optional	New password
email	string	Optional	New email
member_group_id	int	Optional	New group ID
notes	string	Optional	Internal notes
api_access	0 \| 1	Optional	Allow API Access. Not sent = unchanged. `0` removes the account’s API key at once and turns API access off for every sub-reseller below it, at every level, removing their keys too, exactly as the panel does. Turning it back on does not turn the sub-resellers back on; each has to be allowed again.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_user" \
  -d "id=88" \
  -d "email=new@example.com"

GETget_userGet Single Reseller

Retrieve details of a single reseller account.

New in this version

The row carries api_access (1 = the account may use the reseller API, 0 = blocked), the Allow API Access switch. Also on get_users. (T-0000182)

Parameter	Type	Required	Description
id	int	Required	Reseller ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_user&id=88"

GETget_usersList Resellers

Retrieve a paginated list of all reseller accounts.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term
reseller_username	string	Optional	One sub-reseller by its exact username. `username=` is ignored on this listing.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_users&start=0&limit=25"

POSTdelete_userDelete Reseller

Permanently delete a reseller account.

Parameter	Type	Required	Description
id	int	Required	Reseller ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_user" \
  -d "id=88"

POSTdisable_userDisable Reseller

Temporarily disable a reseller account.

Parameter	Type	Required	Description
id	int	Required	Reseller ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=disable_user" \
  -d "id=88"

POSTenable_userEnable Reseller

Re-enable a previously disabled reseller account.

Parameter	Type	Required	Description
id	int	Required	Reseller ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=enable_user" \
  -d "id=88"

POSTadjust_creditsAdjust Credits

Add or subtract credits from a reseller account. Use positive values to add and negative values to subtract.

Parameter	Type	Required	Description
id	int	Required	Reseller ID
credits	float	Required	Credits to adjust (positive = add, negative = subtract)

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=adjust_credits" \
  -d "id=88" \
  -d "credits=100"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 88,
    "credits_before": 50.00,
    "credits_after": 150.00,
    "adjusted": 100
  }
}

Streams & Content

Manage live streams, channels, movies, series, and radio stations.

GETget_streamsList Live Streams

Retrieve list of all live streams.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_streams"

GETget_streamGet Single Stream

Retrieve details of a single stream by ID.

Parameter	Type	Required	Description
id	int	Required	Stream ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_stream&id=10"

GETget_channelsList Channels

Retrieve list of all created channels.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_channels"

GETget_channelGet Single Channel

Retrieve details of a single channel.

Parameter	Type	Required	Description
id	int	Required	Channel ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_channel&id=5"

GETget_stationsList Radio Stations

Retrieve list of all radio stations.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_stations"

GETget_moviesList Movies

Retrieve list of all movies.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_movies"

GETget_movieGet Single Movie

Retrieve details of a single movie.

Parameter	Type	Required	Description
id	int	Required	Movie ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_movie&id=100"

GETget_series_listList Series

Retrieve list of all TV series.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_series_list"

GETget_seriesGet Single Series

Retrieve details of a single series.

Parameter	Type	Required	Description
id	int	Required	Series ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_series&id=50"

GETget_episodesList Episodes

Retrieve list of all episodes.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_episodes"

GETget_episodeGet Single Episode

Retrieve details of a single episode.

Parameter	Type	Required	Description
id	int	Required	Episode ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_episode&id=200"

Adding movies and series from a script

These endpoints add content the same way the panel’s Watch Folder does: the details come from TMDB, the item is placed on its server, the encode is started, and the apps show it with poster, plot and seasons. A script only needs the file location and, ideally, the TMDB id.

Flow

Movie:    create_movie  (tmdb_id + stream_source + category_id + server_id)
             |-> details from TMDB, poster, runtime, rating
             |-> placed on the server, added to the bouquets you name
             '-> encode started (reply: "encode")

Series:   create_series (tmdb_id + category_id)          -> data.id = SERIES_ID
             |-> title, cover, plot, cast, seasons from TMDB
             '-> for every file:
                 create_episode (series_id=SERIES_ID + season_num + episode_num + stream_source)
                    |-> name "Show (2022) - S01E02 - Episode title", still, plot, air date
                    |-> same server(s) as the other episodes when none is named
                    |-> series seasons refreshed
                    '-> encode started

stream_source is a URL (http://host/file.mkv) or a file on a server: s:<server_id>:<full path>, e.g. s:3:/media/shows/Show/S01/E01.mkv.
tmdb_id needs a TMDB API key in Settings. Without a key the id is stored and a warnings line says no details were fetched. Anything you send yourself (name, plot, image, …) always wins over TMDB.
Safe to re-run. A movie whose stream_source is already a movie in the same category, a series with the same TMDB id or title in the same category, and an episode number the series already has are refused with error_code: "duplicate" and the existing id in data.id. Keep that id and move on, or send allow_duplicate=1.
Look up before you add: get_series_list&search=<title> and get_episodes&search=<title> page through what exists; use them instead of mysql_query polling.
Container (target_container) defaults to the file extension of the source, mp4 when it has none, and is stored as the panel stores it: ["mkv"].
Encode. See the encode parameter. start_movie / start_episode start it again at any time.

POSTcreate_movieCreate Movie

Add a movie. With tmdb_id the name (“Title (Year)”), poster, backdrop, plot, cast, director, genre, runtime, rating, year and trailer are filled from TMDB.

Parameter	Type	Required	Description
stream_source	string	Required	URL of the file, or `s:<server_id>:<path>` for a file on a server.
tmdb_id	int	Optional	TMDB movie id. Fills everything below that you do not send.
stream_display_name	string	Required*	Movie name. *Not needed when `tmdb_id` is sent.
category_id	int	Required	Movie category id (`get_categories`). Without one the movie is in no list.
server_id	int	Required	Which streaming server(s) carry it. `server_id=3`, `server_ids=3,4` or the panel’s `server_tree_data`. `parent_id` makes the others take their feed from that server, `on_demand=3,4` marks on-demand ones. List them with `get_servers`.
bouquets	list	Optional	Bouquet ids, e.g. `1,4`. The movie is added to them.
stream_icon	string	Optional	Poster shown in lists. Default: the TMDB poster / `movie_image`.
target_container	string	Optional	`mp4`, `mkv`, … Default: the source’s extension, else `mp4`.
plot	string	Optional	Description.
movie_image	string	Optional	Poster / still image URL. Also becomes `stream_icon` when that is not sent.
backdrop_path	string	Optional	Backdrop image URL.
cast	string	Optional	Comma-separated actors.
director	string	Optional	Director(s).
genre	string	Optional	Genre text, e.g. `Drama, Crime`.
country	string	Optional	Country.
release_date	string	Optional	`YYYY-MM-DD`.
episode_run_time	int	Optional	Runtime in minutes (sets `duration` and `duration_secs`).
rating	number	Optional	Rating, e.g. `7.4`.
youtube_trailer	string	Optional	YouTube video id.
movie_propeties	JSON	Optional	The whole properties object, written exactly as sent. Use it only if you build the object yourself; the fields above are merged for you.
direct_source	0\|1	Optional	`1` = players get the source URL directly; nothing is encoded.
encode	0\|1	Optional	`1` starts the encode on every server right after the save, `0` never. Not sent: follows the panel setting Watch Folder › Settings › Auto Encode, the same switch the watch folder uses. A `direct_source=1` item is never encoded. The reply says what happened in `encode`.
allow_duplicate	0\|1	Optional	Send `1` to add it even when the same item already exists (see the duplicate check above).
dry_run	0\|1	Optional	`1` checks everything and shows the record it would write, without writing it.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_movie" \
  -d "tmdb_id=27205" \
  --data-urlencode "stream_source=s:3:/media/movies/Inception.2010.mkv" \
  -d "category_id=9" \
  -d "server_id=3" \
  -d "bouquets=1"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 991421,
    "type": 2,
    "category_id": 9,
    "stream_display_name": "Inception (2010)",
    "stream_source": ["s:3:/media/movies/Inception.2010.mkv"],
    "stream_icon": "https://image.tmdb.org/t/p/w600_and_h900_bestv2/....jpg",
    "target_container": ["mkv"],
    "movie_propeties": {
      "tmdb_id": 27205, "name": "Inception", "releasedate": "2010-07-15",
      "duration": "02:28:00", "duration_secs": 8880, "rating": 8.37,
      "genre": "Action, Science Fiction, Adventure", "plot": "...",
      "movie_image": "https://image.tmdb.org/...", "backdrop_path": ["https://image.tmdb.org/..."]
    },
    "year": "2010"
  },
  "encode": { "started": true, "reason": "watch folder setting Auto Encode", "servers": [3] }
}

Already added

{
  "status": "STATUS_EXISTS_SOURCE",
  "data": { "id": 991421 },
  "error": "This source is already a movie in this category (id 991421).",
  "error_code": "duplicate",
  "field": "id"
}

POSTedit_movieEdit Movie

Change a movie. Only the fields you send change. Property fields (plot, rating, …) are merged into the existing properties; tmdb_id re-reads TMDB.

Parameter	Type	Required	Description
id	int	Required	Movie id.
...		Optional	Any field of `create_movie`.
encode	0\|1	Optional	`1` re-starts the encode after the save. Not sent: no encode on an edit.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_movie" \
  -d "id=991421" \
  --data-urlencode "plot=New description" \
  -d "rating=8.1"

POSTdelete_movieDelete Movie

Delete a movie, its server binding and its encoded file.

Parameter	Type	Required	Description
id	int	Required	Movie id. `ids=1,2,3` deletes several.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_movie" \
  -d "id=991421"

POSTcreate_seriesCreate Series

Add a TV series (the show itself; episodes are added with create_episode). With tmdb_id the title (“Name (Year)”), cover, backdrop, plot, cast, genre, rating, first air date, runtime, trailer and the seasons list are filled from TMDB.

Parameter	Type	Required	Description
tmdb_id	int	Optional	TMDB TV id. Fills everything below that you do not send.
title	string	Required*	Series name. *Not needed when `tmdb_id` is sent.
category_id	int	Required	Series category id (`get_categories`, type series).
bouquets	list	Optional	Bouquet ids. The series is added to them.
cover	string	Optional	Cover image URL.
backdrop_path	string	Optional	Backdrop image URL.
plot	string	Optional	Description.
cast	string	Optional	Actors.
director	string	Optional	Director(s).
genre	string	Optional	Genre text.
rating	number	Optional	Rating.
releaseDate	string	Optional	First air date `YYYY-MM-DD`.
episode_run_time	int	Optional	Episode runtime in minutes.
youtube_trailer	string	Optional	YouTube video id.
allow_duplicate	0\|1	Optional	Send `1` to add it even when the same item already exists (see the duplicate check above).
dry_run	0\|1	Optional	`1` checks everything and shows the record it would write, without writing it.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_series" \
  -d "tmdb_id=202010" \
  -d "category_id=7" \
  -d "bouquets=1"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 9967,
    "title": "Kus Ucusu (2022)",
    "category_id": 7,
    "cover": "https://image.tmdb.org/t/p/w600_and_h900_bestv2/....jpg",
    "genre": "Drama",
    "rating": 7,
    "releaseDate": "2022-06-03",
    "tmdb_id": 202010,
    "seasons": [
      { "season_number": 1, "name": "Season 1", "episode_count": 8, "air_date": "2022-06-03", "cover": "https://image.tmdb.org/..." },
      { "season_number": 2, "name": "Season 2", "episode_count": 8, "air_date": "2023-12-14", "cover": "https://image.tmdb.org/..." }
    ],
    "episode_run_time": 45
  }
}

Already added

{
  "status": "STATUS_EXISTS_NAME",
  "data": { "id": 9967 },
  "error": "This series already exists in this category (id 9967). Add episodes to it with create_episode&series_id=9967.",
  "error_code": "duplicate",
  "field": "id"
}

POSTedit_seriesEdit Series

Change a series. Only the fields you send change; tmdb_id re-reads TMDB and refreshes the seasons.

Parameter	Type	Required	Description
id	int	Required	Series id.
...		Optional	Any field of `create_series`.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_series" \
  -d "id=9967" \
  --data-urlencode "cover=https://example.com/cover.jpg"

POSTdelete_seriesDelete Series

Delete a series and all its episodes. A series with a locked episode is refused.

Parameter	Type	Required	Description
id	int	Required	Series id.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_series" \
  -d "id=9967"

POSTcreate_episodeCreate Episode

Add one episode to a series. When the series has a TMDB id, the episode title, still image, plot, air date and runtime come from TMDB for that season and episode number. The series’ seasons are refreshed after the save.

Parameter	Type	Required	Description
series_id	int	Required	The series (from `create_series` / `get_series_list`). `series` is accepted too.
season_num	int	Required	Season number. `season` is accepted too.
episode_num	int	Required	Episode number (1 or more). `episode` is accepted too.
stream_source	string	Required	URL of the file, or `s:<server_id>:<path>`.
server_id	int	Required*	Which streaming server(s) carry it. `server_id=3`, `server_ids=3,4` or the panel’s `server_tree_data`. `parent_id` makes the others take their feed from that server, `on_demand=3,4` marks on-demand ones. List them with `get_servers`. *Not needed when the series already has episodes: the new one goes on the same server(s), and `warnings` says so.
stream_display_name	string	Optional	Default: `<series title> - S01E02` plus `- <episode title>` when TMDB knows it.
target_container	string	Optional	Default: the source’s extension, else `mp4`.
tmdb_id	int	Optional	TMDB id of the episode, stored in its properties.
plot	string	Optional	Description.
movie_image	string	Optional	Poster / still image URL. Also becomes `stream_icon` when that is not sent.
release_date	string	Optional	`YYYY-MM-DD`.
episode_run_time	int	Optional	Runtime in minutes (sets `duration` and `duration_secs`).
rating	number	Optional	Rating, e.g. `7.4`.
movie_propeties	JSON	Optional	The whole properties object, written exactly as sent. Use it only if you build the object yourself; the fields above are merged for you.
direct_source	0\|1	Optional	`1` = players get the source URL directly; nothing is encoded.
encode	0\|1	Optional	`1` starts the encode on every server right after the save, `0` never. Not sent: follows the panel setting Watch Folder › Settings › Auto Encode, the same switch the watch folder uses. A `direct_source=1` item is never encoded. The reply says what happened in `encode`.
allow_duplicate	0\|1	Optional	Send `1` to add it even when the same item already exists (see the duplicate check above).
dry_run	0\|1	Optional	`1` checks everything and shows the record it would write, without writing it.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_episode" \
  -d "series_id=9967" \
  -d "season_num=1" \
  -d "episode_num=2" \
  --data-urlencode "stream_source=s:3:/media/shows/Kus Ucusu/S01/E02.mp4"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "id": 991420,
    "type": 5,
    "stream_display_name": "Kus Ucusu (2022) - S01E02 - Episode 2",
    "stream_source": ["s:3:/media/shows/Kus Ucusu/S01/E02.mp4"],
    "stream_icon": "https://image.tmdb.org/t/p/w600_and_h900_bestv2/....jpg",
    "target_container": ["mp4"],
    "series_no": 9967,
    "movie_propeties": {
      "name": "Kus Ucusu (2022) - S01E02 - Episode 2", "season": 1, "episode": 2,
      "tmdb_id": 3721893, "plot": "...", "release_date": "2022-06-03",
      "duration": "00:41:00", "duration_secs": 2460, "movie_image": "https://image.tmdb.org/..."
    }
  },
  "encode": { "started": true, "reason": "watch folder setting Auto Encode", "servers": [3] },
  "warnings": ["no server was named; used the servers of the series' other episodes (3)"]
}

Already added

{
  "status": "STATUS_EXISTS_SOURCE",
  "data": { "id": 991420 },
  "error": "Series 9967 already has S01E02 (stream id 991420). Use edit_episode to change it, or send allow_duplicate=1.",
  "error_code": "duplicate",
  "field": "id"
}

Other refusals

{ "status": "STATUS_INVALID_INPUT", "error": "Series 99999 does not exist.", "error_code": "not_found", "field": "series_id" }
{ "status": "STATUS_INVALID_INPUT", "error": "season_num is required and must be a number.", "error_code": "field_required", "field": "season_num" }
{ "status": "STATUS_INVALID_INPUT", "error": "Select at least one server. ...", "error_code": "server_required", "field": "server_id" }

POSTedit_episodeEdit Episode

Change an episode. Only the fields you send change; property fields are merged. Sending series_id / season_num / episode_num moves it.

Parameter	Type	Required	Description
id	int	Required	Episode id.
...		Optional	Any field of `create_episode`.
encode	0\|1	Optional	`1` re-starts the encode after the save. Not sent: no encode on an edit.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_episode" \
  -d "id=991420" \
  --data-urlencode "plot=New description"

POSTdelete_episodeDelete Episode

Delete an episode, its server binding and its encoded file.

Parameter	Type	Required	Description
id	int	Required	Episode id. `ids=1,2,3` deletes several.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_episode" \
  -d "id=991420"

POSTstart_streamStart Stream

Start a live stream.

Parameter	Type	Required	Description
id	int	Required	Stream ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=start_stream" \
  -d "id=10"

POSTstop_streamStop Stream

Stop a live stream.

Parameter	Type	Required	Description
id	int	Required	Stream ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=stop_stream" \
  -d "id=10"

POSTstart_channelStart Channel

Start a channel.

Parameter	Type	Required	Description
id	int	Required	Channel ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=start_channel" \
  -d "id=5"

POSTstop_channelStop Channel

Stop a channel.

Parameter	Type	Required	Description
id	int	Required	Channel ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=stop_channel" \
  -d "id=5"

POSTstart_movieStart Movie

Start (or re-start) the encode of a movie on every server it is on, or on server_id only. Answers {"id":100,"started":true,"servers":[3]}.

Parameter	Type	Required	Description
id	int	Required	Movie ID
server_id	int	Optional	One server only.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=start_movie" \
  -d "id=100"

POSTstop_movieStop Movie

Stop the encode of a movie. Answers {"id":100,"stopped":true,"servers":[3]}.

Parameter	Type	Required	Description
id	int	Required	Movie ID
server_id	int	Optional	One server only.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=stop_movie" \
  -d "id=100"

POSTstart_episodeStart Episode Encode

Start (or re-start) the encode of an episode on every server it is on, or on server_id only.

Parameter	Type	Required	Description
id	int	Required	Episode id.
server_id	int	Optional	One server only.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=start_episode" \
  -d "id=991420"

Response

{ "status": "STATUS_SUCCESS", "data": { "id": 991420, "started": true, "servers": [3] } }

POSTstop_episodeStop Episode Encode

Stop the encode of an episode.

Parameter	Type	Required	Description
id	int	Required	Episode id.
server_id	int	Optional	One server only.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=stop_episode" \
  -d "id=991420"

Configuration

Manage bouquets, groups, categories, access codes, EPGs, and transcode profiles.

Bouquets

CRUD operations for bouquet management.

Fixed — bouquets the API made were invisible

A bouquet carries a categories blob (the four category lists and their counts) and a type, and the catalogue builder takes each bouquet’s category order from that blob. The API wrote neither, so every bouquet it created or edited produced no catalogue at all — the line authenticated and the customer saw an empty app, whatever the id lists said. Both are now written, and recomputed from the final lists on every save.

Two ways to say what a bouquet holds, and you may use either:

By category — live_categories, vod_categories, series_categories, radio_categories, each a JSON array or comma-separated list of category ids. The channel and series lists are DERIVED from them, which is what the panel’s own screen does. This wins if both forms are sent.
By id — bouquet_data, a JSON object with stream, movies, radios and series arrays. Unchanged, and still supported.

Note the storage: live channels, created channels, radio AND movies all live in bouquet_channels; only series are separate. That is what the panel writes and what get.php reads — filing movies into bouquet_movies by name left them out of every playlist while they still showed in player_api.

GETget_bouquetsList All Bouquets

Retrieve all bouquets.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_bouquets"

GETget_bouquetGet Single Bouquet

Retrieve a single bouquet by ID.

Parameter	Type	Required	Description
id	int	Required	Bouquet ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_bouquet&id=1"

POSTcreate_bouquetCreate Bouquet

Create a new bouquet.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_bouquet" \
  -d "bouquet_name=Premium Sports"

POSTedit_bouquetEdit Bouquet

Edit an existing bouquet.

Parameter	Type	Required	Description
id	int	Required	Bouquet ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_bouquet" \
  -d "id=1" \
  -d "bouquet_name=Premium Sports HD"

POSTdelete_bouquetDelete Bouquet

Delete a bouquet.

Parameter	Type	Required	Description
id	int	Required	Bouquet ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_bouquet" \
  -d "id=1"

Groups

CRUD operations for member group management.

GETget_groupsList Groups

List all member groups.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_groups"

GETget_groupGet Group

Get single group by ID.

Parameter	Type	Required	Description
id	int	Required	Group ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_group&id=1"

POSTcreate_groupCreate Group

Create a new member group.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_group" \
  -d "group_name=Premium Resellers"

POSTedit_groupEdit Group

Edit a member group.

Parameter	Type	Required	Description
id	int	Required	Group ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_group" \
  -d "id=1"

POSTdelete_groupDelete Group

Delete a member group.

Parameter	Type	Required	Description
id	int	Required	Group ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_group" \
  -d "id=1"

Access Codes

CRUD operations for API access code management.

GETget_access_codesList Access Codes

List all access codes.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_access_codes"

GETget_access_codeGet Access Code

Get single access code.

Parameter	Type	Required	Description
id	int	Required	Access Code ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_access_code&id=1"

POSTcreate_access_codeCreate Access Code

Create a new access code.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_access_code"

POSTedit_access_codeEdit Access Code

Edit an access code.

Parameter	Type	Required	Description
id	int	Required	Access Code ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_access_code" \
  -d "id=1"

POSTdelete_access_codeDelete Access Code

Delete an access code.

Parameter	Type	Required	Description
id	int	Required	Access Code ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_access_code" \
  -d "id=1"

EPG

Manage Electronic Program Guide sources.

GETget_epgsList EPGs

List all EPG sources.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_epgs"

GETget_epgGet EPG

Get single EPG source.

Parameter	Type	Required	Description
id	int	Required	EPG ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_epg&id=1"

POSTcreate_epgCreate EPG

Add a new EPG source.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_epg"

POSTedit_epgEdit EPG

Edit an EPG source.

Parameter	Type	Required	Description
id	int	Required	EPG ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_epg" \
  -d "id=1"

POSTdelete_epgDelete EPG

Delete an EPG source.

Parameter	Type	Required	Description
id	int	Required	EPG ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_epg" \
  -d "id=1"

POSTreload_epgReload EPG

Force reload EPG data from all sources.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=reload_epg"

Transcode Profiles

Manage transcoding profiles for streams.

GETget_transcode_profilesList Profiles

List all transcode profiles.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_transcode_profiles"

GETget_transcode_profileGet Profile

Get single transcode profile.

Parameter	Type	Required	Description
id	int	Required	Profile ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_transcode_profile&id=1"

POSTcreate_transcode_profileCreate Profile

Create a new transcode profile.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_transcode_profile"

POSTedit_transcode_profileEdit Profile

Edit a transcode profile.

Parameter	Type	Required	Description
id	int	Required	Profile ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_transcode_profile" \
  -d "id=1"

POSTdelete_transcode_profileDelete Profile

Delete a transcode profile.

Parameter	Type	Required	Description
id	int	Required	Profile ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_transcode_profile" \
  -d "id=1"

Security

Manage IP blocking, User-Agent blocking, ISP blocking, and RTMP IP management.

IP Blocking

Block and manage blocked IP addresses.

GETget_blocked_ipsList Blocked IPs

Retrieve all blocked IP addresses.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_blocked_ips"

POSTadd_blocked_ipBlock IP

Add an IP address to the blocklist.

Parameter	Type	Required	Description
ip	string	Required	IP address to block

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=add_blocked_ip" \
  -d "ip=192.168.1.100"

POSTdelete_blocked_ipUnblock IP

Remove an IP address from the blocklist.

Parameter	Type	Required	Description
id	int	Required	Blocked IP entry ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_blocked_ip" \
  -d "id=15"

POSTflush_blocked_ipsFlush All Blocked IPs

Remove all IP addresses from the blocklist.

WarningThis will unblock ALL blocked IPs. Use with caution.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=flush_blocked_ips"

User-Agent Blocking

Block specific User-Agent strings — Panel → User Agents.

Fixed in this core

These three actions never worked. They read and wrote a table called blocked_uas, which does not exist on any install — the panel keeps blocked agents in blocked_user_agents. get_blocked_uas answered with the ISP list instead, and every add_blocked_ua silently blocked nothing. They now read and write the table the panel uses.

The parameter is user_agent, matching the column. ua, which the old documentation named, is still accepted.

GETget_blocked_uasList Blocked UAs

Retrieve all blocked User-Agent strings.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_blocked_uas"

POSTadd_blocked_uaBlock UA

Add a User-Agent string to the blocklist.

Parameter	Type	Required	Description
user_agent	string	Required	User-Agent string to block (`ua` also accepted)
exact_match	int	Optional	1 to match the whole string rather than a substring

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=add_blocked_ua" \
  -d "user_agent=BadBot/1.0"

POSTdelete_blocked_uaUnblock UA

Remove a User-Agent string from the blocklist.

Parameter	Type	Required	Description
id	int	Required	Blocked UA entry ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_blocked_ua" \
  -d "id=5"

ASN Blocking

The autonomous-system blocklist behind Panel → Blocked ASNs, gated by the block_asns group permission. It is usually the largest security table on an install — tens of thousands of rows — so always page it with limit. New in this core: the panel has had this screen for years and the API had no action for it at all.

POSTget_blocked_asnsList Blocked ASNs

Page the ASN blocklist. Supports the standard start, limit, search, order_by and order_dir parameters.

Parameter	Type	Required	Description
limit	int	Optional	Rows to return — use it, the table is large
start	int	Optional	Offset
search	string	Optional	Match against the ISP, domain or country

Request

<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
c
m
d
"
>
c
u
r
l
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
X
 
P
O
S
T
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
h
t
t
p
:
/
/
d
n
s
:
p
o
r
t
/
a
c
c
e
s
s
/
a
d
m
i
n
/
i
n
d
e
x
.
p
h
p
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
p
i
_
k
e
y
=
Y
O
U
R
_
K
E
Y
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
c
t
i
o
n
=
g
e
t
_
b
l
o
c
k
e
d
_
a
s
n
s
"
<
/
s
p
a
n
>


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
l
i
m
i
t
=
5
0
"
<
/
s
p
a
n
>

POSTget_blocked_asnGet Blocked ASN

One ASN record.

Parameter	Type	Required	Description
id	int	Required	Row ID

Request

<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
c
m
d
"
>
c
u
r
l
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
X
 
P
O
S
T
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
h
t
t
p
:
/
/
d
n
s
:
p
o
r
t
/
a
c
c
e
s
s
/
a
d
m
i
n
/
i
n
d
e
x
.
p
h
p
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
p
i
_
k
e
y
=
Y
O
U
R
_
K
E
Y
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
c
t
i
o
n
=
g
e
t
_
b
l
o
c
k
e
d
_
a
s
n
"
<
/
s
p
a
n
>


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
i
d
=
1
"
<
/
s
p
a
n
>

POSTadd_blocked_asnBlock ASN

Add an ASN to the blocklist. blocked=1 enforces it; exclude_restreamer=1 lets restreamer lines through it.

Parameter	Type	Required	Description
asn	int	Required	Autonomous system number
isp	string	Optional	ISP name, as shown in the panel
domain	string	Optional	ISP domain
country	string	Optional	ISO country code
blocked	int	Optional	1 to enforce the block
exclude_restreamer	int	Optional	1 to exempt restreamer lines

Request

<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
c
m
d
"
>
c
u
r
l
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
X
 
P
O
S
T
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
h
t
t
p
:
/
/
d
n
s
:
p
o
r
t
/
a
c
c
e
s
s
/
a
d
m
i
n
/
i
n
d
e
x
.
p
h
p
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
p
i
_
k
e
y
=
Y
O
U
R
_
K
E
Y
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
c
t
i
o
n
=
a
d
d
_
b
l
o
c
k
e
d
_
a
s
n
"
<
/
s
p
a
n
>


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
s
n
=
6
4
5
1
2
"
<
/
s
p
a
n
>


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
i
s
p
=
E
x
a
m
p
l
e
 
H
o
s
t
i
n
g
"
<
/
s
p
a
n
>


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
b
l
o
c
k
e
d
=
1
"
<
/
s
p
a
n
>

POSTedit_blocked_asnEdit Blocked ASN

Change an ASN record — typically to toggle blocked.

Parameter	Type	Required	Description
id	int	Required	Row ID
blocked	int	Optional	1 or 0

Request

<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
c
m
d
"
>
c
u
r
l
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
X
 
P
O
S
T
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
h
t
t
p
:
/
/
d
n
s
:
p
o
r
t
/
a
c
c
e
s
s
/
a
d
m
i
n
/
i
n
d
e
x
.
p
h
p
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
p
i
_
k
e
y
=
Y
O
U
R
_
K
E
Y
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
c
t
i
o
n
=
e
d
i
t
_
b
l
o
c
k
e
d
_
a
s
n
"
<
/
s
p
a
n
>


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
i
d
=
1
"
<
/
s
p
a
n
>


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
b
l
o
c
k
e
d
=
0
"
<
/
s
p
a
n
>

POSTdelete_blocked_asnUnblock ASN

Remove an ASN from the blocklist.

Parameter	Type	Required	Description
id	int	Required	Row ID

Request

<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
c
m
d
"
>
c
u
r
l
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
X
 
P
O
S
T
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
h
t
t
p
:
/
/
d
n
s
:
p
o
r
t
/
a
c
c
e
s
s
/
a
d
m
i
n
/
i
n
d
e
x
.
p
h
p
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
p
i
_
k
e
y
=
Y
O
U
R
_
K
E
Y
"
<
/
s
p
a
n
>
 
\


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
a
c
t
i
o
n
=
d
e
l
e
t
e
_
b
l
o
c
k
e
d
_
a
s
n
"
<
/
s
p
a
n
>


 
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
f
l
a
g
"
>
-
d
<
/
s
p
a
n
>
 
<
s
p
a
n
 
c
l
a
s
s
=
"
h
l
-
s
t
r
"
>
"
i
d
=
1
"
<
/
s
p
a
n
>

ISP Blocking

Block connections from specific ISPs.

GETget_blocked_ispsList Blocked ISPs

Retrieve all blocked ISPs.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_blocked_isps"

POSTadd_blocked_ispBlock ISP

Add an ISP to the blocklist.

Parameter	Type	Required	Description
isp	string	Required	ISP name to block

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=add_blocked_isp" \
  -d "isp=SomeVPN Provider"

POSTdelete_blocked_ispUnblock ISP

Remove an ISP from the blocklist.

Parameter	Type	Required	Description
id	int	Required	Blocked ISP entry ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_blocked_isp" \
  -d "id=3"

RTMP IP Management

Manage allowed RTMP IP addresses.

GETget_rtmp_ipsList RTMP IPs

List all allowed RTMP IPs.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_rtmp_ips"

POSTcreate_rtmp_ipAdd RTMP IP

Add a new allowed RTMP IP.

Parameter	Type	Required	Description
ip	string	Required	RTMP IP address

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_rtmp_ip" \
  -d "ip=10.0.0.50"

POSTedit_rtmp_ipEdit RTMP IP

Edit an RTMP IP entry.

Parameter	Type	Required	Description
id	int	Required	RTMP IP entry ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_rtmp_ip" \
  -d "id=1"

POSTdelete_rtmp_ipDelete RTMP IP

Delete an RTMP IP entry.

Parameter	Type	Required	Description
id	int	Required	RTMP IP entry ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_rtmp_ip" \
  -d "id=1"

Support Tickets

The ticket queue behind Panel → Tickets. Two tables sit under it: the ticket itself (subject, member, state, unread flags) and its replies. New in this core — neither API exposed any of it before, so an integration could sell a customer a line and never see them ask for help.

How the panel behaves — reproduced exactly

status is 1 for open and 0 for closed. An admin reply reopens a closed ticket; a member’s reply does not. Every reply marks the ticket read for the side that wrote it and unread for the other. reply_ticket tells you when it has reopened one, in warnings.

POSTget_ticketsList Tickets

Page the queue. Filter on status for open or closed, or on admin_read=0 for the ones waiting on you.

Parameter	Type	Required	Description
limit	int	Optional	Rows to return
start	int	Optional	Offset
status	int	Optional	1 open, 0 closed
admin_read	int	Optional	0 for tickets you have not read

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=get_tickets" \
  -d "status=1" \
  -d "admin_read=0"

POSTget_ticketGet Ticket + Conversation

The ticket row plus every reply, oldest first, in replies, with reply_count. Reading marks it read for the admin, exactly as opening the panel view does — pass keep_unread=1 to leave the flag alone.

Parameter	Type	Required	Description
id	int	Required	Ticket ID
keep_unread	int	Optional	1 to leave the ticket unread

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=get_ticket" \
  -d "id=2"

POSTcreate_ticketOpen Ticket

Raise a ticket against a reseller account.

Parameter	Type	Required	Description
member_id	int	Required	reg_users id the ticket belongs to
title	string	Required	Subject
status	int	Optional	1 open (default in the panel)

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_ticket" \
  -d "member_id=6" \
  -d "title=Payment not credited" \
  -d "status=1"

POSTreply_ticketReply to Ticket

Append an admin message. If the ticket was closed this reopens it, which is what the panel does; the reply carries reopened: true and a warning saying so.

Parameter	Type	Required	Description
id	int	Required	Ticket ID
message	string	Required	The reply body

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=reply_ticket" \
  -d "id=2" \
  -d "message=Credited now, sorry for the wait."

POSTclose_ticketClose Ticket

Close one ticket with id, or many with ids. The reply reports ticket_status, changed and the ids it changed; ids that do not exist come back in warnings rather than failing the call.

Parameter	Type	Required	Description
id	int	Optional	Ticket ID
ids	string	Optional	Comma-separated ticket IDs

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=close_ticket" \
  -d "ids=2,3,4"

POSTopen_ticketReopen Ticket

The same, in the other direction.

Parameter	Type	Required	Description
id	int	Optional	Ticket ID
ids	string	Optional	Comma-separated ticket IDs

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=open_ticket" \
  -d "id=2"

POSTedit_ticketEdit Ticket

Change a ticket row — its title or the read flags.

Parameter	Type	Required	Description
id	int	Required	Ticket ID
title	string	Optional	New subject

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_ticket" \
  -d "id=2" \
  -d "title=Billing query"

POSTdelete_ticketDelete Ticket

Remove a ticket. Its replies are left in place, as in the panel.

Parameter	Type	Required	Description
id	int	Required	Ticket ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_ticket" \
  -d "id=2"

Activation Codes

The activation-code screens — Panel → Activation Codes, gated by users to view and add_user / edit_user to change. New on the admin API: all eight actions existed on the reseller API and none on this one, so an operator could hand a reseller code management and have none themselves. An admin sees every code, not just their own, and is never charged for one.

POSTget_activecodesList Activation Codes

Every code on the install, paged.

Parameter	Type	Required	Description
limit	int	Optional	Rows to return
start	int	Optional	Offset

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=get_activecodes" \
  -d "limit=50"

POSTget_activecodeGet Activation Code

One code.

Parameter	Type	Required	Description
id	int	Required	Code ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=get_activecode" \
  -d "id=1"

POSTcreate_activecodeCreate Activation Code

Generate one or more codes against a package. count=N generates N.

Parameter	Type	Required	Description
package	int	Required	Package ID the code activates
count	int	Optional	How many to generate
notes	string	Optional	Free-text note

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=create_activecode" \
  -d "package=1" \
  -d "count=5"

POSTedit_activecodeEdit Activation Code

Change a code row.

Parameter	Type	Required	Description
id	int	Required	Code ID
notes	string	Optional	Free-text note

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_activecode" \
  -d "id=1" \
  -d "notes=reissued"

POSTenable_activecodeEnable Activation Code

Allow a code to be redeemed.

Parameter	Type	Required	Description
id	int	Required	Code ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=enable_activecode" \
  -d "id=1"

POSTdisable_activecodeDisable Activation Code

Stop a code being redeemed.

Parameter	Type	Required	Description
id	int	Required	Code ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=disable_activecode" \
  -d "id=1"

POSTreset_activecodeReset Activation Code

Generate a new random activation code, replacing the existing one. Returns both the old and new codes. The device pairing is kept. To free the code from its device instead, use clear_activecode_device.

Parameter	Type	Required	Description
id	int	Required	Code ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=reset_activecode" \
  -d "id=1"

POSTclear_activecode_deviceUnpair Device

Remove the device (and app) the activation code is paired to. The code, package, expiry and bouquets stay the same. The next device that logs in with the code is paired to it. Permission: edit_user.

Parameter	Type	Required	Description
id	int	Required	Code ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=clear_activecode_device" \
  -d "id=1"

Response

{
  "status": "STATUS_SUCCESS",
  "data": { "id": 1, "code": "1940000195", "old_device_id": "00:1A:79:19:40:0A" }
}

POSTdelete_activecodeDelete Activation Code

Remove a code.

Parameter	Type	Required	Description
id	int	Required	Code ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_activecode" \
  -d "id=1"

Server Management

Manage servers, view statistics, and perform system operations.

GETget_serversList Servers

Retrieve a list of all configured servers.

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_servers"

GETget_serverGet Single Server

Retrieve details of a single server.

Parameter	Type	Required	Description
id	int	Required	Server ID

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_server&id=1"

POSTedit_serverEdit Server

Edit server settings and configuration.

Parameter	Type	Required	Description
id	int	Required	Server ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_server" \
  -d "id=1"

POSTedit_proxyEdit Proxy Settings

Edit proxy server settings.

Parameter	Type	Required	Description
id	int	Required	Proxy server ID

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=edit_proxy" \
  -d "id=1"

GETget_server_statsServer Statistics

Retrieve server statistics including CPU, memory, disk usage, and connection counts.

Parameter	Type	Required	Description
server_id	int	Optional	Specific server ID (returns all if omitted)

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=get_server_stats&server_id=1"

Response

{
  "status": "STATUS_SUCCESS",
  "data": {
    "server_id": 1,
    "cpu_usage": 23.5,
    "mem_usage": 62.1,
    "disk_usage": 45.8,
    "uptime": "45 days",
    "active_connections": 342,
    "total_streams": 128
  }
}

POSTreload_nginxReload Nginx

Reload the nginx configuration on the server.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=reload_nginx"

POSTreload_cacheReload Cache

Reload the system cache.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=reload_cache"

POSTclear_tempClear Temp Files

Clear temporary files from the server.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=clear_temp"

POSTclear_streamsClear Stream Cache

Clear the stream cache on the server.

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=clear_streams"

POSTkill_connectionKill Active Connection

Terminate an active user connection by its activity ID. Use live_connections to get active activity IDs.

Parameter	Type	Required	Description
activity_id	int	Required	The activity ID of the connection to terminate
server_id	int	Optional	Server ID (defaults to main server)

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=kill_connection" \
  -d "activity_id=12345"

Response

{
  "status": "STATUS_SUCCESS"
}

POSTkill_pidKill Process by PID

Terminate a running process on the server by its PID. Useful for killing stuck stream processes.

Parameter	Type	Required	Description
pid	int	Required	The process ID to terminate
server_id	int	Optional	Server ID (defaults to main server)

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=kill_pid" \
  -d "pid=54321"

Response

{
  "status": "STATUS_SUCCESS"
}

Logs & Monitoring

Monitor activity, connections, credits, and system events.

GETactivity_logsActivity Logs

Retrieve user activity logs with pagination support.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=activity_logs&start=0&limit=50"

GETlive_connectionsLive Connections

View currently active/live connections across all lines and devices.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=live_connections&start=0&limit=50"

GETcredit_logsCredit Logs

Retrieve credit transaction logs across all resellers.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=credit_logs&start=0&limit=50"

GETuser_logsReseller Action Logs

Retrieve reseller action logs and audit trail.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=user_logs&start=0&limit=50"

GETlogin_logsLogin History

Retrieve login history for all users.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=login_logs&start=0&limit=50"

GETclient_logsClient Connection Logs

Retrieve client connection logs and history.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=client_logs&start=0&limit=50"

GETmag_eventsMAG Device Events

Retrieve MAG device event logs.

Parameter	Type	Required	Description
start	int	Optional	Pagination offset
limit	int	Optional	Records per page
search[value]	string	Optional	Search term

Request

curl -X GET "http://dns:port/access_code/admin/index.php?api_key=YOUR_KEY&action=mag_events&start=0&limit=50"

Response Format

All API responses follow a consistent JSON structure.

Standard Response

{
  "status": "STATUS_SUCCESS" | "STATUS_FAILURE",
  "data": { // Object or Array depending on the endpoint }
}

Important Always check the status field before processing the data field. On failure, the data field may contain an error message or be empty.

Status Codes

All possible status values returned by the API.

STATUS_SUCCESS

STATUS_FAILURE

STATUS_EXISTS_USERNAME

STATUS_EXISTS_MAC

STATUS_INVALID_MAC

STATUS_INVALID_DATE

STATUS_INVALID_INPUT

STATUS_INSUFFICIENT_CREDITS

STATUS_INVALID_PACKAGE

STATUS_NO_PERMISSIONS

Advanced

Advanced administrative operations. Use with extreme caution.

POST mysql_query Execute SQL Query

DANGER: Raw SQL Execution This endpoint executes raw SQL queries directly against the database. Incorrect queries can permanently corrupt or destroy data. Only use this if you fully understand the database schema and the consequences of your query. This endpoint is restricted to admin API keys only.

Execute a raw SQL query against the database. Returns the query result set for SELECT queries, or affected row count for INSERT/UPDATE/DELETE.

Parameter	Type	Required	Description
query	string	Required	The SQL query to execute

Request

curl -X POST "http://dns:port/access_code/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=mysql_query" \
  --data-urlencode "query=SELECT id, username, exp_date FROM lines WHERE member_id = 88 LIMIT 10"

Response

{
  "status": "STATUS_SUCCESS",
  "data": [
    {
      "id": 4521,
      "username": "customer1",
      "exp_date": "2026-12-31"
    },
    {
      "id": 4522,
      "username": "customer2",
      "exp_date": "2027-03-15"
    }
  ]
}

Xtream-Masters Admin API

Authentication

Base URL

Quick Start

Global Parameters

Warnings

What’s New

General

Line Management

MAG Device Management

MAG Claims

Enigma2 Device Management

Sub-Reseller Management

Streams & Content

Adding movies and series from a script

Configuration

Bouquets

Groups

Categories

Access Codes

EPG

Transcode Profiles

Security

IP Blocking

User-Agent Blocking

ASN Blocking

ISP Blocking

RTMP IP Management

Support Tickets

Activation Codes

Server Management

Logs & Monitoring

Response Format

Status Codes

Advanced