API Docs & Developer Tools

Developer API

REST API v1 · Base URL: https://api.turboproxy.online

Your API Token

Pass this token as the X-API-KEY header on all requests.

USAGE EXAMPLE

curl https://api.turboproxy.online/api/balance \
  -H "X-API-KEY: your_api_key_here" \
  -H "Accept: application/json"

API Reference

Explore all available endpoints

API

Authentication

All Turbo Proxy API requests require the X-API-KEY header with your developer token. All responses return application/json.

BASE URL https://api.turboproxy.online

Required Headers

HTTP HEADERS

X-API-KEY: your_api_key_here
Content-Type: application/json
Accept: application/json

Rotate your API key periodically from the panel above. Old keys are immediately invalidated after rotation.

GET

List Services

Fetch all available proxy service types with their plans, pricing, and supported configurations.

GET /api/proxies/services

Response

JSON RESPONSE · 200 OK

[
  {
    "id": "static-residential-ipv4",
    "name": "Static Residential IPv4",
    "type": "residential",
    "basePrice": 3.00,
    "unit": "month"
  }
]

GET

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.

GET /api/proxies/setup/{serviceId}?planId=standard

Response

JSON RESPONSE · 200 OK

{
  "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]
  }
}

POST

Calculate Price

Calculate the final cost of a proxy before purchasing, including any applicable markups.

POST /api/proxies/price

Request 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

JSON RESPONSE · 200 OK

{
  "price": 6.00,
  "currency": "USD"
}

POST

Order Proxy

Purchase a proxy. Deducts balance and returns the proxy credentials immediately.

POST /api/proxies/order

Request 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

JSON RESPONSE · 200 OK

{
  "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"
    }
  ]
}

GET

Active Proxies

Retrieve all currently active proxies with their connection credentials and expiry dates.

GET /api/proxies/active

Response

JSON RESPONSE · 200 OK

[
  {
    "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"
  }
]

GET

Exact Proxy

Retrieve the connection credentials and detailed parameters of a specific individual proxy by its ID.

GET /api/proxies/exact/{id}

Response

JSON RESPONSE · 200 OK

{
  "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"
}

POST

Change Protocol

Switch the proxy connection protocol between HTTP and SOCKS5.

POST /api/proxies/protocols/{id}

Required Headers

HTTP HEADERS

X-API-KEY: your_api_key_here
Content-Type: application/json
Accept: application/json

Request Body

JSON REQUEST BODY

{
  "type": "SOCKS5" // HTTP or SOCKS5
}

Response

JSON RESPONSE · 200 OK

{
  "success": true,
  "message": "Protocol updated successfully!"
}

POST

Change Auth Type

Switch the authentication type between Username/Password and IP Whitelist.

POST /api/proxies/auth-types/{id}

Required Headers

HTTP HEADERS

X-API-KEY: your_api_key_here
Content-Type: application/json
Accept: application/json

Request Body

JSON REQUEST BODY

{
  "newAuthType": "IP_WHITELIST", // USERNAME_PASSWORD or IP_WHITELIST
  "ips": ["192.168.1.1"] // Required if IP_WHITELIST, array of strings
}

Response

JSON RESPONSE · 200 OK

{
  "success": true,
  "message": "Authentication method updated successfully!"
}

Developer API

Your API Token

API Reference

Authentication

Required Headers

Get Balance

Response

List Services

Response

Get Service Setup

Response

Calculate Price

Request Body

Response

Order Proxy

Request Body

Response

Active Proxies

Response

Exact Proxy

Response

Change Protocol

Required Headers

Request Body

Response

Change Auth Type

Required Headers

Request Body

Response