---
title: "ADE Parse Jobs"
method: POST
path: "/v2/parse/jobs"
tags: ["Parse"]
---

# ADE Parse Jobs

`POST /v2/parse/jobs`

## Request

- Base URL: `https://api.ade.landing.ai`
- URL: `https://api.ade.landing.ai/v2/parse/jobs`
- Auth: none required

Parse a document asynchronously. Returns a job ID; use it to poll for the job's status and retrieve the parse result once processing completes.

## Request body `multipart/form-data`

- object
  - `document` string, binary: The file to parse. The file must be a PDF or image; see the list of [supported file types](https://docs.landing.ai/dpt3/file-types). Provide either `document` or `document_url`, not both.
  - `document_url` string: A publicly accessible URL to the file to parse. The file must be a PDF or image; see the list of [supported file types](https://docs.landing.ai/dpt3/file-types). Provide either `document` or `document_url`, not both.
  - `model` string: The DPT-3 model snapshot to use for this request. Accepts a dated snapshot (for example, `dpt-3-pro-20260710`), the `dpt-3-pro-latest` alias, or the bare `dpt-3-pro` family name (equivalent to `dpt-3-pro-latest`). Defaults to the latest DPT-3 Pro snapshot.
  - `options` object: Optional object that customizes the parse. Use it to select which pages to process, adjust how content appears in the Markdown, or control how much detail the response includes. Sent as a JSON-serialized string in form data.
    - `pages` integer[], nullable
    - `blocks` BlocksOptions
      - `text` BaseElementOptions
        - `markdown` boolean
      - `table` TableOptions
        - `markdown` boolean
        - `format` 'markdown' | 'html'
      - `figure` FigureOptions
        - `markdown` boolean
      - `marginalia` BaseElementOptions
        - `markdown` boolean
      - `attestation` BaseElementOptions
        - `markdown` boolean
      - `logo` BaseElementOptions
        - `markdown` boolean
      - `scan_code` BaseElementOptions
        - `markdown` boolean
      - `card` BaseElementOptions
        - `markdown` boolean
    - `atomic_grounding` boolean: Include the fine-grained `atomic_grounding` array on leaf elements. Set `false` to omit the field entirely from every node.
    - `inline_markdown` boolean: Include each node's slice of the document `markdown` inline as a `markdown` field on every structure node: the document root, each page, and each element (including table cells). `atomic_grounding` entries do not carry it.
    - `password` string, nullable: Password for encrypted PDFs. Not currently supported — providing a value returns a 422 error; decrypt the file before uploading.
  - `output_save_url` string: Public URL the full response is delivered to; the API response then carries ``output_url`` instead of inline data.
  - `service_tier` 'standard' | 'priority': Async service tier (``POST /jobs`` only). ``priority`` runs in the fast lane at the sync billing rate; absent → ``standard``.

## Response `202`

Job created

- object
  - `job_id` string, required: The unique identifier for the created parse job. Poll ``GET /v2/parse/jobs/{job_id}`` for its status and result. Format: ``<service>-<26-character Crockford base32 ULID>`` matching ``^(parse|extract)-[0-9a-hjkmnp-tv-z]{26}$``. Opaque, server-minted, and stable for the life of the job — the same id is returned on the sync response, the async 202, and every poll. Treat it as opaque; older id formats remain accepted indefinitely and are never re-issued.
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required: The job's status at creation — normally ``pending`` (a just-created job that is still running is reported as ``pending``), but may already be a terminal ``completed`` / ``failed`` if the job finished before the create response was rendered.
  - `created_at` string, nullable, required: ISO-8601 timestamp for when the job was created.

## Other responses

- `422`: Request validation failed.

---

[API](https://skmtc.dev/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e.md) - [All operations](https://skmtc.dev/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/llms.txt) - [OpenAPI document](https://skmtc.dev/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/revisions/b07477df91eb?raw)