---
title: "Read a document header and its indexer runs"
method: GET
path: "/v1/documents/{id}"
tags: ["Documents"]
---

# Read a document header and its indexer runs

`GET /v1/documents/{id}`

## Request

- Base URL: `https://brain.inite.ai`
- URL: `https://brain.inite.ai/v1/documents/{id}`
- Auth: HTTP bearer

Part of the document pipeline — answers `503 feature_disabled` until `DOCUMENT_INGEST_ENABLED=1`. Source: src/documents/documents.controller.ts.

Required scope: `brain:read`.

## Path parameters

- `id` string, required

## Query parameters

- `includeText` '1'

## Response `200`

The document.

- DocumentResponse
  - `charLen` integer, required
  - `chunkCount` integer, required
  - `chunks` DocumentChunk[]
    - `charEnd` integer, required
    - `charStart` integer, required
    - `seq` integer, required
    - `text` string, required
  - `contentHash` string, required
  - `hasContent` boolean, required
  - `id` string, required
  - `kind` string, required
  - `meta` object
  - `occurredAt` string, date-time, required
  - `recorder` string
  - `runs` object[], required
    - `packId` string, required
    - `packVersion` string, required
    - `runId` string, required
    - `status` string, required
  - `status` string, required
  - `userId` string: Per-user memory scope (0128); absent = tenant-global.
  - `vertical` string, required

## Other responses

- `401`: Missing or unknown bearer key.
- `403`: The key lacks the required scope.
- `404`: No such resource in this tenant.
- `503`: The document pipeline is dark (DOCUMENT_INGEST_ENABLED off).

---

[API](https://skmtc.dev/inite/apis/inite-brain-platform-api.md) · [All operations](https://skmtc.dev/inite/apis/inite-brain-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inite/apis/inite-brain-platform-api/revisions/c7c3eb5e304b?raw)