---
title: "List vault objects"
method: GET
path: "/vault/{id}/objects"
tags: ["Vaults"]
---

# List vault objects

`GET /vault/{id}/objects`

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

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved vault objects

- object
  - `vaultId` string, required — The ID of the vault
  - `objects` object[], required
    - `id` string, required — Unique object identifier
    - `filename` string, required — Original filename of the uploaded document
    - `contentType` string, required — MIME type of the document
    - `sizeBytes` number — File size in bytes
    - `path` string, nullable — Optional folder path for hierarchy preservation from source systems
    - `ingestionStatus` string, required — Processing status of the document
    - `pageCount` number — Number of pages in the document
    - `textLength` number — Total character count of extracted text
    - `chunkCount` number — Number of text chunks created for vectorization
    - `vectorCount` number — Number of vectors generated for semantic search
    - `tags` string[] — Custom tags associated with the document
    - `metadata` object — Custom metadata associated with the document
    - `createdAt` string, date-time, required — Document upload timestamp
    - `ingestionStartedAt` string, date-time, nullable — When ingestion processing began
    - `ingestionCompletedAt` string, date-time — Processing completion timestamp
    - `ingestionWorkflowId` string, nullable — Durable workflow run ID for the active or last ingestion attempt
    - `ingestionError` string, nullable — Failure reason when ingestion status is a failed state
  - `count` number, required — Total number of objects in the vault

## Other responses

- `400` — Invalid vault ID provided
- `401` — Invalid or missing API key
- `403` — API key does not have vault service permissions
- `404` — Vault not found or access denied

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/versions/5b7e64e6d6f9/schema)
