Skip to content

List the sizes a region offers

  • Method: GET
  • Path: /v1/orgs/{org}/compute/regions/{region}/sizes
  • Operation ID: listRegionSizes
  • 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
region string Yes Region id
org string (uuid) Yes The organization’s id.
Field Type Required Enum Description
items array of SizeOut Yes
items.currency string Yes ISO 4217, lowercase as the price book writes it: eur.
items.disk_gb integer Yes
items.monthly_price_cents integer Yes The monthly price in the smallest unit of currency (cents).
items.name string Yes
items.plan_id string Yes
items.ram_mb integer Yes
items.status string Yes active | retired.
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/regions/$REGION_ID/sizes" \
  -H "Authorization: Bearer $VIRTSCALE_API_KEY"