VM Availability | Documentation | Geodd
VM Availability
DocsGPU APIVM Availability

VM Availability

Lists the GPU VM types available to your account, with hourly pricing and live capacity per region.

GET
https://api.geodd.io/vm/availability

Authorizations

Authorization string header required

Bearer authentication header of the form Bearer <apiKey>, where <apiKey> is your Enterprise API key.

Response

application/json
data object<string, object>

A map of VM type name to its availability details. For each VM type you get:

instance_type object

Name, description, your hourly price in cents (price_cents_per_hour), and hardware specs (vcpu_count, memory_gib, storage_gb).

available_capacity object

The regions where this VM type can be launched right now (regions) and how many are available in total (available).

Responses

200
OK
Request processed successfully. Returns the availability map.
401
Unauthorized
Missing or invalid API key. Check the Authorization header.
403
Forbidden
Your API key is not authorized for VMs. Contact [email protected] to request Enterprise access.

Example Request:

curl https://api.geodd.io/vm/availability \
  -H "Authorization: Bearer $GEODD_API_KEY"

Example Response:

{
  "success": true,
  "data": {
    "gpu_1x_h100": {
      "instance_type": {
        "name": "gpu_1x_h100",
        "description": "1x H100 80GB",
        "price_cents_per_hour": 300,
        "specs": {
          "vcpu_count": 20,
          "memory_gib": 128,
          "storage_gb": 1200
        }
      },
      "available_capacity": {
        "regions": [
          "us-east-1"
        ],
        "available": 5
      }
    },
    "gpu_2x_h100": {
      "instance_type": {
        "name": "gpu_2x_h100",
        "description": "2x H100 80GB",
        "price_cents_per_hour": 600,
        "specs": {
          "vcpu_count": 40,
          "memory_gib": 256,
          "storage_gb": 2500
        }
      },
      "available_capacity": {
        "regions": [
          "us-east-1"
        ],
        "available": 18
      }
    }
  }
}

Notes

  • If your API key is limited to specific regions, only those regions are shown.
  • Capacity is live data — poll this endpoint immediately before launching to confirm availability.
Next
SSH Keys