Skip to main content
POST
/
api
/
v2
/
order
/
exchange
/
{order_id}
Exchange Proxies
curl --request POST \
  --url https://dashboard.statproxies.com/api/v2/order/exchange/{order_id}
{
  "response": "<string>",
  "message": "<string>",
  "details": {},
  "details.order_id": "<string>",
  "details.previous_count": 123,
  "details.new_count": 123,
  "details.requested_count": 123,
  "details.overlapping_ips": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.statproxies.com/llms.txt

Use this file to discover all available pages before exploring further.

Exchange all proxies in an order for new IP addresses. This endpoint removes all current IPs and assigns fresh ones from the available pool.
This feature requires the proxy_exchange feature to be enabled for your organization. Contact support if you need access to this feature.

​
Request

​
Headers

HeaderValueRequired
AuthorizationBearer {your_api_key}Yes

​
Path Parameters

​
order_id
string
required
The order ID for which to exchange proxies.

​
Example Request

curl -X POST "https://dashboard.statproxies.com/api/v2/order/exchange/sub_1rqjp3jb4g9i6pkhdwmkpjob" \
  -H "Authorization: Bearer {your_api_key}"

​
Response

​
Success Response

{
  "response": "success",
  "message": "Proxies exchanged successfully",
  "details": {
    "order_id": "sub_1rqjp3jb4g9i6pkhdwmkpjob",
    "previous_count": 10,
    "new_count": 10,
    "requested_count": 10,
    "overlapping_ips": 0
  }
}

​
Response Fields

​
response
string
Status of the request.
​
message
string
Human-readable result message.
​
details
object
Exchange operation details.
​
details.order_id
string
The order ID that was processed.
​
details.previous_count
integer
Number of IPs before the exchange.
​
details.new_count
integer
Number of IPs after the exchange.
​
details.requested_count
integer
Number of IPs requested (based on order quantity).
​
details.overlapping_ips
integer
Number of IPs that are the same between old and new (should be 0 ideally).

​
Error Responses

​
403 Forbidden - Feature Not Enabled

{
  "response": "error",
  "message": "Proxy exchange feature is not enabled for your organization. Contact support to enable this feature."
}

​
404 Not Found

{
  "response": "error",
  "message": "Order not found or you don't have permission to access it"
}

​
400 Bad Request - Order Not Active

{
  "response": "error",
  "message": "Can only exchange proxies for active orders"
}

​
400 Bad Request - Wrong Product Type

{
  "response": "error",
  "message": "Proxy exchange is only available for datacenter products"
}

​
How It Works

1

Request Exchange

You call the exchange endpoint with your order ID.
2

Current IPs Removed

All current proxy IPs are removed from the servers.
3

New IPs Assigned

Fresh IPs from the available pool are assigned to your order.
4

Confirmation

The response confirms the exchange with before/after counts.

​
Requirements

  • Active order: Only active orders can have proxies exchanged
  • Datacenter product: Exchange is only available for datacenter proxy products
  • Feature enabled: Your organization must have the proxy_exchange feature enabled

​
Use Cases

  • IP blocked: Get fresh IPs if your current ones are blocked
  • Clean slate: Start with unused IPs for a new project
  • Rotation: Periodic IP rotation for long-running operations

​
Notes

  • The exchange process takes a few seconds to complete
  • Your proxy username and password remain the same
  • The new IPs will be different from your previous ones (overlap should be 0)
  • Exchange does not affect your billing or subscription

​
Getting Access

If you need the proxy exchange feature enabled for your organization:

Contact Support

Email us to enable proxy exchange for your organization.