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

# List vault objects

> Retrieve all objects stored in a specific vault, including document metadata, ingestion status, and processing statistics.



## OpenAPI

````yaml /openapi.json get /vault/{id}/objects
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:
  /vault/{id}/objects:
    get:
      tags:
        - Vaults
      summary: List vault objects
      description: >-
        Retrieve all objects stored in a specific vault, including document
        metadata, ingestion status, and processing statistics.
      operationId: listVaultObjects
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The unique identifier of the vault
        - name: includeUnconfirmed
          in: query
          required: false
          description: >-
            Include placeholders for uploads that were never completed
            (awaiting_upload) or were cancelled (aborted). Excluded by default.
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Successfully retrieved vault objects
          content:
            application/json:
              schema:
                type: object
                required:
                  - vaultId
                  - objects
                  - count
                properties:
                  vaultId:
                    type: string
                    description: The ID of the vault
                  objects:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - filename
                        - contentType
                        - ingestionStatus
                        - createdAt
                      properties:
                        id:
                          type: string
                          description: Unique object identifier
                        filename:
                          type: string
                          description: Original filename of the uploaded document
                        contentType:
                          type: string
                          description: MIME type of the document
                        sizeBytes:
                          type: number
                          description: File size in bytes
                        path:
                          type: string
                          nullable: true
                          description: >-
                            Optional folder path for hierarchy preservation from
                            source systems
                        ingestionStatus:
                          type: string
                          description: Processing status of the document
                        pageCount:
                          type: number
                          description: Number of pages in the document
                        textLength:
                          type: number
                          description: Total character count of extracted text
                        chunkCount:
                          type: number
                          description: Number of text chunks created for vectorization
                        vectorCount:
                          type: number
                          description: Number of vectors generated for semantic search
                        tags:
                          type: array
                          items:
                            type: string
                          description: Custom tags associated with the document
                        metadata:
                          type: object
                          description: Custom metadata associated with the document
                        is_ai_generated:
                          type: boolean
                          description: >-
                            Whether the file was marked as AI-generated work
                            product at upload time
                        createdAt:
                          type: string
                          format: date-time
                          description: Document upload timestamp
                        ingestionStartedAt:
                          type: string
                          format: date-time
                          nullable: true
                          description: When ingestion processing began
                        ingestionCompletedAt:
                          type: string
                          format: date-time
                          description: Processing completion timestamp
                        ingestionWorkflowId:
                          type: string
                          nullable: true
                          description: >-
                            Durable workflow run ID for the active or last
                            ingestion attempt
                        ingestionError:
                          type: string
                          nullable: true
                          description: >-
                            Failure reason when ingestion status is a failed
                            state
                  count:
                    type: number
                    description: Total number of objects in the vault
              example:
                vaultId: vault_abc123
                objects:
                  - id: obj_xyz789
                    filename: contract_2024_v2.pdf
                    contentType: application/pdf
                    sizeBytes: 2485760
                    ingestionStatus: completed
                    pageCount: 15
                    textLength: 12450
                    chunkCount: 28
                    vectorCount: 28
                    tags:
                      - contract
                      - '2024'
                      - vendor
                    metadata:
                      client: Acme Corp
                      matter: M-2024-001
                    createdAt: '2024-01-15T10:30:00Z'
                    ingestionCompletedAt: '2024-01-15T10:32:15Z'
                count: 1
        '400':
          description: Invalid vault ID provided
        '401':
          description: Invalid or missing API key
        '403':
          description: API key does not have vault service permissions
        '404':
          description: Vault not found or access denied
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key starting with `sk_case_`

````