compute

GET /v1/compute/vps/quote

What one configured VPS costs, itemised.

All compute endpoints

Authentication

Send an API key as a bearer token. The key must carry the sites.view permission; a key without it is refused with 403, not 404.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X GET https://api.zinndigital.com/v1/compute/vps/quote?size=<size> \
  -H "Authorization: Bearer zdk_live_…"

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

A **pure read** - it opens no transport, writes nothing and charges nothing. The order screen calls it on every change so the customer sees the real total before committing, rather than a machine price that grows at checkout once the options are applied. ⛔ The machine's own figure comes from its **plan**, never from the add-on catalogue. Two sources for one price is how a configurator and a checkout come to disagree. Requires `sites.view`.

Parameters

NameTypeRequiredWhat it is
size (query)stringYesThe vendor's machine token (`vps-a` … `vps-i`).
interval (query)string<monthly, yearly>No
image (query)stringNoThe operating-system token. Only Windows carries a price.
cpanel (query)stringNoA cPanel licence (`cpaneladmin`, `cpanelpro`, `cpanelplus`, `cpanelpremier`).
backup (query)booleanNo
disk_gb (query)integerNoAn additional disk in GB. 50-250 in tens, 250-1000 in fifties, 1000-2000 in hundreds.

Response

NameTypeRequiredWhat it is
dataComputeVpsQuoteYesOne configured VPS, itemised. Every figure is integer minor units of `currency`; `total_minor` is the sum and is the number to show the customer.

Errors this endpoint can return

401 · 403 · 422 · 429