---
title: "List all documents"
method: GET
path: "/v1/documents"
tags: ["documents"]
---

# List all documents

`GET /v1/documents`

Returns a summary of all ingested documents in the database.

## Response `200`

List of documents

- DocumentSummary[]
  - `id` string
  - `title` string
  - `total_nodes` integer
  - `max_depth` integer
  - `source_path` string
  - `mime_type` string
  - `file_size` integer
  - `table_id` string
  - `tags` string[]
  - `metadata` object
  - `created_at` string, date-time

## Other responses

- `401` — Unauthorized
- `500` — Storage error

## Changes

- **2026-03-01** `308c06c063f5` — 1 info
  - added the non-success response with the status `401`
- **2026-01-31** `180d59085b78` — 1 warning, 1 info
  - removed the optional property `items/author` from the response with the `200` status
  - added the optional property `items/metadata` to the response with the `200` status
- **2026-01-30** `9404aa4fdc22` — 1 warning, 2 info
  - removed the optional property `items/metadata` from the response with the `200` status
  - removed the non-success response with the status `401`
  - added the optional property `items/author` to the response with the `200` status

[Change history](https://skmtc.dev/brainfish-ai/apis/reasondb-api/changes/v1/documents/get.md)

---

[API](https://skmtc.dev/brainfish-ai/apis/reasondb-api.md) · [All operations](https://skmtc.dev/brainfish-ai/apis/reasondb-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brainfish-ai/reasondb-api/revisions/f8665c1a5239/schema)