Integrate Turbo Proxy API
Automate your proxy deployment, calculate costs, check balances, and retrieve active credentials programmatically.
Authentication & API Keys
To authenticate your API requests, you will need an API Key. Register or log in to your account, deposit funds, and navigate to the developer panel to copy/rotate your token.
API Reference
Explore and test all available endpoints
Authentication
All Turbo Proxy API requests require the X-API-KEY header with your developer token. All responses return application/json.
https://api.turboproxy.onlineRequired Headers
X-API-KEY: your_api_key_here
Content-Type: application/json
Accept: application/jsonGet Balance
Returns the current wallet balance for the authenticated account.
/api/balanceResponse
{
"balance": 24.50,
"currency": "USD"
}List Services
Fetch all available proxy service types with their plans, pricing, and supported configurations.
/api/proxies/servicesResponse
[
{
"id": "static-residential-ipv4",
"name": "Static Residential IPv4",
"type": "residential",
"basePrice": 3.00,
"unit": "month"
}
]Get Service Setup
Retrieve the available configuration options for a specific service, including the list of supported ISO country codes, cities, ISPs, and available rental durations.
/api/proxies/setup/{serviceId}?planId=standardResponse
{
"countries": {
"US": "United States",
"GB": "United Kingdom"
},
"isps": {
"US": [
{
"id": "eyJpdiI6IkpUamZ...",
"label": "Interwrx"
}
]
},
"cities": {
"US": [
{
"id": "New York",
"label": "New York",
"isps": ["eyJpdiI6IkpUamZ..."]
}
]
},
"periods": {
"months": [1, 2, 3]
}
}Calculate Price
Calculate the final cost of a proxy before purchasing, including any applicable VIP discount percentage.
/api/proxies/priceRequest Body
| Parameter | Type | Required | Description |
|---|---|---|---|
serviceId | string | Required | Service ID (e.g. static-residential-ipv4) |
planId | string | Required | Plan ID from services list |
quantity | integer | Required | Number of proxies. Default: 1 |
periodValue | integer | Required | Duration. Default: 1 |
periodUnit | string | Required | months or days |
country | string | Required | ISO code e.g. US |
city | string | Optional | Target City / Region ID |
isp | string | Optional | Target ISP ID |
Response
{
"price": 6.00,
"currency": "USD"
}Order Proxy
Purchase a proxy. Deducts balance and returns the proxy credentials immediately.
/api/proxies/orderRequest Body
| Parameter | Type | Required | Description |
|---|---|---|---|
serviceId | string | Required | Service ID (e.g. static-residential-ipv4) |
planId | string | Required | Plan ID from services list |
quantity | integer | Required | Number of proxies. Default: 1 |
periodValue | integer | Required | Duration. Default: 1 |
periodUnit | string | Required | months or days |
country | string | Required | ISO code e.g. US |
city | string | Optional | Target City / Region ID |
isp | string | Optional | Target ISP ID |
Response
{
"success": true,
"order_id": "019e6054-dbf6-701c-a58c-eef3e50096cc",
"total_price": 6.00,
"proxies": [
{
"host": "185.130.104.12",
"port": 3128,
"username": "user123",
"password": "pwd",
"type": "http"
}
]
}Exact Proxy
Retrieve the connection credentials and detailed parameters of a specific individual proxy by its ID.
/api/proxies/exact/{id}Response
{
"id": 12,
"external_id": "019e6054-dbf6-701c-a58c-eef3e50096cc",
"service": "static-residential-ipv4",
"country": "US",
"price": "6.00",
"status": "active",
"host": "185.130.104.12",
"port": 3128,
"username": "user123",
"password": "pwd",
"type": "http",
"expires_at": "2026-06-26T18:45:56.000Z"
}Active Proxies
Retrieve all currently active proxies with their connection credentials and expiry dates.
/api/proxies/activeResponse
[
{
"id": 12,
"external_id": "019e6054-dbf6-701c-a58c-eef3e50096cc",
"service": "static-residential-ipv4",
"country": "US",
"price": "6.00",
"status": "active",
"host": "185.130.104.12",
"port": 3128,
"username": "user123",
"password": "pwd",
"type": "http",
"expires_at": "2026-06-26T18:45:56.000Z"
}
]Change Protocol
Switch the proxy connection protocol between HTTP and SOCKS5.
/api/proxies/protocols/{id}Required Headers
X-API-KEY: your_api_key_here
Content-Type: application/json
Accept: application/jsonRequest Body
{
"type": "SOCKS5" // HTTP or SOCKS5
}Response
{
"success": true,
"message": "Protocol updated successfully!"
}Change Auth Type
Switch the authentication type between Username/Password and IP Whitelist.
/api/proxies/auth-types/{id}Required Headers
X-API-KEY: your_api_key_here
Content-Type: application/json
Accept: application/jsonRequest Body
{
"newAuthType": "IP_WHITELIST", // USERNAME_PASSWORD or IP_WHITELIST
"ips": ["192.168.1.1"] // Required if IP_WHITELIST, array of strings
}Response
{
"success": true,
"message": "Authentication method updated successfully!"
}