Datacenter Proxy Subscription API
Subscription Info
Returns the current datacenter plan values stored on the authenticated user account.
The response includes the plan name, expiration, subscription status, billing period, static proxy amount, next static refresh, product type, concurrency, and additional-IP setting.
Rate
Maximum 10 requests every 60 seconds
Note
Send the customer key as the case-sensitive apiKey query parameter. X-API-Key is accepted as an alternative header.
Successful responses include Cache-Control: no-store.
Required parameters
apiKey
Endpoint details
Access requirements
Account status
The user account must have status ACTIVE.
Subscription type
The current plan type must be Datacenter.
Subscription status
Both active and canceled datacenter subscriptions are accepted while they remain usable.
Concurrency
The current plan must have a concurrency value greater than zero.
Response fields
name, expiration, sub_status
Returned as strings. Missing values become empty strings.
billing_period, next_static_refresh, type
Returned as strings. next_static_refresh maps directly from plan.next_refresh.
static_proxies, concurrency
Returned as non-negative integers. Missing, invalid, or negative values fall back to 0.
additional_ips
Returned as a boolean after normalizing boolean-like stored values.
Possible API responses
400 Bad Request
The apiKey query parameter and X-API-Key header are both missing.
401 Unauthorized
The supplied customer API key does not match a user.
403 Forbidden
The account is inactive, the plan is not Datacenter, the subscription is unusable, or no concurrency is assigned.
429 Too Many Requests
More than ten requests were made within 60 seconds. Use the Retry-After response header.
500 Internal Server Error
The user ID, database operation, or endpoint processing failed.
Python • requests
import json
import requests
endpoint = "https://proxytitan.com/api/v1.0/datacenter/subscription-info"
api_key = "xxx"
response = requests.get(
endpoint,
params={"apiKey": api_key},
timeout=30
)
print("Status:", response.status_code)
print(
json.dumps(
response.json(),
indent=2
)
)
Replace xxx with your customer API key. Send it in the query string or the X-API-Key header. Do not send a GET request body.
Response (JSON)
Show example response
Click to reveal the JSON structure.
Example values are illustrative. Every field is read from the authenticated user’s current plan.
Proxy Usage
Returns the usage values currently stored under proxy_usage.usage_data for the authenticated account.
The endpoint exposes stored bandwidth usage, current thread usage, and the total request count.
Rate
Maximum 10 requests every 60 seconds
Note
Send the customer key as the case-sensitive apiKey query parameter. X-API-Key is accepted as an alternative header.
Successful responses include Cache-Control: no-store.
The endpoint does not convert bandwidth units or define a refresh interval. bandwidth_usage is returned from the stored used_bandwidth value.
Required parameters
apiKey
Endpoint details
Access requirements
Account status
The user account must have status ACTIVE.
Subscription type
The current plan type must be Datacenter.
Subscription status
Both active and canceled datacenter subscriptions are accepted while they remain usable.
Concurrency
The current plan must have a concurrency value greater than zero.
Response fields
bandwidth_usage
Returned directly from proxy_usage.usage_data.used_bandwidth. If the field is missing, the response uses 0. Its exact unit and stored JSON type depend on the producer that writes the usage document.
current_threads
Maps from proxy_usage.usage_data.concurrency and is normalized to a non-negative integer.
total_requests
Maps from proxy_usage.usage_data.requests_made and is normalized to a non-negative integer.
Possible API responses
400 Bad Request
The apiKey query parameter and X-API-Key header are both missing.
401 Unauthorized
The supplied customer API key does not match a user.
403 Forbidden
The account is inactive, the plan is not Datacenter, the subscription is unusable, or no concurrency is assigned.
429 Too Many Requests
More than ten requests were made within 60 seconds. Use the Retry-After response header.
500 Internal Server Error
The user ID, database operation, or endpoint processing failed.
Python • requests
import json
import requests
endpoint = "https://proxytitan.com/api/v1.0/datacenter/usage"
api_key = "xxx"
response = requests.get(
endpoint,
params={"apiKey": api_key},
timeout=30
)
print("Status:", response.status_code)
print(
json.dumps(
response.json(),
indent=2
)
)
Replace xxx with your customer API key. Send it in the query string or the X-API-Key header. Do not send a GET request body.
Response (JSON)
Show example response
Click to reveal the JSON structure.
The sample numbers are illustrative. Missing thread and request counters are returned as 0.