> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aireserve.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List pods

> Returns all pods owned by your organization, including terminated ones. Response shape: `{ data: ComputePod[], nextCursor?: string }`. Requires compute `read` access or higher.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/gpu/pods
openapi: 3.0.3
info:
  title: AI Reserve Gateway API
  description: >-
    The AI Reserve API surface — OpenAI-compatible chat completions,
    Anthropic-compatible messages, Bedrock Converse, images, video, files,
    text-to-speech, realtime voice sessions, and GPU Compute pod/volume
    management — all behind one endpoint and one API key.
  version: 1.0.0
servers:
  - url: https://api.aireserve.com
security:
  - bearerAuth: []
paths:
  /v1/gpu/pods:
    get:
      tags:
        - GPU Compute
      summary: List pods
      description: >-
        Returns all pods owned by your organization, including terminated ones.
        Response shape: `{ data: ComputePod[], nextCursor?: string }`. Requires
        compute `read` access or higher.
      parameters:
        - name: cursor
          in: query
          schema:
            type: string
          description: Pagination cursor from a previous response.
      responses:
        '200':
          description: Pod list.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ComputePod'
                  nextCursor:
                    type: string
                    nullable: true
components:
  schemas:
    ComputePod:
      type: object
      description: >-
        A GPU pod managed by AI Reserve Compute. All fields are camelCase to
        match the service DTO.
      required:
        - id
        - name
        - status
        - createdAt
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        status:
          type: string
          enum:
            - requested
            - provisioning
            - starting
            - running
            - stopping
            - stopped
            - terminating
            - terminated
            - failed
          description: Current observed pod state.
        desiredState:
          type: string
          enum:
            - running
            - stopped
            - terminated
          description: Control-plane target state. The pod converges asynchronously.
        gpuTypeId:
          type: string
        gpuCount:
          type: integer
        dataCenterId:
          type: string
        containerDiskGb:
          type: integer
          description: Ephemeral container disk in GiB. Lost on stop or termination.
        networkVolumeId:
          type: string
          format: uuid
          nullable: true
        imageName:
          type: string
          nullable: true
        rateUsdPerHour:
          type: string
          description: >-
            Locked hourly rate (GPU + container disk) in USD, six-decimal
            precision.
        envKeys:
          type: array
          items:
            type: string
          description: Names of injected environment variables. Values are never returned.
        paidThroughAt:
          type: string
          format: date-time
          nullable: true
          description: >-
            End of the current prepaid compute coverage window. Null when
            stopped or not yet running.
        createdAt:
          type: string
          format: date-time
        lastError:
          type: string
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your AI Reserve API key (aireserve_api_…) from the API Keys page in the
        portal (https://portal.aireserve.com/keys).

````