> ## 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 usage and charges

> Returns paginated compute and storage charge records for your organization. Each record is an immutable billing window with its interval, resource, and capture/authorization state. Captured charges for running hours are not automatically refunded on pod stop — only uncaptured holds are released. Response shape: `{ data: ComputeCharge[], nextCursor?: string }`. Requires compute `read` access.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/gpu/usage
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/usage:
    get:
      tags:
        - GPU Compute
      summary: List usage and charges
      description: >-
        Returns paginated compute and storage charge records for your
        organization. Each record is an immutable billing window with its
        interval, resource, and capture/authorization state. Captured charges
        for running hours are not automatically refunded on pod stop — only
        uncaptured holds are released. Response shape: `{ data: ComputeCharge[],
        nextCursor?: string }`. Requires compute `read` access.
      parameters:
        - name: cursor
          in: query
          schema:
            type: string
      responses:
        '200':
          description: Charge records.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ComputeCharge'
                  nextCursor:
                    type: string
                    nullable: true
        '403':
          description: Compute access required.
components:
  schemas:
    ComputeCharge:
      type: object
      description: >-
        An immutable billing window record for a compute or storage hour. All
        fields are camelCase.
      required:
        - id
        - resourceType
        - resourceId
        - status
      properties:
        id:
          type: string
          format: uuid
        resourceType:
          type: string
          enum:
            - pod
            - volume
        resourceId:
          type: string
          format: uuid
        kind:
          type: string
          description: Charge kind (e.g. `compute`, `storage`).
        status:
          type: string
          enum:
            - authorized
            - captured
            - refunded
            - pending
            - failed
        amountUsd:
          type: string
          description: Charge amount in USD, six-decimal precision.
        intervalStart:
          type: string
          format: date-time
          nullable: true
        intervalEnd:
          type: string
          format: date-time
          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).

````