---
title: "Get a Parse preview unit"
method: GET
path: "/v1/documents/jobs/{id}/parse-progress/parts/{generation}/{revision}"
tags: ["Documents"]
---

# Get a Parse preview unit

`GET /v1/documents/jobs/{id}/parse-progress/parts/{generation}/{revision}`

## Request

- Base URL: `https://console.nace.ai`
- URL: `https://console.nace.ai/v1/documents/jobs/{id}/parse-progress/parts/{generation}/{revision}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nace/apis/drex-api/docs/v1/documents/jobs/:id/parse-progress/parts/:generation/:revision/get.ts> (a function with typed inputs; its response is checked against the schema)

Read one bounded provisional Markdown unit. Use the content_url returned by a snapshot.

Retained Parse jobs only. Authenticate with the same Bearer key as the job. Previews do not change parsing, cache identity, cost, retention or cancellation. Zero retention and some parsers return only the complete result. See [Parse streaming](/docs/perception/parse#streaming).

## Path parameters

- `id` string, uuid, required
- `generation` string, required
- `revision` string, required

## Response `200`

Current preview metadata or content.

- ParsePreviewContent
  - `generation` string, required: Parser invocation that produced the preview.
  - `index` integer, required: Original page number or selected sheet position.
  - `label` string, required: Page label or sheet name.
  - `markdown` string, required: Provisional Markdown, capped at 64K characters. Final tables and descriptions may differ.
  - `truncated` boolean, required: The preview exceeded its bound; fetch complete text from the final result.
  - `ready_at` string, date-time, required: Server publication timestamp.

## Other responses

- `404`: Job or preview not found, unavailable or inaccessible.
- `410`: Preview content expired.
- `429`: Request rate limit reached; retry after the indicated delay.
- `503`: Upstream unavailable, or a terminal result is awaiting usage settlement.

---

[API](https://skmtc.dev/nace/apis/drex-api.md) - [All operations](https://skmtc.dev/nace/apis/drex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nace/apis/drex-api/revisions/a0e62d925a61?raw)