> ## 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 usage snapshot

> Returns customer-facing usage metrics and costs for the requested period. Supports summary totals and daily buckets for timestamped usage sources. Vault storage is intentionally omitted from totals because it is not yet periodized for arbitrary windows.



## OpenAPI

````yaml /openapi.json get /usage/v1
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:
  /usage/v1:
    get:
      tags:
        - Usage
      summary: Get usage snapshot
      description: >-
        Returns customer-facing usage metrics and costs for the requested
        period. Supports summary totals and daily buckets for timestamped usage
        sources. Vault storage is intentionally omitted from totals because it
        is not yet periodized for arbitrary windows.
      operationId: getUsageSnapshot
      parameters:
        - name: periodStart
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: >-
            Period start date. Defaults to the start of the current calendar
            month.
        - name: periodEnd
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: Period end date. Defaults to now.
        - name: granularity
          in: query
          required: false
          schema:
            type: string
            enum:
              - summary
              - daily
            default: summary
          description: Whether to return period totals only or include daily buckets.
        - name: lincSessionId
          in: query
          required: false
          schema:
            type: string
          description: >-
            Restrict usage to a native Linc session. The session must belong to
            the authenticated organization.
        - name: groupBy
          in: query
          required: false
          schema:
            type: string
            enum:
              - lincSessionId
          description: >-
            Optionally include usage groups keyed by native Linc session id.
            Only Linc-session-attributable usage is grouped.
      responses:
        '200':
          description: Usage snapshot retrieved successfully
        '400':
          description: Invalid query parameters
        '401':
          description: Invalid API key or session
        '403':
          description: Insufficient permissions
        '404':
          description: Linc session not found
        '409':
          description: Linc session usage is unavailable
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````