> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ndi.nace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Parse response format

> document, blocks, chunks, images, and spreadsheet sidecars

A succeeded parse job has `result.result_type: "parse"`. The payload lives on
`result.document`.

```json theme={"dark"}
{
  "result_type": "parse",
  "file_name": "report.pdf",
  "lane": "document",
  "document": {
    "page_count": 96,
    "markdown": "# Annual Report\n\n...",
    "text": null,
    "blocks": null,
    "chunks": []
  },
  "ocr_applied": false,
  "units": 96
}
```

## Formats

`document.markdown`, `document.text`, and `document.blocks` are present only
when you asked for them in `output.formats`. Default is markdown + blocks.

**text** is a plaintext rendering: headings and images stripped, tables flattened.

**blocks** are layout elements with a `Location`:

| `location.kind` | Meaning                                  |
| --------------- | ---------------------------------------- |
| `page_region`   | Page + polygons (normalized coordinates) |
| `sheet_range`   | Spreadsheet cells                        |
| `text_span`     | Character offsets                        |

## Chunks

`chunking.strategy`:

* `none` — `chunks` is empty
* `page` — one `page_region` chunk per page
* `section` — chunks follow section headers

Use chunks for RAG. Use `markdown` for display.

## Images

`output.include_images=true` attaches figure crops on PDF and
`png` / `jpg` / `jpeg` / `webp` uploads. `figures.mode=describe` captions
those blocks. `diagrams.mode=mermaid` keeps flowchart fences.

## Spreadsheets

Workbook results may include `document.spreadsheet.sheets[].cell_map_url` —
an authenticated, job-scoped URL that maps rendered table axes to physical
rows and columns. Fetch it with the same `X-API-Key`. See
`GET /v1/jobs/{job_id}/spreadsheet-cell-maps/{artifact_ref}`.

Converted-PDF artifacts (Office → PDF) are at
`GET /v1/jobs/{job_id}/converted-pdf/{artifact_ref}`.