Documentation
Start for free
API reference

IP authentication

Add and remove IPv4 addresses that are authorized to use your active datacenter proxy subscription.

Add IP authentication

POST /api/v1.0/datacenter/whitelist/add

Adds an IPv4 address to the IP whitelist for your datacenter subscription.

The API assigns the address to the first free slot and applies it across the active proxy-gateway servers.

Rate limit4 requests / 60 seconds
RequiredX-API-Key header, ip JSON field
Endpoint details
AuthenticationSend your API key in the X-API-Key header. The apiKey JSON field is also accepted.
IPv4 onlyThe ip field must contain one valid IPv4 address. IPv6 is not supported.
Slot limitEach eligible account has four IP-whitelist slots.
Duplicate IPAn existing address returns HTTP 200 with success:false and is not added twice.
EligibilityThe account must be active and have a usable datacenter subscription with concurrency assigned.
Request · Python requests
import requests

response = requests.post(
    "https://rotatingproxyhub.com/api/v1.0/datacenter/whitelist/add",
    headers={"X-API-Key": "xxx"},
    json={"ip": "1.2.3.4"},
    timeout=30
)

print(response.json())
Example response
{
  "success": true,
  "message": "IP address: 1.2.3.4 - whitelisted successfully.",
  "ip": "1.2.3.4",
  "slot": "ip_slot_2",
  "max_allowed": 4,
  "replaced_ip": null,
  "account_id": "200",
  "servers": ["51.15.21.75"]
}

Remove IP authentication

POST /api/v1.0/datacenter/proxies/whitelist/delete

Removes an IPv4 address from the datacenter IP whitelist.

The API removes the address from the proxy-gateway servers and clears its matching database slot.

Rate limit4 requests / 60 seconds
RequiredX-API-Key header, ip JSON field
Endpoint details
AuthenticationSend your API key in the X-API-Key header. The apiKey JSON field is also accepted.
Exact matchThe ip field must exactly match an address currently stored in one of the four slots.
No matchA valid address that is not present returns HTTP 200 with success:false.
Safe updateThe stored slot is cleared only after the proxy-gateway update succeeds.
EligibilityThe account must be active and have a usable datacenter subscription with concurrency assigned.
Request · Python requests
import requests

response = requests.post(
    "https://rotatingproxyhub.com/api/v1.0/datacenter/proxies/whitelist/delete",
    headers={"X-API-Key": "xxx"},
    json={"ip": "1.2.3.4"},
    timeout=30
)

print(response.json())
Example response
{
  "success": true,
  "message": "IP address: 1.2.3.4 - removed from whitelist successfully.",
  "ip": "1.2.3.4",
  "slot": "ip_slot_2",
  "max_allowed": 4,
  "account_id": "200",
  "servers": ["51.15.21.75"]
}
Previous Subscription infoRead plan, status, expiry and usage values. Next Username & passwordConnect with assigned proxy credentials.