---
title: "List GPU Plans"
method: GET
path: "/v1/gpu"
tags: ["GPU Plans"]
---

# List GPU Plans

`GET /v1/gpu`

## Request

- Base URL: `https://gpucloud.ca/api`
- URL: `https://gpucloud.ca/api/v1/gpu`
- Auth: HTTP bearer

Returns every GPU machine size with the prices of the authenticated account (CAD per machine) and its current availability. Requires an API key. For anonymous availability, use GET /v1/availability.

## Response `200`

List of GPU plans

- object
  - `data` GpuPlan[]
    - `id` string
    - `name` string
    - `gpu` string
    - `gpuModel` string
    - `gpuCount` integer: GPUs of the server (1, 2, 4 or 8)
    - `spot` boolean: Spot server: interruptible without notice, hourly billing only
    - `hourlyOnly` boolean: True when only hourly billing is offered (monthly and annual are refused with CYCLE_NOT_AVAILABLE)
    - `specs` object
      - `vcores` integer
      - `ram` integer: RAM in GB
      - `storage` integer: System disk in GB
      - `storageType` string
      - `localStorage` integer: Local (ephemeral) work disk in GB, 0 when none
    - `pricing` object, nullable: Prices billed to the caller, per server (all its GPUs). null when priceOnRequest is true: the plan has no public price and is not sold online (contact us for a quote).
      - `hourly` number: On-demand hourly rate in CAD
      - `monthly` number, nullable: Monthly committed rate in CAD (null: hourly only)
      - `annual` number, nullable: Annual committed monthly rate in CAD (null: hourly only)
      - `currency` string
    - `priceOnRequest` boolean: True when the plan is sold on request only (no public price, pricing is null, never purchasable online)
    - `available` boolean: Whether this server size is currently in stock
    - `purchasable` boolean: Whether this GPU plan can be purchased (may be false if plan is visible but not yet offered)
    - `autoProvisioning` boolean: Whether this GPU can be auto-deployed via API
    - `eligibility` 'deployable' | 'contact' | 'out_of_stock' | 'disabled': Plan deployment eligibility status

## Other responses

- `401`: No API key (accountAction.code NO_API_KEY) or an invalid, expired, revoked or read only key on a write (INVALID_API_KEY). Provide a valid API key as `Authorization: Bearer <key>`; accountAction gives the links to create an account and a key.
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/gpucloud/apis/gpu-cloud-api.md) · [All operations](https://skmtc.dev/gpucloud/apis/gpu-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gpucloud/apis/gpu-cloud-api/revisions/ed530411f5c7?raw)