> ## 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: properties: pages: anyOf: - items: type: integer type: array - type: 'null' default: null title: Pages dpi: default: 200 description: >- Resolution for PDF coordinate scaling. Bounding box coordinates and page dimensions are returned in pixels at this DPI (pixels = PDF_points × dpi / 72). Allowed range: 72–300. Has no effect for image inputs. maximum: 300 minimum: 72 title: Dpi type: integer blocks: $ref: '#/components/schemas/BlocksOptions' grounding: $ref: '#/components/schemas/GroundingOptions' 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. password: type: string description: >- Encrypted PDFs are not currently supported. Providing a password returns a 422 error; decrypt the file before uploading. 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 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. 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: 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 GroundingOptions: properties: parts: default: true title: Parts type: boolean title: GroundingOptions type: object BaseElementOptions: properties: caption: default: true title: Caption type: boolean title: BaseElementOptions type: object TableOptions: properties: caption: default: true title: Caption type: boolean format: default: html enum: - markdown - html title: Format type: string title: TableOptions type: object FigureOptions: properties: caption: default: true title: Caption type: boolean title: FigureOptions type: object ````