Datacenter Proxy IP Authentication API

IP Whitelist Info
GET /api/v1.0/datacenter/whitelist/info

Returns the current IP-authentication configuration for your datacenter subscription.

The response includes the nftables set name, HTTP and SOCKS5 ports, all five IP slots, and the number of occupied slots.

The API key must belong to an ACTIVE user with a Datacenter plan whose subscription status is active or canceled.

Rate
10 requests per 60 seconds
Note
Examples use apiKey in the query string. The backend also accepts X-API-Key as a request header.
Empty whitelist slots are returned as empty strings.
Required authentication
apiKey X-API-Key - header alternative
Endpoint details
Response fields
success - boolean message - string whitelisted_amount - integer data.ip_set_name - string data.http_port - string data.socks5_port - string data.ip_slot_1 … data.ip_slot_5 - strings
Possible non-success and error responses
400 - API key is missing 401 - API key is invalid 403 - account is inactive or no usable datacenter subscription exists 403 - datacenter plan has no concurrency assigned 429 - request rate limit exceeded 500 - database, proxy server, or unexpected server error
Python • requests • apiKey query parameter 
import json
import requests


def get_whitelist_info(api_key: str) -> dict:
    url = "https://proxytitan.com/api/v1.0/datacenter/whitelist/info"
    params = {"apiKey": api_key}

    response = requests.get(url, params=params, timeout=30)
    data = response.json()

    print("HTTP status:", response.status_code)
    print(json.dumps(data, indent=2))

    response.raise_for_status()
    return data


get_whitelist_info("xxx")
Replace xxx with your API key.
Response • 200 OK • application/json
Show example response
Click to reveal the exact successful JSON structure.
The copied response is valid JSON without an added status label.
Add IP to Whitelist
POST /api/v1.0/datacenter/whitelist/add

Adds an IPv4 address to the datacenter proxy whitelist.

Without additional IP authentication, the plan allows one slot. Adding another IP replaces ip_slot_1 and returns the replaced address in replaced_ip.

With additional IP authentication, the plan allows five slots. The first empty slot is used, and the request fails when all five slots are occupied.

Rate
4 requests per 60 seconds
Note
The JSON body may use apiKey or x-api-key. Examples use apiKey.
The backend also accepts X-API-Key as a request header.
Required JSON body fields
apiKey - JSON body - required ip - JSON body - required IPv4 address X-API-Key - header alternative for apiKey
Endpoint details
Response fields
success - boolean message - string ip - normalized IPv4 string slot - ip_slot_1 … ip_slot_5 max_allowed - 1 or 5 replaced_ip - previous IPv4 string or null
Possible non-success and error responses
200 with success:false - IP is already whitelisted 400 - API key or IP is missing 400 - invalid IP or IPv6 address 400 - no free slot is available on a five-slot plan 401 - API key is invalid 403 - account is inactive or no usable datacenter subscription exists 403 - datacenter plan has no concurrency assigned 429 - request rate limit exceeded 500 - database, proxy server, or unexpected server error
Python • requests • JSON body 
import json
import requests


def add_ip_to_whitelist(api_key: str, ip: str) -> dict:
    url = "https://proxytitan.com/api/v1.0/datacenter/whitelist/add"
    payload = {
        "apiKey": api_key,
        "ip": ip
    }

    response = requests.post(url, json=payload, timeout=30)
    data = response.json()

    print("Add IP HTTP status:", response.status_code)
    print(json.dumps(data, indent=2))

    response.raise_for_status()
    return data


add_ip_to_whitelist("xxx", "1.2.3.4")
Replace xxx with your API key. Replace 1.2.3.4 with the IPv4 address you want to add or remove.
Response • 200 OK • application/json
Show example response
Click to reveal the exact successful JSON structure.
The copied response is valid JSON without an added status label.
Remove IP from Whitelist
POST /api/v1.0/datacenter/proxies/whitelist/delete

Removes an existing IPv4 address from the datacenter proxy whitelist.

The backend locates the matching slot, removes the address from nftables, and then clears that exact MongoDB slot.

When the supplied IP is valid but is not currently whitelisted, the endpoint returns HTTP 200 with success:false.

Rate
4 requests per 60 seconds
Note
The JSON body may use apiKey or x-api-key. Examples use apiKey.
The backend also accepts X-API-Key as a request header.
Required JSON body fields
apiKey - JSON body - required ip - JSON body - required IPv4 address X-API-Key - header alternative for apiKey
Endpoint details
Response fields
success - boolean message - string ip - normalized IPv4 string slot - cleared ip_slot_1 … ip_slot_5
Possible non-success and error responses
200 with success:false - IP is not present in the whitelist 400 - API key or IP is missing 400 - invalid IP or IPv6 address 401 - API key is invalid 403 - account is inactive or no usable datacenter subscription exists 403 - datacenter plan has no concurrency assigned 429 - request rate limit exceeded 500 - database, proxy server, or unexpected server error
Python • requests • JSON body 
import json
import requests


def remove_ip_from_whitelist(api_key: str, ip: str) -> dict:
    url = "https://proxytitan.com/api/v1.0/datacenter/proxies/whitelist/delete"
    payload = {
        "apiKey": api_key,
        "ip": ip
    }

    response = requests.post(url, json=payload, timeout=30)
    data = response.json()

    print("Remove IP HTTP status:", response.status_code)
    print(json.dumps(data, indent=2))

    response.raise_for_status()
    return data


remove_ip_from_whitelist("xxx", "1.2.3.4")
Replace xxx with your API key. Replace 1.2.3.4 with the IPv4 address you want to add or remove.
Response • 200 OK • application/json
Show example response
Click to reveal the exact successful JSON structure.
The copied response is valid JSON without an added status label.