API documentation

programmatic access to DRT Mobile Proxy services. generate your API key from the client dashboard or shop dashboard.

base URL

https://singaporemobileproxy.com/api/v1/

authentication

all API requests require an API key in the x-api-key header.

curl -H "x-api-key: YOUR_API_KEY" https://singaporemobileproxy.com/api/v1/proxies/my
GET /api/v1/proxies/my

list your active proxies

curl -H "x-api-key: YOUR_API_KEY" \
     https://singaporemobileproxy.com/api/v1/proxies/my
example response 
{
  "proxyList": [
    {
      "uuid": "db4474ea-...",
      "license_status": "ACTIVE",
      "package_name": "300GB Singapore",
      "host_domain": "singaporemobileproxy.com",
      "http_port": 8101,
      "socket_port": 5101,
      "start_date": "2026-03-01T00:00:00Z",
      "expired_date": "2026-04-01T00:00:00Z",
      "m_type": "PROXYSMART",
      "status": "CONNECTED",
      "rotation_link": "https://...",
      "min_time_change_ip": 5,
      "authentication_user": "proxy_abc123:password123",
      "authorization_ips": "",
      "dl_bytes": "0",
      "bandwidth_limit_gb": 300,
      "bandwidth_used_gb": 45.2,
      "auto_extend": false
    }
  ]
}
GET /api/v1/proxies

list available plans and locations

curl -H "x-api-key: YOUR_API_KEY" \
     https://singaporemobileproxy.com/api/v1/proxies
example response 
{
  "proxies": [
    {
      "country": "Singapore",
      "city": "Singapore",
      "isp": "Mobile",
      "type": "PROXYSMART",
      "proxy_count": 10,
      "plans": [
        {"bandwidth_gb": 200, "price_usd": 40, "planType": "MONTH"},
        {"bandwidth_gb": 300, "price_usd": 50, "planType": "MONTH"}
      ]
    }
  ]
}
GET /api/v1/account/balance

get credit balance and recent transactions

curl -H "x-api-key: YOUR_API_KEY" \
     https://singaporemobileproxy.com/api/v1/account/balance
example response 
{
  "credits": 15.00,
  "transactions": [
    {
      "id": "...",
      "amount": 15.00,
      "balance_after": 15.00,
      "type": "promotion",
      "description": "welcome bonus",
      "created_at": "2026-03-20T10:00:00Z"
    }
  ]
}
POST /api/v1/proxy/purchase

purchase a new proxy. credits applied first, remainder charged to saved card.

parameters: country (required), city (required), isp (required), planType (required: DAY/WEEK/MONTH), quantity (optional, default 1), username (optional, format user:pass), ipAddress (optional, IP whitelist), couponCode (optional)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{...}' \
     https://singaporemobileproxy.com/api/v1/proxy/purchase
example response 
{
  "message": "Success",
  "proxies": [
    {
      "license_uuid": "221215fb-...",
      "package_name": "300GB Singapore",
      "start_date": "2026-03-26T10:00:00Z",
      "expired_date": "2026-04-26T10:00:00Z",
      "format_http": "host:8101:user:pass",
      "format_sock": "host:5101:user:pass",
      "link_change_ip": "https://..."
    }
  ]
}
POST /api/v1/license/extendproxy

extend/renew a proxy license

parameters: uuid (required), time_unit (required: DAY/WEEK/MONTH)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{...}' \
     https://singaporemobileproxy.com/api/v1/license/extendproxy
example response 
{
  "message": "Success",
  "balance": 15.00,
  "proxy": {
    "modem_name": "300GB Singapore",
    "host_domain": "...",
    "http_port": 8101,
    "socket_port": 5101,
    "status": "ACTIVE",
    "uuid": "221215fb-..."
  }
}
POST /api/v1/license/autoextend

toggle auto-renew (default off)

parameters: uuid (required), auto_extend (required: true/false)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{...}' \
     https://singaporemobileproxy.com/api/v1/license/autoextend
example response 
{"message": "Auto-extend updated successfully."}
POST /api/v1/proxy/change-ip

rotate IP address (5 min cooldown per proxy)

parameters: uuid (required)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{...}' \
     https://singaporemobileproxy.com/api/v1/proxy/change-ip
example response 
{"message": "Success"}
POST /api/v1/proxy/reboot

reboot the modem (5 min cooldown)

parameters: uuid (required)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{...}' \
     https://singaporemobileproxy.com/api/v1/proxy/reboot
example response 
{"message": "Reboot Device Success."}
POST /api/v1/proxy/update-authentication

change proxy auth method. provide one: userName or ipAddress.

parameters: uuid (required), userName (optional, format user:pass), ipAddress (optional, comma-separated IPs)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{...}' \
     https://singaporemobileproxy.com/api/v1/proxy/update-authentication
example response 
{"message": "Success"}
POST /api/v1/proxy/update-os

set OS spoofing on the proxy

parameters: uuid (required), osType (required, e.g. windows:4)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{...}' \
     https://singaporemobileproxy.com/api/v1/proxy/update-os
example response 
{"message": "Success"}
POST /api/v1/license/update-rotation-time

set auto-rotation interval (minimum 5 minutes)

parameters: uuid (required), minute (required, integer >= 5)

curl -X POST -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{...}' \
     https://singaporemobileproxy.com/api/v1/license/update-rotation-time
example response 
{"message": "Success"}

error responses

all errors return JSON: {"message": "error description"}

  • 401 -- invalid or missing API key
  • 400 -- bad request (missing/invalid parameters)
  • 402 -- payment required (insufficient credits, no card on file)
  • 403 -- not authorized for this proxy
  • 404 -- proxy/license not found
  • 429 -- rate limited (60 req/min, 5 purchases/hr, 5 min rotation/reboot cooldown)

OS spoof options

Android: android:1, android:3, android:4
iOS: ios:1, ios:2, ios:3
macOS: macosx:3, macosx:4, macosx:5
Windows: windows:1, windows:4

notes

  • all POST endpoints accept both application/json and application/x-www-form-urlencoded
  • credits are automatically applied to purchases. remaining balance is charged to your saved card.
  • auto-extend is off by default for new subscriptions
  • the GET version of /proxy/change-ip?license=UUID also works for rotation link compatibility