---
title: "List all documents in scope"
method: GET
path: "/api-regulated/v1/documents"
tags: ["Documents"]
---

# List all documents in scope

`GET /api-regulated/v1/documents`

## Request

- Base URL: `https://api.currencyguard.com`
- URL: `https://api.currencyguard.com/api-regulated/v1/documents`
- Auth: HTTP bearer

Returns every document the caller can see, each with its owning entity id so callers can group by entity. Intended for search and indexing; use the per-entity documents endpoint when only one entity is needed.

## Response `200`

Documents listed

- DocumentDTO[]
  - `id` string, uuid: The document's stable identifier
  - `documentType` string: The type of document being stored
  - `entityId` string, uuid: The entity this document belongs to
  - `contentType` string: MIME type of the stored file
  - `fileSize` integer: Size of the file in bytes
  - `updatedAt` string: When this revision was written, ISO-8601
  - `piiData` PiiData: Document metadata (filename, tags). Encrypted at rest, decrypted at the edge.
    - `status` string
    - `value` PiiDataValue

## Other responses

- `401`: Not authenticated — [`security/authentication-failed`](/problems/security/authentication-failed/)
- `403`: Not authorized — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)
- `500`: Server error — [`server/internal-error`](/problems/server/internal-error/)

---

[API](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external.md) · [All operations](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/revisions/a1f3f854190d?raw)
