Exchange Proxies
Order API
Exchange Proxies
Replace all IP addresses in an order with new ones, optionally swapping to a different product.
POST
Exchange Proxies
Exchange all proxies on an order — every assigned IP is released and a fresh set of the same quantity is allocated, preferring servers that did not hold your previous IPs.
The endpoint also supports cross-product exchange: send a target product and the same quantity is reassigned from a different datacenter pool. Omit the body (or send
Cross-product exchange:
The aliases
For a same-pool exchange,
Orders scheduled to cancel keep exchange rights until they expire; only expired or terminated orders are refused.
One exchange per order is allowed every 15 minutes. The
{}) to exchange within the same pool with unchanged behavior.
Rate limits. These calls trigger configuration reloads on the proxy servers, so they are limited two ways:
- Per order: one exchange per 15 minutes (a 429 response includes
retry_after_seconds). - Per API key: at most 10 exchange/replace calls per minute combined, on top of the general 60 req/min limit.
Request
Headers
| Header | Value | Required |
|---|---|---|
Authorization | Bearer {your_api_key} | Yes |
Content-Type | application/json | Only for cross-product exchange |
Path Parameters
The order ID for which to exchange proxies.
Body Parameters
The body is optional. Omit it (or send{}) for a same-pool exchange. To exchange into a different datacenter pool, provide the target product:
The datacenter pool to move the order into. Supported values:
sprint, captcha, events, lumen. The aliases product_type and target_product_id are also accepted.Example Request
Same-pool exchange (unchanged behavior):product_type and target_product_id accept the same value:
Response
Success Response
previous_product_type and product_type are identical.
Response Fields
Status of the request.
Human-readable result message.
Exchange operation details.
The order ID that was processed.
Number of IPs before the exchange.
Number of IPs after the exchange.
Number of IPs requested (based on order quantity).
Number of IPs that are the same between old and new (should be 0 ideally).
The product the order was on before the exchange. Matches
product_type for a same-pool exchange.The product the order is on after the exchange.
The proxy port for the order’s current product.
Error Responses
403 Forbidden - Feature Not Enabled
404 Not Found
400 Bad Request - Order Not Active
400 Bad Request - Wrong Product Type
429 Too Many Requests - Rate Limited
retry_after_seconds field tells you how long to wait.
500 Internal Server Error
How It Works
Requirements
- Active order: The order must be active, or cancelled but not yet expired (orders scheduled to cancel keep exchange rights until expiration)
- Datacenter product: Exchange is only available for datacenter proxy products
- Feature enabled: Your organization must have the
proxy_exchangefeature enabled - Within rate limits: One exchange per order every 15 minutes, and at most 10 exchange/replace calls per minute per API key
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)
- A same-pool exchange does not affect your billing or subscription
- To swap a single IP instead of the whole set, use Replace Proxy
Cross-product exchange safety
When moving an order to a different product, the operation is fully atomic:- If the target pool cannot fully assign the requested quantity, the old proxies, the order record, and the Stripe subscription are all left unchanged.
- Stripe is updated only after the new target proxies are fully assigned.
- Source proxies are deleted only after target assignment and the Stripe update both succeed.
Getting Access
If you need the proxy exchange feature enabled for your organization:Contact Support
Email us to enable proxy exchange for your organization.
