Skip to main content
POST
https://dashboard.statproxies.com
/
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
}
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.