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

# Get compute usage and billing

> Returns detailed compute usage statistics and billing information for your organization. Includes GPU and CPU hours, total runs, costs, and breakdowns by environment. Use optional query parameters to filter by specific year and month.



## OpenAPI

````yaml /openapi.json get /compute/v1/usage
openapi: 3.1.0
info:
  title: Case.dev API
  description: >-
    The AI-native platform for legal technology. Build smarter legal
    applications with our suite of AI-powered APIs.
  version: 1.0.0
  contact:
    name: Case.dev Support
    email: support@casemark.com
    url: https://case.dev
  license:
    name: Proprietary
    url: https://case.dev/terms
servers:
  - url: https://api.case.dev
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Vaults
    description: Secure document storage with semantic search and GraphRAG
  - name: Memory
    description: >-
      Persistent memory for AI agents with semantic search and 12 generic
      indexed tag fields
  - name: OCR
    description: Extract text from PDFs, images, and scanned documents
  - name: Voice
    description: Audio transcription and text-to-speech
  - name: LLMs
    description: Access 40+ language models through a unified API
  - name: Search
    description: Web search, AI answers, and deep research
  - name: Mail
    description: Managed inboxes for agent email workflows
  - name: Media
    description: Transcript retrieval and captioned media clip generation
  - name: Legal
    description: Legal research tools including citation verification
  - name: Privilege
    description: Privilege detection for e-discovery and litigation workflows
  - name: Compute
    description: Serverless GPU and CPU infrastructure
  - name: Format
    description: Document formatting and template rendering (MD/JSON to PDF/DOCX)
  - name: SuperDoc
    description: Document conversion and template automation
  - name: Webhooks
    description: Webhook endpoint management
  - name: System
    description: Public system metadata and discovery endpoints
  - name: Usage
    description: Usage reporting and webhook subscriptions
  - name: Database
    description: Serverless PostgreSQL databases with instant branching
  - name: Translation
    description: Language detection and translation for multilingual legal workflows
  - name: Skills
    description: Search and read legal AI skills for agents
  - name: Agents
    description: >-
      Create, manage, and execute AI agents with tool access, sandbox
      environments, and async run workflows
  - name: Matters
    description: Matter-native legal workspaces and orchestration primitives
  - name: Applications Projects
    description: Web application project management
  - name: Applications Deployments
    description: Web application deployment management
  - name: Applications Domains
    description: Custom domain configuration for applications
  - name: Applications Env Vars
    description: Environment variable management for applications
paths:
  /compute/v1/usage:
    get:
      tags:
        - Compute
      summary: Get compute usage and billing
      description: >-
        Returns detailed compute usage statistics and billing information for
        your organization. Includes GPU and CPU hours, total runs, costs, and
        breakdowns by environment. Use optional query parameters to filter by
        specific year and month.
      operationId: getComputeUsage
      parameters:
        - name: year
          in: query
          description: Year to filter usage data (defaults to current year)
          required: false
          schema:
            type: integer
            example: 2024
        - name: month
          in: query
          description: Month to filter usage data (1-12, defaults to current month)
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 12
            example: 3
      responses:
        '200':
          description: Usage statistics and billing information
          content:
            application/json:
              schema:
                type: object
                properties:
                  period:
                    type: object
                    properties:
                      year:
                        type: integer
                      month:
                        type: integer
                      monthName:
                        type: string
                  summary:
                    type: object
                    properties:
                      totalRuns:
                        type: integer
                      totalGpuHours:
                        type: number
                      totalCpuHours:
                        type: number
                      totalCostCents:
                        type: integer
                      totalCostFormatted:
                        type: string
                  byEnvironment:
                    type: array
                    items:
                      type: object
                      properties:
                        environment:
                          type: string
                        totalRuns:
                          type: integer
                        totalGpuSeconds:
                          type: integer
                        totalCpuSeconds:
                          type: integer
                        totalCostCents:
                          type: integer
                        totalCostFormatted:
                          type: string
              example:
                period:
                  year: 2024
                  month: 3
                  monthName: March
                summary:
                  totalRuns: 47
                  totalGpuHours: 12.5
                  totalCpuHours: 3.2
                  totalCostCents: 4750
                  totalCostFormatted: $47.50
                byEnvironment:
                  - environment: legal-document-processing
                    totalRuns: 35
                    totalGpuSeconds: 36000
                    totalCpuSeconds: 7200
                    totalCostCents: 3200
                    totalCostFormatted: $32.00
                  - environment: contract-analysis
                    totalRuns: 12
                    totalGpuSeconds: 9000
                    totalCpuSeconds: 4320
                    totalCostCents: 1550
                    totalCostFormatted: $15.50
        '401':
          description: Unauthorized - Valid API key required
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````