One header to authenticate, REST and JSON for everything you can do in the portal.
Sliding window, on every plan
Servers, backups, firewall, and more
Versioned in the URL
Included, nothing to enable
There is no OAuth dance and no token to refresh. Create an API key in your
account settings, send it in the X-Virtbase-API-Key header, and every endpoint
is open to you.
Keys do not expire. They are shown once at creation, so store the key when you make it — and delete it the moment you no longer need it.
curl https://virtbase.com/api/v1/servers \
-H "X-Virtbase-API-Key: $VIRTBASE_API_KEY"Anything that returns a collection paginates the same way and sorts the same
way. page and per_page control the window, sort takes a field with an
optional :asc or :desc, and several fields can be combined.
The envelope is always the same shape, so a client written against one collection works against the next one.
{
"ssh_keys": [],
"meta": {
"pagination": {
"page": 1,
"per_page": 10,
"previous_page": null,
"next_page": 2,
"last_page": 10,
"total_entries": 100
}
}
}The default is 120 requests a minute — two a second — over a sliding window, which means short bursts are fine as long as the window holds.
Every response carries the current state in its headers, so a well-behaved
client never has to guess. Go over and you get a 429, not a silent drop.
Need more? Ask support. Higher limits are granted on request rather than sold as an upgrade.
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1787769600The API covers the same ground as the customer portal: servers, backups, firewall rules, reverse DNS, SSH keys, ISO images, offers and invoices.
That means the whole life of a machine is scriptable. You can create a server, wait for it to provision, push an SSH key, write firewall rules, set the reverse DNS on its addresses, take a backup before a risky deploy and restore it afterwards — without a browser anywhere in the loop.
It also means the parts that usually get forgotten are scriptable. Reverse DNS for a mail server, a firewall rule that follows your office IP, a nightly backup before your own migration runs: all of it belongs in the same script as the rest of your infrastructure.
Go to account settings in the customer portal and pick API in the navigation.
Click Create API key, give it a name you will recognise later, and confirm.
The key is displayed once. Put it in your secret store or your CI environment straight away — there is no way to read it back later.
The full endpoint reference, with every parameter and response shape, is at virtbase.com/api/docs. It is available in English only.
1 vCore
4GB RAM
50GB NVMe SSD
1 IPv4 + IPv6 /64 Subnet
SkyLink Data Center, NL
2 vCores
8GB RAM
100GB NVMe SSD
1 IPv4 + IPv6 /64 Subnet
SkyLink Data Center, NL
4 vCores
16GB RAM
150GB NVMe SSD
1 IPv4 + IPv6 /64 Subnet
SkyLink Data Center, NL
4 vCores
24GB RAM
170GB NVMe SSD
1 IPv4 + IPv6 /64 Subnet
SkyLink Data Center, NL
6 vCores
36GB RAM
200GB NVMe SSD
1 IPv4 + IPv6 /64 Subnet
SkyLink Data Center, NL
8 vCores
48GB RAM
250GB NVMe SSD
1 IPv4 + IPv6 /64 Subnet
SkyLink Data Center, NL
10 vCores
56GB RAM
270GB NVMe SSD
1 IPv4 + IPv6 /64 Subnet
SkyLink Data Center, NL
12 vCores
64GB RAM
300GB NVMe SSD
1 IPv4 + IPv6 /64 Subnet
SkyLink Data Center, NL