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

# List Pod Reserves

`GET /v2/reserves/pods`

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

## Other responses

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

---

[API](https://skmtc.net/yottalabs/apis/docs-yottalabs-ai.md) · [All operations](https://skmtc.net/yottalabs/apis/docs-yottalabs-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yottalabs/docs-yottalabs-ai/revisions/998cc08df103/schema)