Reserves

List Pod Reserves

get

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

Authorizations

x-api-key

x-api-keystringRequired

Query parameters

pageinteger · int64Optional

Page number, 1-based

Example: 1

sizeinteger · int64Optional

Page size from 1 to 100

Example: 10

regionstringOptional

Reserved machine region

Example: dev-ca-west-1

reserveNodeIdstringOptional

Stable customer-facing reserved node ID

Example: node-a

gpuTypestringOptional

Exact canonical v2 or raw/database GPU type; GPU display names are not queried

Example: NVIDIA_RTX_5090_32G

reservationStatusstring · enumOptional

Reservation status

Example: RESERVEDPossible values:

machineStatusstring · enumOptional

Reserved machine status

Example: IN_USEPossible values:

Responses

200

OK

*/*

messagestringOptional

message

codeinteger · int32Optional

code

400

Bad Request

*/*

500

Internal Server Error

*/*

10000

Success

*/*

get/v2/reserves/pods

HTTPcURLJavaScriptPython

GET /v2/reserves/pods HTTP/1.1
x-api-key: YOUR_API_KEY
Accept: */*

{
  "message": "success",
  "code": 10000,
  "data": {
    "items": [
      {
        "id": "5000",
        "reserveNodeId": "node-a",
        "region": "dev-ca-west-1",
        "gpuType": "NVIDIA_RTX_5090_32G",
        "gpuDisplayName": "RTX 5090",
        "gpuCount": 8,
        "availableGpuCount": 6,
        "usedGpuCount": 2,
        "unavailableGpuCount": 0,
        "reservationStatus": "RESERVED",
        "machineStatus": "IN_USE",
        "startAt": "1785024000000",
        "endAt": "1787702400000",
        "pods": [
          {
            "podId": "5300",
            "gpuCount": 2
          }
        ]
      }
    ],
    "page": "1",
    "size": "10",
    "total": "1",
    "pages": "1"
  }
}