List VPS plans
GET /api/v2/products/vps
List the VPS plans you can order with a fixed billing cycle. It needs no API key. Cloud VPS, the pay-as-you-go product, is not in this list. Its options are in GET /api/v2/vps/payg/deployments.
To order a plan with POST /api/v2/orders, send data[].slug as items[].productSlug. Pick a billing cycle from billingCycles[]. configurableOptions lists what you can choose at order time, such as the operating system and extra storage. Order only plans with available: true. Prices are in SEK and without VAT. POST /api/v2/orders/preview gives the price with VAT in the account’s currency.
Authentication: None. Anyone can call it.
Request
Query parameters
limitintegerPlans per page, from 1 to 100. Default 20. Default
20. 1 to 100.cursorstringThe
nextCursor value from the previous page.localestringLanguage of names and labels.
sv gives Swedish. Any other value gives English. Default English. One of en, sv.Example
curl "https://cloud.hostup.se/api/v2/products/vps"Responses
200 One page of VPS plans.
{ "data": [ { "id": "vpsprod_01hxa3b4c5d6e7f8g9h0j1k2m3", "slug": "vps-xs", "tier": "xs", "name": "VPS XS", "resources": { "cpuCores": 2, "memoryGb": 4, "storageGb": 80 }, "bandwidth": { "limitGb": 1024 }, "billing": { "amount": 99, "currencyCode": "SEK", "billingCycle": "monthly" }, "billingCycles": [ { "billingCycle": "monthly", "amount": 99, "currencyCode": "SEK", "setupAmount": null, "isPrimary": true }, { "billingCycle": "annually", "amount": 990, "currencyCode": "SEK", "setupAmount": null, "isPrimary": false } ], "availabilityStatus": "available", "available": true, "reason": null, "configurableOptions": [ { "key": "operatingSystem", "label": "Operating system", "type": "select", "default": "ubuntu-24-04", "choices": [ { "value": "ubuntu-24-04", "label": "Ubuntu 24.04", "osTemplateId": "os_01hxa3b4c5d6e7f8g9h0j1k2m3" } ] }, { "key": "bandwidthGb", "label": "Bandwidth", "type": "slider", "min": 1024, "max": 10240, "step": 1024, "default": 1024, "includedAtBase": 1024, "unit": "GB", "pricing": [ { "billingCycle": "monthly", "amount": 0.02, "currencyCode": "SEK" } ] } ] } ], "hasMore": false, "nextCursor": null}Response fields
dataarray of objectidstringThe plan’s product ID (
vpsprod_…). Orders use slug, not this ID.slugstringSend it as
items[].productSlug in POST /api/v2/orders.tierstringShort plan name, such as
xs.namestringPlan name in the chosen language.
resourcesobjectcpuCoresnumber or nullCPU cores in the base plan.
memoryGbnumber or nullMemory in GiB in the base plan.
storageGbnumber or nullDisk space in GiB in the base plan.
bandwidthobjectlimitGbnumber or nullTraffic included in the base plan, in GB.
billingobjectPrice of the main billing cycle, the one marked
isPrimary in billingCycles.amountnumberPrice for the main billing cycle, in
currencyCode.currencyCodestringISO 4217 currency code.
billingCyclestringThe main billing cycle. One of
monthly, quarterly, semiannually, annually, biennially, triennially, free.billingCyclesarray of objectBilling cycles you can order. Send one
billingCycle value in the order item.billingCyclestringBilling cycle to send in the order item. One of
monthly, quarterly, semiannually, annually, biennially, triennially, free.amountnumberRecurring price for this cycle, in
currencyCode.currencyCodestringISO 4217 currency code for
amount and setupAmount.setupAmountnumber or nullOne-time setup fee in
currencyCode. null when there is none.isPrimarybooleantrue for the main cycle, the one shown in billing.availabilityStatusstringavailable: can be ordered. out_of_stock or hidden: cannot be ordered right now. One of available, out_of_stock, hidden.availablebooleantrue when the plan can be ordered now.reasonstring or nullWhy the plan cannot be ordered.
null when available is true.configurableOptionsarray of objectChoices you can make at order time. Send them in the order item’s
configurableOptions object under each key. For the operating system, send os or configurableOptions.operatingSystem with the choice’s value.keystringOption key, such as
operatingSystem, bandwidthGb, additionalStorageGb, backupSlots, snapshotSlots or ipv6.labelstringOption name in the chosen language.
typestringselect: pick one of choices. slider and quantity: a number from min to max. toggle: on or off. input: a value you enter. One of slider, quantity, toggle, input, select.defaultstring | number | boolean | nullDefault value. Its type depends on
type.choicesarray of objectThe choices of a
select option.valuestringValue to send for this choice.
labelstringName of the choice.
osTemplateIdstringOS template ID (
os_…) of an operating system choice.minnumberLowest value of a slider or quantity.
maxnumberHighest value of a slider or quantity.
stepnumberStep between values of a slider or quantity.
includedAtBasenumberAmount included in the plan price.
unitstring or nullUnit of the value, such as
GB. null when there is none.pricingarray of objectPrice per billing cycle. For a slider or quantity it is the price per unit above
includedAtBase. For a toggle it is the price when it is on.billingCyclestringBilling cycle this price applies to.
amountnumberPrice for this billing cycle, in
currencyCode.currencyCodestringISO 4217 currency code.
requiredbooleantrue when an input option must be filled in.hasMorebooleantrue when another page follows.nextCursorstring or nullCursor for the next page.
null on the last page.Errors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | invalid_pagination_limit: limit is not from 1 to 100. invalid_cursor: cursor is not valid. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |
| 502 | The plans could not be loaded. upstream_failed: the catalog is unavailable. upstream_vps_product_shape_invalid: plan details could not be read. Retry later. |