Login
Sign Up

HighProxies API Documentation

Official developer guide for automating your proxy fleet management.

Authentication: All requests (except /health) must include the X-API-KEY header.
Base URL: https://api.highproxies.com

GET API Health

Check the operational status of the API, Database, and Cache systems.

/health 
{
  "status": "ok",
  "checks": {
    "database": "up",
    "redis": "up"
  }
}

GET List Proxies

Retrieve all proxies assigned to your account. Fields adjust based on your active auth_mode.

/proxies?status=1 
// Response Example (IP Authentication Mode)
{
  "total": 1,
  "proxies": [
    {
      "proxy_id": 727816,
      "service_id": 111104,
      "proxy_ip": "213.139.196.174",
      "proxy_port": 21281,
      "status_label": "active",
      "auth_mode": "ip_auth",
      "ip_auth1": "162.55.35.19",
      "ip_auth2": "0.0.0.0",
      "ip_auth3": "0.0.0.0",
      "additional_authorized_ips": []
    }
  ]
}

POST Global Auth Switch

Toggles the authentication method for ALL services on your account. Mixed modes are not supported.

/switch-auth
Note: Switching to ip_auth globally enables whitelisting and disables password access for all proxies. 
// Request Body
{
  "mode": "ip_auth" // or "user_pass"
}

// Response
{
  "status": "success",
  "new_global_mode": "ip_auth",
  "affected": 1
}

POST Update Authorized IPs

Whitelist up to 10 IP addresses for a specific service. Rate Limit: 2 updates per 60s.

/update-ips 
// Request Body
{
  "service_id": 111104,
  "ips": ["162.55.35.19", "8.8.8.8"]
}

GET Update History

View the last 10 successful IP authorization changes for audit purposes.

/history 
{
  "history": [
    {
      "service_id": 111104,
      "old_ips": "1.2.3.4",
      "new_ips": "162.55.35.19 8.8.8.8",
      "timestamp": "2025-12-29 12:00:00"
    }
  ]
}

Quick Start (Python)

import requests

url = "https://api.highproxies.com/proxies"
headers = {"X-API-KEY": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
print(response.json())