> ## 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.

# Get pod

> Returns the current state of a pod owned by your organization. Returns `404` for unknown IDs and for pods owned by other organizations.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/gpu/pods/{id}
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/{id}:
    get:
      tags:
        - GPU Compute
      summary: Get pod
      description: >-
        Returns the current state of a pod owned by your organization. Returns
        `404` for unknown IDs and for pods owned by other organizations.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Pod ID.
      responses:
        '200':
          description: Pod detail.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputePod'
        '403':
          description: Compute access required.
        '404':
          description: Pod not found or owned by another organization.
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).

````