curl --request POST \
--url https://api.storiza.store/vps/{id}/additional-ips/order \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"method": "<string>",
"duration": 30,
"currency": "USD",
"couponCode": "<string>",
"stopAutoRenew": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
method: '<string>',
duration: 30,
currency: 'USD',
couponCode: '<string>',
stopAutoRenew: true
})
};
fetch('https://api.storiza.store/vps/{id}/additional-ips/order', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.storiza.store/vps/{id}/additional-ips/order"
payload = {
"method": "<string>",
"duration": 30,
"currency": "USD",
"couponCode": "<string>",
"stopAutoRenew": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"message": "Additional IP order created",
"data": {
"id": 1042,
"type": "topup",
"status": "pending",
"direction": "deposit",
"method": "credit-cards",
"provider": "polar",
"currency": null,
"conversionRate": "1",
"subtotalAmount": "100",
"discountAmount": "10",
"netAmount": "90",
"taxAmount": "0",
"totalAmount": "90",
"user": {
"id": "00000000-0000-4000-8000-000000000000"
},
"coupon": null,
"supportsIframes": false,
"applePaySession": null,
"expiresAt": "2026-11-07T01:49:15.405Z"
}
}Buy an additional IP for this server
Raises a transaction for one additional public IP on this server, billed as its own subscription for the chosen period and priced like a VPS (the same short-term fee for 7 and 14 days). Paid from balance it settles at once; any other method returns a checkoutUrl and the IP is assigned when the payment settles. Coupons apply.
The address is taken from the server’s own node when the payment settles. It must then be configured inside the server’s OS; GET /vps/:id lists it under additionalIpDetails with its netmask and gateway.
Refused with the same codes as GET /vps/:id/additional-ips/quote when it cannot be bought (NOT_FOR_SALE, NO_FREE_IP, LIMIT_REACHED, PRIVATE_IP_SERVER, SERVER_NOT_ACTIVE). If the last free IP is taken between checkout and payment, the order is kept and support is notified to assign one.
An unpaid IP stops working when its period ends and is released 48 hours later. Cancel with POST /payments/subscriptions/:id/cancel; move it with POST /vps-additional-ips/:id/move. Owner only.
Required API key permission: vps:write
curl --request POST \
--url https://api.storiza.store/vps/{id}/additional-ips/order \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"method": "<string>",
"duration": 30,
"currency": "USD",
"couponCode": "<string>",
"stopAutoRenew": true
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
method: '<string>',
duration: 30,
currency: 'USD',
couponCode: '<string>',
stopAutoRenew: true
})
};
fetch('https://api.storiza.store/vps/{id}/additional-ips/order', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.storiza.store/vps/{id}/additional-ips/order"
payload = {
"method": "<string>",
"duration": 30,
"currency": "USD",
"couponCode": "<string>",
"stopAutoRenew": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"success": true,
"message": "Additional IP order created",
"data": {
"id": 1042,
"type": "topup",
"status": "pending",
"direction": "deposit",
"method": "credit-cards",
"provider": "polar",
"currency": null,
"conversionRate": "1",
"subtotalAmount": "100",
"discountAmount": "10",
"netAmount": "90",
"taxAmount": "0",
"totalAmount": "90",
"user": {
"id": "00000000-0000-4000-8000-000000000000"
},
"coupon": null,
"supportsIframes": false,
"applePaySession": null,
"expiresAt": "2026-11-07T01:49:15.405Z"
}
}Authorizations
Body
Response
Additional IP order created
Schema for Transaction model
Show child attributes
Show child attributes
{
"id": 1042,
"type": "topup",
"status": "pending",
"direction": "deposit",
"method": "credit-cards",
"provider": "polar",
"currency": null,
"conversionRate": "1",
"subtotalAmount": "100",
"discountAmount": "10",
"netAmount": "90",
"taxAmount": "0",
"totalAmount": "90",
"user": {
"id": "00000000-0000-4000-8000-000000000000"
},
"coupon": null,
"supportsIframes": false,
"applePaySession": null,
"expiresAt": "2026-11-07T01:49:15.405Z"
}
Was this page helpful?