Get Cloud VPS PAYG resource limits

Return current, maximum, and remaining pay-as-you-go Cloud VPS limits plus hourly billing rates. Use this before creating a PAYG deployment or asking for a higher limit; values are in CPU cores, GiB of memory, GiB of storage, and instance count. These are not fixed-cycle VPS plan limits from GET /api/v2/products/vps.

Cloud VPS Limits

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 limits.
current object required
current.cpuCores integer required · Example: 4
current.memoryGb integer required · Example: 8
current.storageGb integer required · Example: 120
current.instanceCount integer required · Example: 2
max object required
max.cpuCores integer required · Example: 16
max.memoryGb integer required · Example: 64
max.storageGb integer required · Example: 1000
max.instanceCount integer required · Example: 10
remaining object required
remaining.cpuCores integer required · Example: 12
remaining.memoryGb integer required · Example: 56
remaining.storageGb integer required · Example: 880
remaining.instanceCount integer required · Example: 8
billing object required
billing.cpuPerCoreHour number required · Example: 0.12
billing.memoryPerGbHour number required · Example: 0.04
billing.storagePerGbHour number required · Example: 0.003
billing.ipPerHour number required · Example: 0.02
billing.bandwidthPerGb number required · Example: 0.1
billing.currencyCode string required · Example: SEK
hasPendingRequests boolean required · Example: false
pendingRequests array<object> required
pendingRequests[].id string required · Example: payglim_01hxa3b4c5d6e7f8g9h0j1k2m3
pendingRequests[].limitType string · enum required · Example: cpuCores
cpuCores
memoryGb
storageGb
floatingIpCount
vmCount
snapshotCount
privateNetworkCount
pendingRequests[].currentLimit integer required · Example: 16
pendingRequests[].requestedLimit integer required · Example: 32
pendingRequests[].reason string required · Example: Scaling production workloads
pendingRequests[].createdAt string required · Example: 2026-04-27T12:00:00.000Z
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/limits
For AI assistants
View as Markdown
cURL 
curl -X GET "https://cloud.hostup.se/api/v2/vps/payg/limits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response 
{
  "current": {
    "cpuCores": 4,
    "memoryGb": 8,
    "storageGb": 120,
    "instanceCount": 2
  },
  "max": {
    "cpuCores": 16,
    "memoryGb": 64,
    "storageGb": 1000,
    "instanceCount": 10
  },
  "remaining": {
    "cpuCores": 12,
    "memoryGb": 56,
    "storageGb": 880,
    "instanceCount": 8
  },
  "billing": {
    "cpuPerCoreHour": 0.12,
    "memoryPerGbHour": 0.04,
    "storagePerGbHour": 0.003,
    "ipPerHour": 0.02,
    "bandwidthPerGb": 0.1,
    "currencyCode": "SEK"
  },
  "hasPendingRequests": false,
  "pendingRequests": []
}