---
title: "Parse Result"
method: GET
path: "/parse/jobs/{job_id}/results"
tags: ["/parse"]
---

# Parse Result

`GET /parse/jobs/{job_id}/results`

Get the results of a parse job.

Parse job results are retained for up to 30 days after job creation. Fetching results for a parse job that is older than 30 days will return a 404 error.

## Path parameters

- `job_id` string, uuid, required — Unique ID of the parse job

## Query parameters

- `output_types` ParseOutputFormat[] — The desired output format(s) of the parsed file. Must be `markdown-document`, `markdown-per-page`, and/or `blocks-per-page`. Specify multiple values to get multiple formats in the response. `markdown-document` parses the whole document into a single concatenated markdown output. `markdown-per-page` provides markdown output per page. `blocks-per-page` provides a structured JSON representation of the content blocks on each page, sorted by reading order.

## Response `200`

Successful Response

- ParseResultsResponseV1 — /parse results reponse object.
  - `file_name` string, required — The name of the file that was uploaded for parsing
  - `status` 'pending' | 'processing' | 'retrying' | 'completed' | 'failed' | 'cancelled', required
  - `pages` ParsedPage[] — Per-page parse results, containing per-page Markdown (if `markdown-per-page` was requested) and/or per-page `ParsedBlock`s (if `blocks-per-page` was requested).
    - `index` integer, required — The index of the parsed page (zero-indexed)
    - `markdown` string — The parsed, structured Markdown of this page. Present if `markdown-per-page` was among the requested output types.
    - `blocks` ParsedBlock[] — The parsed, structured blocks of this page. Present if `blocks-per-page` was among the requested output types.
      - `id` string, uuid, required — Unique ID of the block
      - `type` 'heading' | 'text' | 'table' | 'figure', required — The type of a parsed block.
      - `bounding_box` BlockBoundingBox, required — Normalized bounding box of a block, as relative percentages of the page width and height.
        - `x0` number, required — The x-coordinate of the top-left corner of the bounding box
        - `y0` number, required — The y-coordinate of the top-left corner of the bounding box
        - `x1` number, required — The x-coordinate of the bottom-right corner of the bounding box
        - `y1` number, required — The y-coordinate of the bottom-right corner of the bounding box
      - `markdown` string, required — The Markdown representation of the block
      - `confidence_level` 'low' | 'medium' | 'high' — The confidence level of a parsed block.
      - `page_index` integer — The page (0-indexed) that this block belongs to. Only set for heading blocks that are returned in the table of contents.
      - `parent_ids` string[] — The IDs of the parent in the document hierarchy, sorted from root-level to bottom. For root-level heading blocks, this will be an empty list. Only present if `enable_document_hierarchy` was set to true in the request.
      - `hierarchy_level` integer — The level of the block in the document hierarchy, starting at 0 for the root-level title block. Only present if `enable_document_hierarchy` was set to true in the request.
  - `markdown_document` string — The parsed, structured Markdown of the input file. Only present if `markdown-document` was among the requested output types.
  - `document_metadata` DocumentMetadata — Metadata about the document that was parsed.
    - `hierarchy` DocumentHierarchy — Document hierarchy within the parsed document
      - `blocks` ParsedBlock[] — Heading blocks which define the hierarchy of the document
        - `id` string, uuid, required — Unique ID of the block
        - `type` 'heading' | 'text' | 'table' | 'figure', required — The type of a parsed block.
        - `bounding_box` BlockBoundingBox, required — Normalized bounding box of a block, as relative percentages of the page width and height.
          - `x0` number, required — The x-coordinate of the top-left corner of the bounding box
          - `y0` number, required — The y-coordinate of the top-left corner of the bounding box
          - `x1` number, required — The x-coordinate of the bottom-right corner of the bounding box
          - `y1` number, required — The y-coordinate of the bottom-right corner of the bounding box
        - `markdown` string, required — The Markdown representation of the block
        - `confidence_level` 'low' | 'medium' | 'high' — The confidence level of a parsed block.
        - `page_index` integer — The page (0-indexed) that this block belongs to. Only set for heading blocks that are returned in the table of contents.
        - `parent_ids` string[] — The IDs of the parent in the document hierarchy, sorted from root-level to bottom. For root-level heading blocks, this will be an empty list. Only present if `enable_document_hierarchy` was set to true in the request.
        - `hierarchy_level` integer — The level of the block in the document hierarchy, starting at 0 for the root-level title block. Only present if `enable_document_hierarchy` was set to true in the request.
      - `table_of_contents` string — Markdown representation of the table of contents for this document

## Other responses

- `422` — Validation Error

## Changes

- **2025-05-13** `8d75c58c83d1` — 1 warning, 1 info
  - removed the optional property `table_of_contents` from the response with the `200` status
  - added the optional property `document_metadata` to the response with the `200` status
- **2025-05-08** `17bdb8a33fb4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/contextualai/apis/endpoints/changes/parse/jobs/:job_id/results/get.md)

---

[API](https://skmtc.dev/contextualai/apis/endpoints.md) · [All operations](https://skmtc.dev/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc.dev/contextualai/apis/endpoints/revisions/ca7f807eec8b?raw)