---
title: "List Deal Vaults"
method: GET
path: "/api/external/v2/deals/{deal_id}/vaults"
tags: ["external-v2-documents"]
---

# List Deal Vaults

`GET /api/external/v2/deals/{deal_id}/vaults`

List the vaults on a deal: the private Resources vault and any shared Deal Rooms.

Each item carries ``document_count`` — the number of documents the caller
can read in that vault, i.e. exactly what the documents listing returns for
it. Counted per vault (a deal has only a handful), reusing the same
policy-scoped query builder as the listing so the counts stay consistent.

## Path parameters

- `deal_id` integer, required

## Response `200`

Successful Response

- DealVaultListResponse — OpenAPI schema for GET /api/external/v2/deals/<deal_id>/vaults (list envelope).
  - `request_id` string, required
  - `timestamp` string, required
  - `data` DealVaultResponse[], required
    - `id` integer, required
    - `type` 'resources' | 'shared', required
    - `title` string, nullable
    - `is_default` boolean
    - `document_count` integer
  - `pagination` union, required
    - CursorPaginationResponse
      - `total` integer, required
      - `limit` integer, required
      - `cursor` string, nullable, required
      - `has_more` boolean, required
      - `next_cursor` string, nullable, required
    - OffsetPaginationResponse
      - `total` integer, required
      - `limit` integer, required
      - `offset` integer, required
      - `has_more` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/lev/apis/lev-api.md) · [All operations](https://skmtc.net/lev/apis/lev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lev/lev-api/revisions/a586be7d6d3a/schema)