---
title: "ADE Get Parse Jobs"
method: GET
path: "/v1/ade/parse/jobs/{job_id}"
tags: ["Tools"]
---

# ADE Get Parse Jobs

`GET /v1/ade/parse/jobs/{job_id}`

Get the status for an async parse job.

Returns the job status or an error
   response. For EU users, use this endpoint:


   `https://api.va.eu-west-1.landing.ai/v1/ade/parse/jobs/{job_id}`.

## Path parameters

- `job_id` string, required

## Response `200`

Successful Response

- JobStatusResponse — Unified response for job status endpoint.
  - `job_id` string, required
  - `status` string, required
  - `received_at` integer, required
  - `created_at` integer — Unix timestamp (seconds) for when the job was created. Mirrors received_at; exposed so clients have an explicit creation time.
  - `progress` number, required — Job completion progress as a decimal from 0 to 1, where 0 is not started, 1 is finished, and values between 0 and 1 indicate work in progress.
  - `org_id` string, nullable
  - `version` string, nullable
  - `data` union — The parsed output (ParseResponse for documents, SpreadsheetParseResponse for spreadsheets), if the job is complete and the `output_save_url` parameter was not used.
    - ParseResponse
      - `markdown` string, required
      - `chunks` ParseChunk[], required
        - `markdown` string, required
        - `type` string, required
        - `id` string, required
        - `grounding` ParseGrounding, required
          - `box` ParseGroundingBox, required
            - `left` number, required
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
          - `page` integer, required
      - `splits` ParseSplit[], required
        - `class` string, required
        - `identifier` string, required
        - `pages` integer[], required
        - `markdown` string, required
        - `chunks` string[], required
      - `grounding` object
      - `metadata` ParseMetadata, required
        - `filename` string, required
        - `org_id` string, nullable, required
        - `page_count` integer, required
        - `duration_ms` integer, required
        - `credit_usage` number, required
        - `job_id` string, required
        - `version` string, nullable, required
        - `failed_pages` integer[]
    - SpreadsheetParseResponse — Response from /ade/parse-spreadsheet endpoint. Similar structure to ParseResponse but without grounding.
      - `markdown` string, required — Full document as HTML with anchor tags and tables
      - `chunks` SpreadsheetChunk[], required — List of table chunks (HTML)
        - `markdown` string, required — Chunk content as HTML table with anchor tag (for tables) or parsed markdown content (for chunks from images)
        - `type` string, required — Chunk type: 'table' for spreadsheet tables, or types from /parse (text, table, figure, form, etc.) for chunks derived from embedded images
        - `id` string, required — Chunk ID - format: '{sheet_name}-{cell_range}' for tables, '{sheet_name}-image-{index}-{anchor_cell}-chunk-{i}-{type}' for parsed image chunks
        - `grounding` ParseGrounding
          - `box` ParseGroundingBox, required
            - `left` number, required
            - `top` number, required
            - `right` number, required
            - `bottom` number, required
          - `page` integer, required
      - `splits` SpreadsheetSplit[], required — Sheet-based splits
        - `class` string, required — Split class: 'page' for per-sheet splits, 'full' for single split with all content
        - `identifier` string, required — Split identifier: sheet name for 'page' splits, 'full' for full split
        - `sheets` integer[], required — Sheet indices: single element for 'page' splits, all indices for 'full' split
        - `markdown` string, required — Combined markdown for this split
        - `chunks` string[], required — Chunk IDs in this split
      - `metadata` SpreadsheetParseMetadata, required — Metadata for spreadsheet parsing result.
        - `filename` string, required — Original filename
        - `org_id` string, nullable — Organization ID
        - `sheet_count` integer, required — Number of sheets processed
        - `total_rows` integer, required — Total rows across all sheets
        - `total_cells` integer, required — Total non-empty cells across all sheets
        - `total_chunks` integer, required — Total chunks (tables + images) extracted
        - `total_images` integer — Total images extracted
        - `duration_ms` integer, required — Processing duration in milliseconds
        - `credit_usage` number — Credits charged
        - `job_id` string — Inference history job ID
        - `version` string, nullable — Model version for parsing images
  - `output_url` string, nullable — The URL to the parsed content. This field contains a URL when the job is complete and either you specified the `output_save_url` parameter or the result is larger than 1MB. When the result exceeds 1MB, the URL is a presigned S3 URL that expires after 1 hour. Each time you GET the job, a new presigned URL is generated.
  - `metadata` ParseMetadata
    - `filename` string, required
    - `org_id` string, nullable, required
    - `page_count` integer, required
    - `duration_ms` integer, required
    - `credit_usage` number, required
    - `job_id` string, required
    - `version` string, nullable, required
    - `failed_pages` integer[]
  - `failure_reason` string, nullable

## Other responses

- `206` — There were some pages that failed to be parsed.
- `404` — Job ID not found
- `422` — Validation Error

---

[API](https://skmtc.net/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e.md) · [All operations](https://skmtc.net/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/landing-ai/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/revisions/b07477df91eb/schema)