Skip to content

List the compute plans

  • Method: GET
  • Path: /v1/orgs/{org}/compute/plans
  • Operation ID: listPlans
  • Tag: Compute

Send Authorization: Bearer <credential>. The credential is either an API key (vsk_…) created for an organization, or an OIDC access token obtained by signing in to VirtScale.

Name Type Required Description
org string (uuid) Yes The organization’s id.
Field Type Required Enum Description
items array of PlanOut Yes
items.backup_policy string, nullable Yes A label (daily-7d), not a schedule; null is no backups included.
items.currency string Yes ISO 4217, lowercase as the price book writes it: eur.
items.disk_gb integer Yes
items.id string Yes
items.management_level string Yes full | business.
items.monthly_price_cents integer Yes The monthly price in the smallest unit of currency (cents).
items.name string Yes
items.ram_mb integer Yes
items.status string Yes active | retired. A plan is retired, never deleted.
items.vcpus integer Yes
next_cursor string, nullable No

Every error response is application/problem+json (schema Problem).

Status Meaning
401 The credential is missing or invalid.
404 The resource does not exist.
default Any other status is possible; the code field identifies the error.
curl "https://api.virtscale.nl/v1/orgs/$ORG_ID/compute/plans" \
  -H "Authorization: Bearer $VIRTSCALE_API_KEY"