Additional IPs

A server comes with one public IP. You can add up to 5 more, each billed as its own subscription for 7, 14, 30 or 90 days — priced like a server, with the same short-term fee for 7 and 14 days. Need more than 5? Contact support.

Additional IPs are not available for servers on a private primary IP, or in locations that do not sell them.

Check the price and availability

curl https://api.storiza.store/vps/VPS_ID/additional-ips/quote \
  -H "Authorization: Bearer $STORIZA_API_KEY"

prices lists what each period costs in US dollars. available: false comes with a reason:

`reason`	Meaning
`NOT_FOR_SALE`	Not sold in this server’s location
`NO_FREE_IP`	None free in this location right now
`LIMIT_REACHED`	The server already has 5
`PRIVATE_IP_SERVER`	Not offered for this server
`SERVER_NOT_ACTIVE`	The server must be running and paid for

Order one

curl -X POST https://api.storiza.store/vps/VPS_ID/additional-ips/order \
  -H "Authorization: Bearer $STORIZA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "method": "balance", "duration": 30 }'

Paid from the balance it is assigned at once. Any other method returns a checkoutUrl, and the IP is assigned when the payment settles. couponCode and stopAutoRenew work as for servers.

Set it up inside the server

Additional IPs are not configured for you. Read them from GET /vps/{vmId} — additionalIpDetails lists each one’s address, netmask (CIDR bits) and gateway — and add them to the server’s network card:

# Linux (until reboot; add it to netplan or your network config to keep it)
sudo ip addr add 192.0.2.57/24 dev eth0

# Windows
netsh interface ipv4 add address "Ethernet" 192.0.2.57 255.255.255.0

Replace eth0 / Ethernet with your network card’s name.

Managing them

You want to	Call
List all your IPs, including parked ones	`GET /vps-additional-ips/`
One IP, with its subscription	`GET /vps-additional-ips/{id}`
Move to another of your servers, or park it	`POST /vps-additional-ips/{id}/move` with `{ "vpsId": "…" }` or `{ "vpsId": null }`
Renew now	`POST /vps-additional-ips/{id}/renew`
Stop automatic charges	`PATCH /payments/subscriptions/{id}/auto-renew`
Cancel at the end of the period	`DELETE /payments/subscriptions/{id}`

Moving is free, and only possible to a server on the same node as the IP (DIFFERENT_LOCATION otherwise). The IP stops working on the old server straight away; add it inside the new one.
Parked means kept and still billed, but on no server. When you delete a server, its additional IPs are parked rather than lost, so you can put them on another server.
To give an IP back immediately — no refund — use Release in the dashboard.

When it is not renewed

	What happens
Renewal not paid (or `stopAutoRenew`)	Stops carrying traffic at the end of the period, and is kept for 48 hours. Renew within that time and it works again with the same address
After 48 hours	Released — it may be given to another customer and cannot be recovered
Cancelled	Released as soon as the period ends, with no 48 hours

See Renew, pause auto-renew, or cancel for how the subscription side works.

Get started

Using the API

Servers & apps

More

Managing them

When it is not renewed