Skip to main content
POST
/
v2
/
parse
/
jobs
cURL
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'
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())
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));
{
  "job_id": "<string>"
}

Body

multipart/form-data
​
document
file

The file to parse. The file must be a PDF or image; see the list of supported 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. 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
ParseOptions · 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.

​
password
string

Encrypted PDFs are not currently supported. Providing a password 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
enum<string>

Async service tier (POST /jobs only). priority runs in the fast lane at the sync billing rate; absent → standard.

Available options:
standard,
priority

Response

202 - application/json

Job created

​
job_id
string
required

The unique identifier for the created parse job. Poll GET /v2/parse/jobs/{job_id} for its status and result.