---
title: "Get documents in a table"
method: GET
path: "/v1/tables/{id}/documents"
tags: ["tables"]
---

# Get documents in a table

`GET /v1/tables/{id}/documents`

Returns all documents assigned to a specific table.

## Path parameters

- `id` string, required

## Response `200`

Documents in table

- TableDocumentsResponse
  - `table_id` string
  - `documents` TableDocumentSummary[]
    - `id` string
    - `title` string
    - `total_nodes` integer
    - `tags` string[]
    - `metadata` object — Custom metadata (author, etc.)
    - `created_at` string, date-time
  - `total` integer

## Other responses

- `404` — Table not found
- `500` — Failed to get documents

## Changes

- **2026-01-31** `180d59085b78` — 1 warning, 1 info
  - removed the optional property `documents/items/author` from the response with the `200` status
  - added the optional property `documents/items/metadata` to the response with the `200` status
- **2026-01-30** `9404aa4fdc22` — 1 warning, 1 info
  - removed the optional property `documents/items/metadata` from the response with the `200` status
  - added the optional property `documents/items/author` to the response with the `200` status

[Change history](https://skmtc.dev/brainfish-ai/apis/reasondb-api/changes/v1/tables/:id/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)