Get Cloud VPS PAYG deployment options

Return pay-as-you-go Cloud VPS deployment options: account eligibility, action gate, hourly pricing, default resources, min/max resource limits, and available regions. Use this as the preflight for POST /api/v2/vps/payg/deployments; do not invent resource sizes outside limits, and do not use POST /api/v2/orders for PAYG Cloud VPS creation. Regular fixed-cycle VPS products are listed by GET /api/v2/products/vps.

Cloud VPS PAYG Deployments

Authentication

Required API scope: read:vm

Use Authorization: Bearer <token> for API keys. Dashboard sessions may also use hostup_session.

Context

Headers

Accept Example
Content-Type Example

Responses

200 PAYG deployment options.
available boolean required · Example: false
reason stringnull required · Example: Verify your account before using Cloud VMs.
access object | null required · Example: null
access.available boolean required · Example: false
access.reason stringnull required · Example: Verify your account before using Cloud VMs.
access.countryCode stringnull required · Example: SE
access.countryPaymentAvailable boolean required · Example: true
access.requiresCard boolean required · Example: true
access.hasCard boolean required · Example: true
access.verified boolean required · Example: false
access.cloudAccessEnabled boolean required · Example: false
access.blockerReasons array<string> required
actions object required
actions.canDeploy object required
actions.canDeploy.allowed boolean required · Example: false
actions.canDeploy.reason stringnull required · Example: Verify your account before using Cloud VMs.
pricing object required
pricing.currencyCode string required · Example: SEK
pricing.cpuPerCoreHour number required · Example: 0.12
pricing.memoryPerGbHour number required · Example: 0.04
pricing.storagePerGbHour number required · Example: 0.003
pricing.bandwidthPerGb number required · Example: 0.1
pricing.ipPerHour number required · Example: 0.02
defaults object required
defaults.regionId string required · Example: stockholm
defaults.resources object required
defaults.resources.cpuCores integer required · Example: 2
defaults.resources.memoryGb integer required · Example: 4
defaults.resources.storageGb integer required · Example: 80
limits object required
limits.cpuCores object required
limits.cpuCores.min integer required · Example: 1
limits.cpuCores.max integer required · Example: 32
limits.memoryGb object required
limits.memoryGb.min integer required · Example: 1
limits.memoryGb.max integer required · Example: 256
limits.storageGb object required
limits.storageGb.min integer required · Example: 50
limits.storageGb.max integer required · Example: 2000
regions array<object> required
regions[].id stringnull required · Example: stockholm
regions[].name stringnull required · Example: Stockholm
regions[].available boolean required · Example: true
400 Invalid request. The response body is an RFC 7807 Problem Details document.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
401 Unauthorized. Authentication is required.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
403 Forbidden. The caller lacks a required scope or does not own the resource.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
404 Not found. The resource does not exist or is not owned by the caller.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
429 Rate limited. Retry after the limit resets. 429 responses include `Retry-After` seconds plus `X-RateLimit-*` headers.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
500 Internal error. Retry later or contact support if the issue persists.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on `detail`.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when `code` is `invalid_request`.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
GET https://cloud.hostup.se/api/v2/vps/payg/deployments
For AI assistants
View as Markdown
cURL 
curl -X GET "https://cloud.hostup.se/api/v2/vps/payg/deployments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response 
{
  "available": false,
  "reason": "Verify your account before using Cloud VMs.",
  "access": {
    "available": false,
    "reason": "Verify your account before using Cloud VMs.",
    "countryCode": "SE",
    "countryPaymentAvailable": true,
    "requiresCard": true,
    "hasCard": true,
    "verified": false,
    "cloudAccessEnabled": false,
    "blockerReasons": [
      "not_verified",
      "no_cloud_access"
    ]
  },
  "actions": {
    "canDeploy": {
      "allowed": false,
      "reason": "Verify your account before using Cloud VMs."
    }
  },
  "pricing": {
    "currencyCode": "SEK",
    "cpuPerCoreHour": 0,
    "memoryPerGbHour": 0,
    "storagePerGbHour": 0,
    "bandwidthPerGb": 0,
    "ipPerHour": 0
  },
  "defaults": {
    "regionId": "stockholm",
    "resources": {
      "cpuCores": 2,
      "memoryGb": 2,
      "storageGb": 50
    }
  },
  "limits": {
    "cpuCores": {
      "min": 1,
      "max": 32
    },
    "memoryGb": {
      "min": 1,
      "max": 256
    },
    "storageGb": {
      "min": 50,
      "max": 2000
    }
  },
  "regions": [
    {
      "id": "stockholm",
      "name": "Stockholm",
      "available": true
    }
  ]
}