Automate
everything.

All API requests require authentication via the X-Reseller-Key header. Same key as the server APIs.

X-Reseller-Key: your_api_key_here

https://servury.com/api/proxy.php

All endpoints return JSON. Successful responses:

{"success": true, "data": {...}}

Error responses:

{"success": false, "error": "message"}

Get reseller account info (balance, discount, payment method).

Example Response

{
    "success": true,
    "data": {
        "balance": 42.50,
        "discount_percent": 33.3,
        "payment_method": "account_balance",
        "has_saved_card": false
    }
}

Get datacenter proxy stock by country and IP type. Check this before ordering.

Example Response

{
    "success": true,
    "data": {
        "stock": {
            "ipv4": {"us": 150, "ca": 80, "fr": 45, "uk": 60, "nl": 30},
            "ipv6": {"us": 500, "ca": 200}
        }
    }
}

Calculate price for any proxy type before ordering. Returns your reseller price.

List all proxies (datacenter, residential, and rotating) with credentials.

Get detailed info for a single proxy including credentials and whitelisted IPs.

Residential proxies report bandwidth both in MB and in GB (bandwidth_used_gb, bandwidth_total_gb, bandwidth_remaining_gb). 1 GB is 1000 MB and the GB values are rounded to two decimals, matching the panel; whole numbers are sent without a fractional part (10, not 10.0). The same GB fields appear on residential entries of ?action=proxies.

Example Response (residential)

{
    "success": true,
    "data": {
        "proxy": {
            "id": "abc12345",
            "type": "residential",
            "username": "user123",
            "password": "pass456",
            "bandwidth_total_mb": 10000,
            "bandwidth_remaining_mb": 7350,
            "bandwidth_used_gb": 2.65,
            "bandwidth_total_gb": 10,
            "bandwidth_remaining_gb": 7.35,
            "status": "active",
            "created_at": 1714000000
        }
    }
}

Bandwidth usage time series for a residential proxy, the same data the residential panel graph is drawn from. Remaining bandwidth is snapshotted hourly; each point is the drop in remaining bandwidth since the previous snapshot, floored at zero, so a top-up never shows as negative usage. Only residential proxies have usage data; other types return a 400 error.

unit is always mb. interval_seconds is the typical spacing between points. total_mb is the sum of all points in the window and bandwidth_remaining_mb is the current remaining balance. used_mb and total_mb are numbers rounded to two decimals; whole numbers are sent without a fractional part. time values are Unix seconds, UTC. points is empty until at least two snapshots exist in the window.

Example Request

curl -H "X-Reseller-Key: your_api_key_here" \
  "https://servury.com/api/proxy.php?action=usage&id=abc12345&timeframe=24hr"

Example Response

{
    "success": true,
    "data": {
        "proxy_id": "abc12345",
        "timeframe": "24hr",
        "unit": "mb",
        "interval_seconds": 3600,
        "points": [
            {"time": 1714000000, "used_mb": 120},
            {"time": 1714003600, "used_mb": 0},
            {"time": 1714007200, "used_mb": 85}
        ],
        "total_mb": 205,
        "bandwidth_remaining_mb": 7350
    }
}

Order datacenter proxies. Returns proxy credentials immediately.

Example Response

{
    "success": true,
    "data": {
        "message": "1 datacenter proxy created.",
        "proxies": [{
            "id": "abc12345",
            "ip": "185.123.45.67",
            "port_http": 8080,
            "port_socks5": 1080,
            "username": "user123",
            "password": "pass456",
            "expiration_date": 1714000000
        }],
        "amount_charged": 2.50
    }
}

Order a residential proxy subscription with bandwidth.

Order a rotating IPv6 proxy.

Renew a datacenter or rotating proxy. Not applicable to residential (use topup instead).

Add bandwidth to a residential proxy.

Reset proxy username/password. Works for all proxy types. Returns new credentials.

Add an IP to the proxy whitelist (datacenter and rotating only).

Remove an IP from the proxy whitelist.

Permanently delete a proxy (no refund).

All errors return JSON with success: false and an error message.

401 Unauthorized

{"success": false, "error": "Invalid or inactive API key."}

404 Not Found

{"success": false, "error": "Proxy not found."}

400 Bad Request

{"success": false, "error": "Out of stock for US (IPv4)"}

<?php
$apiKey = "your_api_key_here";
$baseUrl = "https://servury.com/api/proxy.php";

function apiRequest($endpoint, $apiKey, $method = 'GET', $data = null) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $endpoint);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "X-Reseller-Key: $apiKey",
        "Content-Type: application/json"
    ]);

    if ($method === 'POST') {
        curl_setopt($ch, CURLOPT_POST, true);
        if ($data) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
        }
    }

    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// Check stock before ordering
$stock = apiRequest("$baseUrl?action=stock", $apiKey);

// Get price quote
$price = apiRequest("$baseUrl?action=price&type=datacenter&days=30&quantity=5", $apiKey);
echo "5 proxies for 30 days: $" . $price['data']['total'];

// Order 5 datacenter proxies
$order = apiRequest("$baseUrl?action=create_datacenter", $apiKey, 'POST', [
    'country' => 'US',
    'days' => 30,
    'quantity' => 5,
    'ip_type' => 'ipv4'
]);

// List all proxies with credentials
$proxies = apiRequest("$baseUrl?action=proxies", $apiKey);
foreach ($proxies['data']['proxies'] as $p) {
    echo "{$p['ip']}:{$p['port_http']} ({$p['type']})\n";
}

// Renew a datacenter proxy
$result = apiRequest("$baseUrl?action=renew&id=abc12345", $apiKey, 'POST', [
    'days' => 30
]);

// Top up residential bandwidth
$result = apiRequest("$baseUrl?action=topup&id=xyz98765", $apiKey, 'POST', [
    'bandwidth' => 10
]);