---
title: "List reservation units"
method: GET
path: "/api/v2/reservation-units"
tags: ["Reservation Units"]
---

# List reservation units

`GET /api/v2/reservation-units`

List reservation units.

## Query parameters

- `regionID` string[]
- `accelerator` string[]
- `unit` string[]

## Response `200`

A list of reservation units.

- ReservationUnitV2[] — A list of regional accelerator reservation unit offerings.
  - `regionId` string, required — The region where this reservation unit is offered.
  - `accelerator` string, required — Public accelerator model or family, for example GB300.
  - `unit` string, required — Public reservation granularity, for example NVL72.
  - `machineFlavorId` string, required — Region machine flavor resolved for this reservation unit.
  - `deviceTypeResourceClass` string, required — Expected Fleet Manager device type resource class for selected hosts.
  - `hostsPerUnit` integer, required — Number of hosts claimed by one reservation unit.
  - `cpusPerUnit` integer, required — Total CPUs claimed by one reservation unit.
  - `gpusPerUnit` integer, required — Total GPUs claimed by one reservation unit.
  - `gpuMemoryPerUnit` integer, required — Total GPU memory in GiB claimed by one reservation unit.
  - `memoryPerUnit` integer, required — Total memory in GiB claimed by one reservation unit.
  - `host` ReservationUnitHostV2, required — Region flavor capacity for one host in a reservation unit.
    - `cpus` integer, required — The number of CPUs on one host.
    - `memory` integer, required — The amount of memory in GiB on one host.
    - `disk` integer, required — The amount of ephemeral disk in GB on one host.
    - `gpu` ReservationUnitGpuV2, required — GPU specification for one host in a reservation unit.
      - `vendor` 'UNKNOWN' | 'NVIDIA' | 'AMD', required — The GPU vendor.
      - `model` string, required — A GPU model.
      - `physicalCount` integer, required — The physical number of GPUs available on one host.
      - `logicalCount` integer, required — The logical number of GPUs available on one host.
      - `memory` integer, required — GPU memory in GiB for one GPU.
  - `availableUnitCount` integer, required — Number of complete, currently unclaimed reservation units.
  - `largestContiguousUnitCount` integer, required — Largest contiguous reservation-unit count currently satisfiable.
  - `totalCount` integer, required — Number of complete reservation units in the regional offering.

## Other responses

- `400` — Request body failed schema validation, or the request does not contain all the required fields.
- `401` — Authentication failed or the access token has expired.
- `403` — Request was denied by authorization, this may be caused by the authorization token not having the required scope for an API, or the user doesn't have the necessary privileges on the provider platform.
- `500` — An unexpected or unhandled error occurred. This may be a transient error and may succeed on a retry. If this isn't the case, please report it as an issue.

---

[API](https://skmtc.net/nscale/apis/region-service-api.md) · [All operations](https://skmtc.net/nscale/apis/region-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nscale/region-service-api/revisions/c2991b23da6e/schema)