API Reference

Authorization: Bearer YOUR_API_TOKEN

https://nodeproxies.xyz/api

curl https://nodeproxies.xyz/api/balance \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "balance": 24.50
}

curl https://nodeproxies.xyz/api/plans \
  -H "Authorization: Bearer YOUR_API_TOKEN"

[
  {
    "id": "uuid",
    "plan_type": "residential",
    "amount_gb": 10,
    "used_gb": 1.23,
    "status": "active",
    "expires_at": "2026-05-08T00:00:00Z",
    "created_at": "2026-04-08T12:00:00Z"
  }
]

curl https://nodeproxies.xyz/api/plans/PLAN_UUID \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "plan_id": "uuid",
  "username": "user_abc123",
  "password": "pass_xyz789",
  "plan_type": "residential",
  "max_bytes": 10737418240,
  "used_bytes": 1320000000,
  "enabled": true,
  "active": true,
  "last_used": "2026-04-08T10:30:00Z"
}

curl -X POST https://nodeproxies.xyz/api/plans/purchase \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_type": "residential",
    "amount": 10,
    "unit": "GB",
    "promocode": "WELCOME10"
  }'

curl -X POST https://nodeproxies.xyz/api/plans/purchase \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_type": "unlimited_residential",
    "time_hours": 24,
    "timeUnit": "daily"
  }'

{
  "success": true,
  "plan": {
    "id": "uuid",
    "plan_id": "PLAN_SHORT_ID",
    "username": "proxy_user_123",
    "password": "proxy_password_abc",
    "plan_type": "residential",
    "amount_gb": 10,
    "amount_mb": 0,
    "time_hours": 0,
    "status": "active",
    "enabled": true,
    "active": true,
    "created_at": "2026-07-01T17:00:00Z"
  },
  "charged": 18.00,
  "subtotal": 20.00,
  "discount": 2.00,
  "new_balance": 32.00
}

curl -X POST https://nodeproxies.xyz/api/plans/update \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "PLAN_UUID_HERE",
    "update_type": "bandwidth",
    "add_amount": 5
  }'

curl -X POST https://nodeproxies.xyz/api/plans/update \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "PLAN_UUID_HERE",
    "update_type": "time",
    "add_amount": 72
  }'

{
  "success": true,
  "message": "Plan updated successfully",
  "charged": 2.50,
  "new_balance": 47.50,
  "updated_field": "amount_gb",
  "new_value": 15
}

curl -X POST https://nodeproxies.xyz/api/plans/reset-password \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "PLAN_ID_HERE",
    "new_password": "MyCustomSecretPass123"
  }'

{
  "success": true,
  "newPassword": "MyCustomSecretPass123"
}

curl "https://nodeproxies.xyz/api/transactions?limit=10&type=topup" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "transactions": [
    {
      "id": "uuid",
      "type": "topup",
      "amount": 10.00,
      "status": "completed",
      "description": "Balance top-up via Stripe",
      "created_at": "2026-04-08T12:00:00Z"
    }
  ],
  "total": 42
}

curl https://nodeproxies.xyz/api/countries \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "residential": ["us", "gb", "de", "fr", ...],
  "datacenter":  ["us", "gb", "de", ...],
  "mobile":      ["us", "gb", ...],
  "unlimited":   ["us", "gb", ...]
}

curl -X POST https://nodeproxies.xyz/api/payments \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount": 20, "method": "stripe"}'

{
  "url": "https://checkout.stripe.com/...",
  "sessionId": "cs_live_..."
}

{
  "url": "https://pay.cryptomus.com/...",
  "orderId": "uuid"
}

curl https://nodeproxies.xyz/api/isp/packages \
  -H "Authorization: Bearer YOUR_API_TOKEN"

[
  {
    "id": "4d616e76-5594-4876-8af0-35f464cc5b6d",
    "package_name": "US Ashburn Dedicated ISP",
    "country": "US Ashburn",
    "monthlyPrice": 1.59,
    "in_stock": 142
  }
]

curl -X POST https://nodeproxies.xyz/api/isp/purchase \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "package_id": "4d616e76-5594-4876-8af0-35f464cc5b6d",
    "expiry_days": 30,
    "quantity": 1,
    "socks": true
  }'

{
  "success": true,
  "plan": {
    "id": "isp_1787495435349_z6r9k",
    "plan_type": "isp",
    "country_code": "US Ashburn",
    "proxy_list": ["192.168.1.1:8080:user:pass"],
    "expires_at": "2026-09-23T12:00:00Z"
  },
  "totalCost": 1.59,
  "newBalance": 3298.41
}

curl -X POST https://nodeproxies.xyz/api/isp/renew \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "isp_1787495435349_z6r9k",
    "expiry_days": 30
  }'

{
  "success": true,
  "expiresAt": "2026-10-23T12:00:00Z",
  "newBalance": 3296.82
}

curl -X PATCH https://nodeproxies.xyz/api/isp/rotate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "plan_id": "isp_1787495435349_z6r9k" }'

{
  "success": true,
  "message": "Subnet IP rotated successfully",
  "plan": {
    "id": "isp_1787495435349_z6r9k",
    "proxy_list": ["198.51.100.42:8080:user:pass"]
  }
}

curl -X PATCH https://nodeproxies.xyz/api/isp/whitelist \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "isp_1787495435349_z6r9k",
    "ips_allowed": ["198.51.100.10", "203.0.113.5"]
  }'

{
  "success": true,
  "plan": {
    "id": "isp_1787495435349_z6r9k",
    "whitelisted_ips": ["198.51.100.10", "203.0.113.5"]
  }
}

{
  "error": "This dedicated ISP proxy was created in User/Pass authentication mode. Upstream ISP proxies lock authentication mode at creation time. To use IP authentication, enter allowed IPs during initial purchase."
}

curl -x "http://USERNAME:[email protected]:8080" "https://httpbin.org/ip"

import requests

proxies = {
    "http":  "http://USERNAME:[email protected]:8080",
    "https": "http://USERNAME:[email protected]:8080",
}
r = requests.get("https://httpbin.org/ip", proxies=proxies)
print(r.json())

# US exit IP
curl -x "http://USERNAME-country-us:[email protected]:8080" https://httpbin.org/ip

# Germany, mobile
curl -x "http://USERNAME-country-de-type-mobile:[email protected]:8080" https://httpbin.org/ip

# Same exit IP for all requests with session-order123
curl -x "http://USERNAME-session-order123:[email protected]:8080" https://httpbin.org/ip

# Combine with country
curl -x "http://USERNAME-country-us-session-order123:[email protected]:8080" https://httpbin.org/ip

{ "error": "Invalid token" }