---
title: "List Pod Reserves"
method: GET
path: "/v2/reserves/pods"
tags: ["API v2", "Pod Reserves v2"]
---

# List Pod Reserves

`GET /v2/reserves/pods`

## Request

- The document declares no server URL.
- Auth: none required
- TypeScript: <https://skmtc.dev/yottalabs/apis/docs-yottalabs-ai/docs/v2/reserves/pods/get.ts> (a function with typed inputs; its response is checked against the schema)

List the authenticated organization's Pod/Serverless reserved capacity and active Pod usage

## Query parameters

- `page` integer: Page number, 1-based
- `size` integer: Page size from 1 to 100
- `region` string: Reserved machine region
- `reserveNodeId` string: Stable customer-facing reserved node ID
- `gpuType` string: Exact canonical v2 or raw/database GPU type; GPU display names are not queried
- `reservationStatus` 'RESERVED' | 'EXPIRED': Reservation status
- `machineStatus` 'IN_USE' | 'IDLE' | 'UNKNOWN' | 'NOT_APPLICABLE': Reserved machine status

## Response `200`

OK

- ResultV2PageResponseReserveV2Response
  - `message` string: message
  - `code` integer: code
  - `data` V2PageResponseReserveV2Response: Paginated Response
    - `items` ReserveV2Response[]: List of items in the current page
      - `id` integer: Reserve ID
      - `reserveNodeId` string: Stable customer-facing reserved node ID
      - `region` string: Reserved machine region
      - `gpuType` string: Canonical v2 GPU type
      - `gpuDisplayName` string: GPU display name
      - `gpuCount` integer: Total reserved GPU count
      - `availableGpuCount` integer: Currently available GPU count
      - `usedGpuCount` integer: GPU count used by owner non-Spot workloads
      - `unavailableGpuCount` integer: Offline or unavailable GPU count
      - `reservationStatus` 'RESERVED' | 'EXPIRED', nullable: Reservation status
      - `machineStatus` 'IN_USE' | 'IDLE' | 'UNKNOWN' | 'NOT_APPLICABLE', nullable: Reserved machine status
      - `startAt` integer: Reservation start epoch milliseconds
      - `endAt` integer: Reservation end epoch milliseconds
      - `pods` ReserveV2PodResponse[]: Active Pod usage relationships
        - `podId` integer: Pod ID
        - `gpuCount` integer: GPU count used by the Pod
    - `page` integer: Current page number (1-based)
    - `size` integer: Number of items per page
    - `total` integer: Total number of items across all pages
    - `pages` integer: Total number of pages

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `10000`: Success

---

[API](https://skmtc.dev/yottalabs/apis/docs-yottalabs-ai.md) - [All operations](https://skmtc.dev/yottalabs/apis/docs-yottalabs-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/yottalabs/apis/docs-yottalabs-ai/revisions/998cc08df103?raw)