Rotate selected IPs
curl --request POST \
--url https://app.proxy.doubledata.com/api/v1/isp/subscriptions/{subscriptionId}/rotations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ips": [
"198.51.100.10",
"203.0.113.20"
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({ips: ['198.51.100.10', '203.0.113.20']})
};
fetch('https://app.proxy.doubledata.com/api/v1/isp/subscriptions/{subscriptionId}/rotations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.proxy.doubledata.com/api/v1/isp/subscriptions/{subscriptionId}/rotations"
payload := strings.NewReader("{\n \"ips\": [\n \"198.51.100.10\",\n \"203.0.113.20\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}import requests
url = "https://app.proxy.doubledata.com/api/v1/isp/subscriptions/{subscriptionId}/rotations"
payload = { "ips": ["198.51.100.10", "203.0.113.20"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"rotation": {
"id": "4f114166-bbf7-41fa-82b8-c398f7a19914",
"status": "accepted",
"requested_count": 2,
"status_url": "/api/v1/isp/rotations/4f114166-bbf7-41fa-82b8-c398f7a19914"
}
}{
"error": {
"code": "unknown_proxy_ip",
"message": "One or more IPs are not active in this subscription.",
"details": {
"ips": [
"198.51.100.10"
]
},
"request_id": "ad2f824c-46bc-47c6-b276-2bb51a3083b1"
}
}{
"error": {
"code": "unauthorized",
"message": "A valid API key is required.",
"request_id": "ad2f824c-46bc-47c6-b276-2bb51a3083b1"
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}Rotations
Rotate selected IPs
Replace 1–100 unique active proxy IPs asynchronously, keeping each IP’s country. This changes live proxies. Poll the returned status URL before using new connection details.
POST
https://app.proxy.doubledata.com/api/v1
/
isp
/
subscriptions
/
{subscriptionId}
/
rotations
Rotate selected IPs
curl --request POST \
--url https://app.proxy.doubledata.com/api/v1/isp/subscriptions/{subscriptionId}/rotations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ips": [
"198.51.100.10",
"203.0.113.20"
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({ips: ['198.51.100.10', '203.0.113.20']})
};
fetch('https://app.proxy.doubledata.com/api/v1/isp/subscriptions/{subscriptionId}/rotations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.proxy.doubledata.com/api/v1/isp/subscriptions/{subscriptionId}/rotations"
payload := strings.NewReader("{\n \"ips\": [\n \"198.51.100.10\",\n \"203.0.113.20\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}import requests
url = "https://app.proxy.doubledata.com/api/v1/isp/subscriptions/{subscriptionId}/rotations"
payload = { "ips": ["198.51.100.10", "203.0.113.20"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"rotation": {
"id": "4f114166-bbf7-41fa-82b8-c398f7a19914",
"status": "accepted",
"requested_count": 2,
"status_url": "/api/v1/isp/rotations/4f114166-bbf7-41fa-82b8-c398f7a19914"
}
}{
"error": {
"code": "unknown_proxy_ip",
"message": "One or more IPs are not active in this subscription.",
"details": {
"ips": [
"198.51.100.10"
]
},
"request_id": "ad2f824c-46bc-47c6-b276-2bb51a3083b1"
}
}{
"error": {
"code": "unauthorized",
"message": "A valid API key is required.",
"request_id": "ad2f824c-46bc-47c6-b276-2bb51a3083b1"
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}{
"error": {
"code": "invalid_request",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"details": {
"ips": [
"127.0.0.1"
]
}
}
}Authorizations
Your organization's active API key.
Path Parameters
The subscription's public UUID.
Body
application/json
Unique public IPv4 addresses currently active in the subscription. Results preserve this order.
Required array length:
1 - 100 elementsResponse
Rotation accepted
Show child attributes
Show child attributes