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
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/shared-hosting"Responses
200 One page of web hosting plans.
{ "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 objectidstringThe plan’s product ID (
shprod_…). Orders use slug, not this ID.slugstringSend it as
items[].productSlug in POST /api/v2/orders.tierstringShort plan name, such as
start.namestringPlan name in the chosen language.
resourcesobjectcpuCoresnumber or nullCPU cores.
null when unlimited or not stated.memoryGbnumber or nullMemory in GB.
null when unlimited or not stated.storageGbnumber or nullDisk space in GB.
null when unlimited or not stated.bandwidthGbnumber or nullTraffic in GB.
null when unlimited or not stated.emailAccountLimitinteger or nullNumber of mailboxes.
null when unlimited or not stated.databaseLimitinteger or nullNumber of databases.
null when unlimited or not stated.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, annually, 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, annually.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: cannot be ordered right now. One of available, out_of_stock.availablebooleantrue when the plan can be ordered now.reasonstring or nullWhy the plan cannot be ordered.
null when available is true.controlPanelobjecttypestringControl panel of the plan. Always
cpanel. One of cpanel.supportsWhmbooleantrue for reseller plans that include WHM. Missing on other plans.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. |
| 404 | Not found. The resource does not exist or is not owned by the caller. |
| 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 | upstream_shared_hosting_product_shape_invalid: the plans could not be loaded. Retry later. |