Skip to content

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

limitinteger
Plans per page, from 1 to 100. Default 20. Default 20. 1 to 100.
cursorstring
The nextCursor value from the previous page.
localestring
Language of names and labels. sv gives Swedish. Any other value gives English. Default English. One of en, sv.

Example

GET /api/v2/products/vps
curl "https://cloud.hostup.se/api/v2/products/vps"

Responses

200 One page of VPS plans.

Response 200
{
"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 object
idstring
The plan’s product ID (vpsprod_…). Orders use slug, not this ID.
slugstring
Send it as items[].productSlug in POST /api/v2/orders.
tierstring
Short plan name, such as xs.
namestring
Plan name in the chosen language.
resourcesobject
cpuCoresnumber or null
CPU cores in the base plan.
memoryGbnumber or null
Memory in GiB in the base plan.
storageGbnumber or null
Disk space in GiB in the base plan.
bandwidthobject
limitGbnumber or null
Traffic included in the base plan, in GB.
billingobject
Price of the main billing cycle, the one marked isPrimary in billingCycles.
amountnumber
Price for the main billing cycle, in currencyCode.
currencyCodestring
ISO 4217 currency code.
billingCyclestring
The main billing cycle. One of monthly, quarterly, semiannually, annually, biennially, triennially, free.
billingCyclesarray of object
Billing cycles you can order. Send one billingCycle value in the order item.
billingCyclestring
Billing cycle to send in the order item. One of monthly, quarterly, semiannually, annually, biennially, triennially, free.
amountnumber
Recurring price for this cycle, in currencyCode.
currencyCodestring
ISO 4217 currency code for amount and setupAmount.
setupAmountnumber or null
One-time setup fee in currencyCode. null when there is none.
isPrimaryboolean
true for the main cycle, the one shown in billing.
availabilityStatusstring
available: can be ordered. out_of_stock or hidden: cannot be ordered right now. One of available, out_of_stock, hidden.
availableboolean
true when the plan can be ordered now.
reasonstring or null
Why the plan cannot be ordered. null when available is true.
configurableOptionsarray of object
Choices 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.
keystring
Option key, such as operatingSystem, bandwidthGb, additionalStorageGb, backupSlots, snapshotSlots or ipv6.
labelstring
Option name in the chosen language.
typestring
select: 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 | null
Default value. Its type depends on type.
choicesarray of object
The choices of a select option.
valuestring
Value to send for this choice.
labelstring
Name of the choice.
osTemplateIdstring
OS template ID (os_…) of an operating system choice.
minnumber
Lowest value of a slider or quantity.
maxnumber
Highest value of a slider or quantity.
stepnumber
Step between values of a slider or quantity.
includedAtBasenumber
Amount included in the plan price.
unitstring or null
Unit of the value, such as GB. null when there is none.
pricingarray of object
Price 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.
billingCyclestring
Billing cycle this price applies to.
amountnumber
Price for this billing cycle, in currencyCode.
currencyCodestring
ISO 4217 currency code.
requiredboolean
true when an input option must be filled in.
hasMoreboolean
true when another page follows.
nextCursorstring or null
Cursor 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.

400invalid_pagination_limit: limit is not from 1 to 100. invalid_cursor: cursor is not valid.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.
502The plans could not be loaded. upstream_failed: the catalog is unavailable. upstream_vps_product_shape_invalid: plan details could not be read. Retry later.