---
title: "GET /documents/v2/parse/{parse_id}"
method: GET
path: "/documents/v2/parse/{parse_id}"
tags: ["parse"]
---

# GET /documents/v2/parse/{parse_id}

`GET /documents/v2/parse/{parse_id}`

## Path parameters

- `parse_id` string, required

## Query parameters

- `with_options` boolean

## Response `200`

Parse result details

- ParseResult
  - `parse_id` string — The unique identifier for the parse job This is the same as the value returned from the `POST /documents/v2/parse` endpoint.
  - `dataset_id` string, nullable — If the parse job was scheduled from a dataset, this field contains the dataset id. This is the identifier used in URLs and API endpoints to refer to the dataset.
  - `parsed_pages_count` integer — The number of pages that were parsed successfully. This is the total number of pages that were successfully parsed in the document.
  - `status` 'pending' | 'processing' | 'successful' | 'failure'
  - `error` string, nullable — Error ocurred during any part of the parse execution. This is only populated if the parse operation failed.
  - `pages` Page[], nullable — List of pages parsed from the document. Each page has a list of fragments, which are detected objects such as tables, text, figures, section headers, etc. We also return the detected text, structure of the table(if its a table), and the bounding box of the object.
    - `page_number` integer, required — 1-indexed page number in the document.
    - `page_fragments` PageFragment[], nullable — Vector of text fragments extracted from the page. Each fragment represents a distinct section of text, such as titles, paragraphs, tables, figures, etc.
      - `fragment_type` 'section_header' | 'title' | 'text' | 'table' | 'figure' | 'formula' | 'form' | 'key_value_region' | 'document_index' | 'list_item' | 'table_caption' | 'figure_caption' | 'formula_caption' | 'page_footer' | 'page_header' | 'page_number' | 'signature' | 'strikethrough', required
      - `content` union, required
        - string
        - PageFragmentTable
          - `content` string, required
          - `summary` string, nullable
          - `cells` PageFragmentTableCell[], required
            - `text` string, required
            - `bounding_box` object, required
          - `html` string, nullable
          - `markdown` string, nullable
        - PageFragmentFigure
          - `content` string, required
          - `summary` string, nullable
        - PageFragmentListItem
          - `content` string, required
        - PageFragmentSignature
          - `content` string, required
      - `reading_order` integer, nullable
      - `bbox` object, nullable
    - `dimensions` integer[], nullable — Dimensions is a 2-element vector representing the width and height of the page in points.
  - `chunks` Chunk[] — Chunks of the document. This is a vector of `Chunk` objects, each containing a chunk of the document. The number of chunks depend on the chunking strategy used during parsing.
    - `content` string, required
    - `page_number` integer, required
  - `structured_data` StructuredData[], nullable — Structured data extracted from the document. The structured data is a map where the keys are the schema names provided in the parse request, and the values are `StructuredData` objects containing the structured data extracted from the document. The number of structured data objects depends on the partition strategy **None** - one structured data object for the entire document. **Page** - one structured data object for each page.
    - `data` unknown, required
    - `page_numbers` union, required — Common objects used across multiple endpoints in the API.
      - integer
      - integer[]
    - `schema_name` string, nullable — The name of the schema provided in the structured extraction options of the parse request. This is used to identify the schema used for the structured data extraction.
  - `merged_tables` MergedTable[] — Merged tables extracted from the document. This is a list of `MergedTable` objects containing the merged tables extracted from the document. Tables are merged if they are part of the same logical table.
    - `merged_table_id` string, required
    - `merged_table_html` string, required
    - `start_page` integer, required
    - `end_page` integer, required
    - `pages_merged` integer, required
    - `summary` string, nullable
    - `merge_actions` MergeTableActions, required
      - `pages` integer[], required
      - `target_columns` integer, nullable
  - `page_classes` PageClass[], nullable — Page classes extracted from the document. This is a map where the keys are page class names provided in the parse request under the `page_classification_options` field, and the values are vectors of page numbers (1-indexed) where each page class appears. This is used to categorize pages in the document based on the classification options provided.
    - `page_class` string, required
    - `page_numbers` integer[], required — A list of page numbers (1-indexed) where the page class was detected.
  - `created_at` string — The date and time when the parse job was created. The date is in RFC 3339 format. This can be used to track when the parse job was initiated.
  - `finished_at` string, nullable — The date and time when the parse job was finished. The date is in RFC 3339 format. This can be undefined if the parse job is still in progress or pending.
  - `labels` object — Labels associated with the parse job. These are the key-value, or json, pairs submitted with the parse request. This can be used to categorize or tag the parse job for easier identification and filtering. It can be undefined if no labels were provided in the request.

## Other responses

- `401` — Unauthorized. Invalid or missing credentials
- `403` — Forbidden. You do not have permission to access this resource
- `404` — Parse job not found
- `500` — Internal server error

---

[API](https://skmtc.net/tensorlakeai/apis/tensorlake-api.md) · [All operations](https://skmtc.net/tensorlakeai/apis/tensorlake-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tensorlakeai/tensorlake-api/revisions/fb161f7c0ab7/schema)