---
title: "Get the OCR-converted markdown of a document"
method: GET
path: "/v1/documents/{id}/markdown"
tags: ["Documents"]
---

# Get the OCR-converted markdown of a document

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

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/documents/{id}/markdown`
- Auth: HTTP bearer

Returns the full markdown representation produced by OCR for the document.
Equivalent to passing `include_markdown=true` on `/v1/extract`, but callable
at any time after OCR has completed. Useful for PDF-to-markdown conversion
without requiring a schema or re-running extraction.

Returns 404 if the document does not exist, is still being processed, or is
an image that did not produce OCR output.

## Path parameters

- `id` string, uuid, required

## Response `200`

Document markdown.

- object
  - `document_id` string, uuid, required: ID of the document the markdown was produced from.
  - `markdown` string, required: Full OCR-converted markdown body.

## Other responses

- `401`: Missing or invalid API key.
- `404`: The requested resource was not found.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)