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 API Settings. 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

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/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/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/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/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/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"

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/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

Request

curl -X GET "http://dns:port/access/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=convert_mag" \
  -d "id=301"

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/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/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/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/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/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/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/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/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/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/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.

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

Request

curl -X POST "http://dns:port/access/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"

Response

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

POSTedit_userEdit Sub-Reseller

Edit a reseller account's properties.

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

Request

curl -X POST "http://dns:port/access/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.

Parameter	Type	Required	Description
id	int	Required	Reseller ID

Request

curl -X GET "http://dns:port/access/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

Request

curl -X GET "http://dns:port/access/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/admin/index.php?api_key=YOUR_KEY&action=get_episode&id=200"

POSTstart_streamStart Stream

Start a live stream.

Parameter	Type	Required	Description
id	int	Required	Stream ID

Request

curl -X POST "http://dns:port/access/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/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/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/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=stop_channel" \
  -d "id=5"

POSTstart_movieStart Movie

Start a movie stream.

Parameter	Type	Required	Description
id	int	Required	Movie ID

Request

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

POSTstop_movieStop Movie

Stop a movie stream.

Parameter	Type	Required	Description
id	int	Required	Movie ID

Request

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

Configuration

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

Bouquets

CRUD operations for bouquet management.

GETget_bouquetsList All Bouquets

Retrieve all bouquets.

Request

curl -X GET "http://dns:port/access/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=flush_blocked_ips"

User-Agent Blocking

Block specific User-Agent strings.

GETget_blocked_uasList Blocked UAs

Retrieve all blocked User-Agent strings.

Request

curl -X GET "http://dns:port/access/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
ua	string	Required	User-Agent string to block

Request

curl -X POST "http://dns:port/access/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=add_blocked_ua" \
  -d "ua=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/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_blocked_ua" \
  -d "id=5"

ISP Blocking

Block connections from specific ISPs.

GETget_blocked_ispsList Blocked ISPs

Retrieve all blocked ISPs.

Request

curl -X GET "http://dns:port/access/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/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/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/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/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/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/admin/index.php" \
  -d "api_key=YOUR_KEY" \
  -d "action=delete_rtmp_ip" \
  -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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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

General

Line Management

MAG Device Management

Enigma2 Device Management

Sub-Reseller Management

Streams & Content

Configuration

Bouquets

Groups

Categories

Access Codes

EPG

Transcode Profiles

Security

IP Blocking

User-Agent Blocking

ISP Blocking

RTMP IP Management

Server Management

Logs & Monitoring

Response Format

Status Codes

Advanced