---
title: "Get a saved document's detail, structure outline, and the chats that used it."
method: GET
path: "/v1/documents/{document_id}"
tags: ["v1", "mcp"]
---

# Get a saved document's detail, structure outline, and the chats that used it.

`GET /v1/documents/{document_id}`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/documents/{document_id}`
- Auth: HTTP bearer

One saved document's metadata plus a STRUCTURE outline and the chat sessions that have it
open (prior-chats-per-file). Owner-scoped — 404 if the document isn't yours.

`structure` (always included, token-light, NON-BILLABLE) is the cheap verify step after
any edit: `headings` (level + text + position), `section_count` (heading-anchored), `block_count`
(editable chunks), `media` (image/diagram counts). It answers "did my edit land?" for free —
never export a whole document just to check its structure. Pass include_html=true only when
you need the body.

## Path parameters

- `document_id` string, required

## Query parameters

- `include_html` boolean: When true, also returns the document's full reassembled HTML body (`html`), plus its `page_setup` and `version_id`. Default false returns metadata + structure + prior-chats only, keeping the response token-light. This is the by-id way to read a saved document's body without opening it into a session.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)