Service Endpoints

const url = new URL('https://panel.example.com/api/v1/admin/services');
url.searchParams.set('status', 'active');
url.searchParams.set('type', 'hosting');

const res  = await fetch(url, { headers: { Authorization: `Bearer ${apiKey}` } });
const body = await res.json();

$url = 'https://panel.example.com/api/v1/admin/services?' . http_build_query(['status' => 'active', 'type' => 'hosting']);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

// The pagination fields sit at the ROOT, not under 'meta'.
$page = 1;
$all  = [];

do {
    $response = Api::Services()->GetServices([], [
        'status' => 'active',
        'page'   => $page,
        'limit'  => 100,
    ]);

    $all  = array_merge($all, $response['data']);
    $page = $response['next_page'];
} while ($page > 0);

const res  = await fetch('https://panel.example.com/api/v1/admin/services/506', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();

// Read the capability before attempting the operation.
if (body.data.capabilities.can_reinstall) {
  // ...
}

$ch = curl_init('https://panel.example.com/api/v1/admin/services/506');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

$service = Api::Services()->GetService(['id' => 506])['data'];

// Capabilities come from the module: most are off on a service without one.
if ($service['capabilities']['can_suspend'] ?? false) {
    Api::Services()->SuspendService(['id' => 506]);
}

const res = await fetch('https://panel.example.com/api/v1/admin/services/506', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Mail Hosting Pro',
    amount: 29.9,
    qty: 2,
    auto_pay: true,
  }),
});

const body = await res.json();

$ch = curl_init('https://panel.example.com/api/v1/admin/services/506');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PATCH',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'name'   => 'Mail Hosting Pro',
        'amount' => 29.9,
        'qty'    => 2,
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

// An update that moves the term end also shifts add-ons falling on the same day.
$response = Api::Services()->UpdateService([
    'id'     => 506,
    'due_at' => '2026-08-18 12:00:00',
]);

const res = await fetch('https://panel.example.com/api/v1/admin/services/510', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ apply_on_module: true }),
});

const body = await res.json();

$ch = curl_init('https://panel.example.com/api/v1/admin/services/510');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['apply_on_module' => true]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

// Without the flag the account on the server STAYS UP and keeps consuming resources.
$response = Api::Services()->DeleteService([
    'id'              => 510,
    'apply_on_module' => true,
]);