Skip to content

List web hosting plans

GET /api/v2/products/shared-hosting

List the web hosting plans you can order, sorted by the price in billing, lowest first. It needs no API key. To order one with POST /api/v2/orders, send data[].slug as items[].productSlug in a shared_hosting item. Set items[].primaryDomain to the domain the hosting account will use. Pick a billing cycle from billingCycles[]. Order only plans with available: true. Your existing hosting accounts are in GET /api/v2/shared-hosting.

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/shared-hosting
curl "https://cloud.hostup.se/api/v2/products/shared-hosting"

Responses

200 One page of web hosting plans.

Response 200
{
"data": [
{
"id": "shprod_01hxa3b4c5d6e7f8g9h0j1k2m3",
"slug": "webbhotell-start",
"tier": "start",
"name": "Webbhotell Start",
"resources": {
"cpuCores": 1,
"memoryGb": 1,
"storageGb": 20,
"bandwidthGb": 1024,
"emailAccountLimit": 10,
"databaseLimit": 5
},
"billing": {
"amount": 990,
"currencyCode": "SEK",
"billingCycle": "annually"
},
"billingCycles": [
{
"billingCycle": "monthly",
"amount": 99,
"currencyCode": "SEK",
"setupAmount": null,
"isPrimary": false
},
{
"billingCycle": "annually",
"amount": 990,
"currencyCode": "SEK",
"setupAmount": null,
"isPrimary": true
}
],
"availabilityStatus": "available",
"available": true,
"reason": null,
"controlPanel": {
"type": "cpanel"
}
}
],
"hasMore": false,
"nextCursor": null
}
Response fields
dataarray of object
idstring
The plan’s product ID (shprod_…). Orders use slug, not this ID.
slugstring
Send it as items[].productSlug in POST /api/v2/orders.
tierstring
Short plan name, such as start.
namestring
Plan name in the chosen language.
resourcesobject
cpuCoresnumber or null
CPU cores. null when unlimited or not stated.
memoryGbnumber or null
Memory in GB. null when unlimited or not stated.
storageGbnumber or null
Disk space in GB. null when unlimited or not stated.
bandwidthGbnumber or null
Traffic in GB. null when unlimited or not stated.
emailAccountLimitinteger or null
Number of mailboxes. null when unlimited or not stated.
databaseLimitinteger or null
Number of databases. null when unlimited or not stated.
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, annually, 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, annually.
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: cannot be ordered right now. One of available, out_of_stock.
availableboolean
true when the plan can be ordered now.
reasonstring or null
Why the plan cannot be ordered. null when available is true.
controlPanelobject
typestring
Control panel of the plan. Always cpanel. One of cpanel.
supportsWhmboolean
true for reseller plans that include WHM. Missing on other plans.
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.
404Not found. The resource does not exist or is not owned by the caller.
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.
502upstream_shared_hosting_product_shape_invalid: the plans could not be loaded. Retry later.