> ## Documentation Index > Fetch the complete documentation index at: https://docs.landing.ai/llms.txt > Use this file to discover all available pages before exploring further. # ADE Parse Jobs > 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. ## OpenAPI ````yaml /dpt3/openapi-adev2.json post /v2/parse/jobs openapi: 3.1.0 info: title: >- LandingAI Agentic Document Extraction (ADE) API v2: Parse and Extract Documents with DPT-3 description: >- Parse and extract data from documents with DPT-3, a document parsing model from LandingAI, using the Agentic Document Extraction (ADE) v2 endpoints. Parse converts PDFs and images into structured Markdown and elements with per-element grounding (page numbers and coordinates) for RAG, search, and extraction pipelines. Extract pulls specific fields from parsed Markdown using a JSON schema. Documentation: https://docs.landing.ai version: 1.0.0 servers: - url: https://api.ade.landing.ai description: Production vision tools API security: [] paths: /v2/parse/jobs: post: tags: - Parse summary: ADE Parse Jobs description: >- 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. operationId: parse_create_job requestBody: required: true content: multipart/form-data: schema: type: object properties: document: type: string format: binary description: >- 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: type: string description: >- 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: type: string description: >- 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: additionalProperties: false properties: pages: anyOf: - items: type: integer type: array - type: 'null' default: null title: Pages blocks: $ref: '#/components/schemas/BlocksOptions' atomic_grounding: default: true description: >- Include the fine-grained `atomic_grounding` array on leaf elements. Set `false` to omit the field entirely from every node. title: Atomic Grounding type: boolean inline_markdown: default: false description: >- 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. title: Inline Markdown type: boolean password: anyOf: - type: string - type: 'null' default: null description: >- Password for encrypted PDFs. Not currently supported — providing a value returns a 422 error; decrypt the file before uploading. title: Password title: ParseOptions type: object description: >- 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. output_save_url: type: string description: >- Public URL the full response is delivered to; the API response then carries ``output_url`` instead of inline data. service_tier: type: string enum: - standard - priority description: >- Async service tier (``POST /jobs`` only). ``priority`` runs in the fast lane at the sync billing rate; absent → ``standard``. responses: '202': description: Job created content: application/json: schema: type: object required: - job_id - status - created_at properties: job_id: type: string description: >- The unique identifier for the created parse job. Poll ``GET /v2/parse/jobs/{job_id}`` for its status and result. Format: ``-<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: type: string enum: - pending - processing - completed - failed description: >- 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: type: - string - 'null' description: ISO-8601 timestamp for when the job was created. '422': description: Request validation failed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' x-codeSamples: - lang: cURL label: cURL source: |- curl -X POST 'https://api.ade.landing.ai/v2/parse/jobs' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -F 'document=@document.pdf' \ -F 'model=dpt-3-pro-latest' - lang: Python label: Python source: >- import requests url = 'https://api.ade.landing.ai/v2/parse/jobs' headers = {'Authorization': 'Bearer YOUR_API_KEY'} files = {'document': open('document.pdf', 'rb')} data = {'model': 'dpt-3-pro-latest'} response = requests.post(url, headers=headers, files=files, data=data) print(response.json()) - lang: JavaScript label: Node.js source: |- const axios = require('axios'); const FormData = require('form-data'); const fs = require('fs'); const form = new FormData(); form.append('document', fs.createReadStream('document.pdf')); form.append('model', 'dpt-3-pro-latest'); axios.post('https://api.ade.landing.ai/v2/parse/jobs', form, { headers: { 'Authorization': 'Bearer YOUR_API_KEY', ...form.getHeaders() } }) .then(response => console.log(response.data)) .catch(error => console.error(error)); components: schemas: BlocksOptions: additionalProperties: false properties: text: $ref: '#/components/schemas/BaseElementOptions' table: $ref: '#/components/schemas/TableOptions' figure: $ref: '#/components/schemas/FigureOptions' marginalia: $ref: '#/components/schemas/BaseElementOptions' attestation: $ref: '#/components/schemas/BaseElementOptions' logo: $ref: '#/components/schemas/BaseElementOptions' scan_code: $ref: '#/components/schemas/BaseElementOptions' card: $ref: '#/components/schemas/BaseElementOptions' title: BlocksOptions type: object ErrorResponse: type: object title: ErrorResponse required: - code - message properties: code: type: string description: >- Stable snake_case error code (e.g. ``validation_error``, ``unknown_model_version``, ``invalid_url``, ``invalid_api_key``, ``rate_limit_exceeded``). message: type: string description: Human-readable detail. BaseElementOptions: additionalProperties: false properties: markdown: default: true title: Markdown type: boolean title: BaseElementOptions type: object TableOptions: additionalProperties: false properties: markdown: default: true title: Markdown type: boolean format: default: html enum: - markdown - html title: Format type: string title: TableOptions type: object FigureOptions: additionalProperties: false properties: markdown: default: true title: Markdown type: boolean title: FigureOptions type: object ````