> ## Documentation Index
> Fetch the complete documentation index at: https://docs.storiza.store/llms.txt
> Use this file to discover all available pages before exploring further.

# Additional IPs

> Buy extra public IP addresses for a server, set them up, move them, and renew them.

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.

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

**1. Check the price and availability**

```bash theme={null}
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 |

**2. Order one**

```bash theme={null}
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.

**3. 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:

```bash theme={null}
# 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
```

```powershell theme={null}
# 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](https://docs.storiza.store/guides/renew-and-cancel.md) for how the subscription side works.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.