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.
The DPT-3 model snapshot to use for this request. Accepts a dated snapshot (for example, dpt-3-pro-20260710), a -latest alias, or a bare family name (equivalent to that family's -latest). Two families are available: dpt-3-pro for highest quality, and dpt-3-verity for lower-latency parsing without vision-model captioning. Defaults to the latest DPT-3 Pro snapshot.
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.
Show child attributes
Response
The parse response
The parse result: the full document as markdown, its hierarchical
structure (with per-node spatial grounding inline), and request
metadata.
The document's hierarchical structure: pages and the elements detected on each page. Every node below the root carries its spatial data inline in a grounding object ({page, range, box}, normalized page coordinates); leaf elements additionally carry atomic_grounding.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"LandingAI","colors":{"primary":"#03221D","light":"#DBFF9B","dark":"#43574C"},"logo":{"light":"https://mintcdn.com/landingaitest/zBBru77Y9z-WA7GH/logo/LandingAI-logo-primary-black.svg?fit=max\u0026auto=format\u0026n=zBBru77Y9z-WA7GH\u0026q=85\u0026s=e34765cb4164e3402d50f94476700495","dark":"https://mintcdn.com/landingaitest/zBBru77Y9z-WA7GH/logo/LandingAI-logo-primary-white.svg?fit=max\u0026auto=format\u0026n=zBBru77Y9z-WA7GH\u0026q=85\u0026s=0d22eff6b38153bca7b582be0beb555e"},"favicon":{"light":"https://mintcdn.com/landingaitest/zBBru77Y9z-WA7GH/logo/icon-light.png?fit=max\u0026auto=format\u0026n=zBBru77Y9z-WA7GH\u0026q=85\u0026s=50b223c514903cbbcdf7e3e6a587e3ce","dark":"https://mintcdn.com/landingaitest/zBBru77Y9z-WA7GH/logo/icon-dark.png?fit=max\u0026auto=format\u0026n=zBBru77Y9z-WA7GH\u0026q=85\u0026s=5205edd11d2b3f62fb96cadce83b0262"},"api":{"playground":{"display":"simple"},"examples":{"languages":["python","curl","javascript"]}},"navbar":{"links":[{"href":"https://community.landing.ai/","label":"Community"},{"href":"https://discord.com/invite/RVcW3j9RgR","label":"Discord"},{"href":"mailto:support@landing.ai","label":"Support"}],"primary":{"type":"button","label":"Document Extraction","href":"https://ade.landing.ai/"}},"footer":{"socials":{"website":"https://landing.ai/","discord":"https://discord.com/invite/RVcW3j9RgR","github":"https://github.com/landing-ai","youtube":"https://www.youtube.com/channel/UCYQS3jkfB79Diyr9sQJAj5Q","linkedin":"https://www.linkedin.com/company/landing-ai"}},"seo":{"metatags":{"google-site-verification":"QxVeB4ljHtTtl3rG-tWb-RhE5z8vS_KkeAdO0zZQnqc"}},"integrations":{"amplitude":{"apiKey":"621d889ff8d34866ea7959708792c546"},"ga4":{"measurementId":"G-C0M7PT2EL2"}},"banner":{"content":"Explore ADE Gen2, powered by our newest model, DPT-3. [Get started](/dpt3/overview)!","dismissible":true,"color":{"light":"#43574C","dark":"#43574C"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode","mcp","add-mcp"],"display":"header"},"variables":{"companyName":"LandingAI","ade":"Agentic Document Extraction","parse":"ADE Parse","parseDpt3":"Parse","parseJobs":"Parse Jobs","extract":"ADE Extract","extractDpt3":"Extract","buildExtract":"ADE Build Extract Schema","dpt":"Document Pre-Trained Transformer","dpt1":"DPT-1","dpt2":"DPT-2","dpt3":"DPT-3","dpt3pro":"DPT-3 Pro","dpt3verity":"DPT-3 Verity","adePythonLibrary":"ade-python","adeTypeScriptLibrary":"ade-typescript","split":"ADE Split","splitv2":"ADE Split v2","splitJSON":"split rules","section":"ADE Section","classify":"ADE Classify"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"landingaitest","hasAudioNarration":false,"actualSubdomain":"landingaitest","customDomains":["docs.landing.ai"],"gitSource":{"type":"github","owner":"landing-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ada1ec08f23b9083222bce4","collectionId":"5cea0604-d5c6-4b61-af76-9c3d66fc298b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada1ec08f23b9083222bce4"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ada2d8f3f287dbf34ec8c0e","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Guides","count":87},{"language":"default","tag":"API","count":21},{"language":"default","tag":"Parsing","count":16},{"language":"default","tag":"Sample Code","count":14},{"language":"default","tag":"Extraction","count":14},{"language":"default","tag":"Get Started","count":13},{"language":"default","tag":"Tools","count":12},{"language":"default","tag":"General","count":10},{"language":"default","tag":"Parse Only","count":8},{"language":"default","tag":"CLI","count":8}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@landing.ai","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html:not(.dark) #sidebar-content li[data-active] a{background-color:#c7dccd!important}html:not(.dark) #sidebar-content li:not([data-active]) a:hover{background-color:#f6f6ef!important}body:has(.homepage-section) h1:first-of-type:not(.homepage-title){display:none!important}.homepage-section{padding-bottom:.56rem;max-width:48rem;margin-left:auto;margin-right:auto}.homepage-title{display:block;font-size:2.5rem;font-weight:600;text-align:center;letter-spacing:-.025em;line-height:1.2;margin-bottom:1rem}.homepage-description{max-width:42rem;margin-left:auto;margin-right:auto;padding-left:1rem;padding-right:1rem;margin-top:1rem;font-size:1.125rem;text-align:center;line-height:1.75}.homepage-card-spacing{margin-top:2rem;margin-bottom:1.5rem}@media (min-width:768px){.homepage-title{font-size:3rem}.homepage-section{padding-bottom:.71rem}}html .pricing-table,html .tier-table{display:table!important;width:100%!important;border-collapse:collapse}html .pricing-table td,html .pricing-table th{padding:12px 8px}html .pricing-table th{text-align:center}html .pricing-table td:first-child{text-align:left}html .pricing-table td:not(:first-child){text-align:center}html .tier-table td,html .tier-table th{padding:10px 14px;border:1px solid #d1d5db}html .tier-table th{text-align:center;background-color:#e2e8f0;font-weight:600}html .tier-table td:first-child{text-align:left}html .file-types-table td:not(:first-child),html .tier-table td:not(:first-child){text-align:center}.dark .tier-table th{background-color:#1f2937!important;border-color:#374151}.dark .tier-table td{border-color:#374151}html .check-icon{color:#03221d;font-size:16px}.dark .check-icon{color:#dbff9b}html .cross-icon,html .x-icon{color:#797665;font-size:16px}.dark .cross-icon{color:#b5a8a0}html .x-icon{color:#9ca3af}html .file-types-table th{text-align:center;background-color:#e2e8f0;font-weight:700;padding:12px 16px}html .file-types-table td{padding:8px 16px}html .file-types-table td:first-child{text-align:left}html .file-types-table .section-row{background-color:#f8fafc}html .file-types-table .section-row td{font-weight:600}.dark .file-types-table th{background-color:#1f2937!important}.dark .file-types-table .section-row{background-color:#111827!important}html img.bordered-image{border:1px solid #4a4a4a}.dark img.bordered-image{border:1px solid #6b7280}html img.bordered-image-500{border:1px solid #4a4a4a;max-width:500px}.dark img.bordered-image-500{border:1px solid #6b7280;max-width:500px}"}],"page":{"pagePath":"api-reference/parse/ade-parse","slug":"/api-reference/parse/ade-parse","pageMetadata":{"title":"ADE Parse","description":"Parse a document and return the parse response inline.","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json post /v2/parse","href":"/api-reference/parse/ade-parse","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Parse a document and return the parse response inline.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"ADE Parse","description":"Parse a document and return the parse response inline.","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json post /v2/parse","href":"/api-reference/parse/ade-parse","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/landingaitest/23b0a87b40a0c9a3/google_tag_manager.js"],"openApiReferenceData":{"operation":{"tags":["Parse"],"summary":"ADE Parse","description":"Parse a document and return the parse response inline.","operationId":"parse_run_sync","responses":{"200":"5ab8d61b-66f8-4f41-9d90-2b7ed7a2a56d","206":"7ca7c86d-7eb3-465d-841d-590bcc363fe1","422":"b713fda5-b382-4e08-83c4-2914f1f9204f"},"requestBody":"99924b10-1014-4add-8d3d-a6bb8705dc56","x-codeSamples":[{"lang":"cURL","label":"cURL","source":"curl -X POST 'https://api.ade.landing.ai/v2/parse' \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -F 'document=@document.pdf' \\\n -F 'model=dpt-3-pro-latest'"},{"lang":"Python","label":"Python","source":"import requests\n\nurl = 'https://api.ade.landing.ai/v2/parse'\nheaders = {'Authorization': 'Bearer YOUR_API_KEY'}\n\nfiles = {'document': open('document.pdf', 'rb')}\ndata = {'model': 'dpt-3-pro-latest'}\n\nresponse = requests.post(url, headers=headers, files=files, data=data)\nprint(response.json())"},{"lang":"JavaScript","label":"Node.js","source":"const axios = require('axios');\nconst FormData = require('form-data');\nconst fs = require('fs');\n\nconst form = new FormData();\nform.append('document', fs.createReadStream('document.pdf'));\nform.append('model', 'dpt-3-pro-latest');\n\naxios.post('https://api.ade.landing.ai/v2/parse', form, {\n headers: { 'Authorization': 'Bearer YOUR_API_KEY', ...form.getHeaders() }\n})\n .then(response => console.log(response.data))\n .catch(error => console.error(error));"}],"method":"post","type":"path","servers":["e6e50563-9293-4d25-b6fb-d67b2d75358a"],"security":[],"path":"/v2/parse","baseUrlOptions":["https://api.ade.landing.ai"],"title":"ADE Parse","codeSamples":[{"label":"cURL","lang":"cURL","source":"curl -X POST 'https://api.ade.landing.ai/v2/parse' \\\n -H 'Authorization: Bearer YOUR_API_KEY' \\\n -F 'document=@document.pdf' \\\n -F 'model=dpt-3-pro-latest'"},{"label":"Python","lang":"Python","source":"import requests\n\nurl = 'https://api.ade.landing.ai/v2/parse'\nheaders = {'Authorization': 'Bearer YOUR_API_KEY'}\n\nfiles = {'document': open('document.pdf', 'rb')}\ndata = {'model': 'dpt-3-pro-latest'}\n\nresponse = requests.post(url, headers=headers, files=files, data=data)\nprint(response.json())"},{"label":"Node.js","lang":"JavaScript","source":"const axios = require('axios');\nconst FormData = require('form-data');\nconst fs = require('fs');\n\nconst form = new FormData();\nform.append('document', fs.createReadStream('document.pdf'));\nform.append('model', 'dpt-3-pro-latest');\n\naxios.post('https://api.ade.landing.ai/v2/parse', form, {\n headers: { 'Authorization': 'Bearer YOUR_API_KEY', ...form.getHeaders() }\n})\n .then(response => console.log(response.data))\n .catch(error => console.error(error));"}],"requestExampleLanguages":["python","bash","javascript"],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"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.","uniqueKey":"document","typeLabel":"file"},"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.","uniqueKey":"document_url","typeLabel":"string"},"model":{"type":"string","description":"The DPT-3 model snapshot to use for this request. Accepts a dated snapshot (for example, `dpt-3-pro-20260710`), a `-latest` alias, or a bare family name (equivalent to that family's `-latest`). Two families are available: `dpt-3-pro` for highest quality, and `dpt-3-verity` for lower-latency parsing without vision-model captioning. Defaults to the latest DPT-3 Pro snapshot.","uniqueKey":"model","typeLabel":"string"},"options":{"additionalProperties":false,"properties":{"pages":{"oneOf":[{"type":"array","items":{"type":"integer","uniqueKey":"options.pages.oneOf.0.items.[INDEX]","typeLabel":"integer"},"title":"Pages","uniqueKey":"options.pages.oneOf.0","typeLabel":"integer[]"},{"type":"null","title":"Pages","uniqueKey":"options.pages.oneOf.1","typeLabel":"null"}],"uniqueKey":"options.pages","typeLabel":"integer[] | null"},"blocks":{"additionalProperties":false,"properties":{"text":{"additionalProperties":false,"properties":{"markdown":{"default":true,"title":"Markdown","type":"boolean","uniqueKey":"options.blocks.text.markdown","typeLabel":"boolean"}},"title":"BaseElementOptions","type":"object","uniqueKey":"options.blocks.text","typeLabel":"BaseElementOptions · object"},"table":{"additionalProperties":false,"properties":{"markdown":{"default":true,"title":"Markdown","type":"boolean","uniqueKey":"options.blocks.table.markdown","typeLabel":"boolean"},"format":{"default":"html","enum":["markdown","html"],"title":"Format","type":"string","uniqueKey":"options.blocks.table.format","typeLabel":"enum\u003cstring>"}},"title":"TableOptions","type":"object","uniqueKey":"options.blocks.table","typeLabel":"TableOptions · object"},"figure":{"additionalProperties":false,"properties":{"markdown":{"default":true,"title":"Markdown","type":"boolean","uniqueKey":"options.blocks.figure.markdown","typeLabel":"boolean"}},"title":"FigureOptions","type":"object","uniqueKey":"options.blocks.figure","typeLabel":"FigureOptions · object"},"marginalia":{"additionalProperties":false,"properties":{"markdown":{"default":true,"title":"Markdown","type":"boolean","uniqueKey":"options.blocks.marginalia.markdown","typeLabel":"boolean"}},"title":"BaseElementOptions","type":"object","uniqueKey":"options.blocks.marginalia","typeLabel":"BaseElementOptions · object"},"attestation":{"additionalProperties":false,"properties":{"markdown":{"default":true,"title":"Markdown","type":"boolean","uniqueKey":"options.blocks.attestation.markdown","typeLabel":"boolean"}},"title":"BaseElementOptions","type":"object","uniqueKey":"options.blocks.attestation","typeLabel":"BaseElementOptions · object"},"logo":{"additionalProperties":false,"properties":{"markdown":{"default":true,"title":"Markdown","type":"boolean","uniqueKey":"options.blocks.logo.markdown","typeLabel":"boolean"}},"title":"BaseElementOptions","type":"object","uniqueKey":"options.blocks.logo","typeLabel":"BaseElementOptions · object"},"scan_code":{"additionalProperties":false,"properties":{"markdown":{"default":true,"title":"Markdown","type":"boolean","uniqueKey":"options.blocks.scan_code.markdown","typeLabel":"boolean"}},"title":"BaseElementOptions","type":"object","uniqueKey":"options.blocks.scan_code","typeLabel":"BaseElementOptions · object"},"card":{"additionalProperties":false,"properties":{"markdown":{"default":true,"title":"Markdown","type":"boolean","uniqueKey":"options.blocks.card.markdown","typeLabel":"boolean"}},"title":"BaseElementOptions","type":"object","uniqueKey":"options.blocks.card","typeLabel":"BaseElementOptions · object"}},"title":"BlocksOptions","type":"object","uniqueKey":"options.blocks","typeLabel":"BlocksOptions · object"},"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","uniqueKey":"options.atomic_grounding","typeLabel":"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","uniqueKey":"options.inline_markdown","typeLabel":"boolean"},"password":{"oneOf":[{"type":"string","title":"Password","description":"Password for encrypted PDFs. Not currently supported — providing a value returns a 422 error; decrypt the file before uploading.","uniqueKey":"options.password.oneOf.0","typeLabel":"string"},{"type":"null","title":"Password","description":"Password for encrypted PDFs. Not currently supported — providing a value returns a 422 error; decrypt the file before uploading.","uniqueKey":"options.password.oneOf.1","typeLabel":"null"}],"uniqueKey":"options.password","typeLabel":"string | null"}},"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.","uniqueKey":"options","typeLabel":"ParseOptions · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"document":"\u003cstring>","document_url":"\u003cstring>","model":"\u003cstring>","options":{"pages":[123],"blocks":{"text":{"markdown":true},"table":{"markdown":true,"format":"html"},"figure":{"markdown":true},"marginalia":{"markdown":true},"attestation":{"markdown":true},"logo":{"markdown":true},"scan_code":{"markdown":true},"card":{"markdown":true}},"atomic_grounding":true,"inline_markdown":false,"password":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5ab8d61b-66f8-4f41-9d90-2b7ed7a2a56d":{"description":"The parse response","content":{"application/json":{"schema":{"description":"The parse result: the full document as `markdown`, its hierarchical\n`structure` (with per-node spatial `grounding` inline), and request\n`metadata`.","properties":{"markdown":{"description":"The full document as a single Markdown string, in reading order.","title":"Markdown","type":"string","isRequired":true,"uniqueKey":"markdown","typeLabel":"string"},"metadata":{"description":"Information about the request: model version, page count, duration, billing, and more.","properties":{"job_id":{"oneOf":[{"type":"string","title":"Job Id","description":"The parse job identifier — always server-minted and unique per submit. On the async `/jobs` route this is the id the caller polls. Correlates with the job's entry in your billing dashboard. Format: ``\u003cservice>-\u003c26-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.","isRequired":true,"uniqueKey":"metadata.job_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Job Id","description":"The parse job identifier — always server-minted and unique per submit. On the async `/jobs` route this is the id the caller polls. Correlates with the job's entry in your billing dashboard. Format: ``\u003cservice>-\u003c26-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.","isRequired":true,"uniqueKey":"metadata.job_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.job_id","typeLabel":"string | null"},"model_version":{"oneOf":[{"type":"string","title":"Model Version","description":"The exact model snapshot that parsed the document, e.g. `dpt-3-pro-20260710`.","isRequired":true,"uniqueKey":"metadata.model_version.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model Version","description":"The exact model snapshot that parsed the document, e.g. `dpt-3-pro-20260710`.","isRequired":true,"uniqueKey":"metadata.model_version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.model_version","typeLabel":"string | null"},"page_count":{"oneOf":[{"type":"integer","title":"Page Count","description":"Total number of pages in the source document. Includes pages filtered out by `options.pages`; the actual returned pages are in `structure.children`.","isRequired":true,"uniqueKey":"metadata.page_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Page Count","description":"Total number of pages in the source document. Includes pages filtered out by `options.pages`; the actual returned pages are in `structure.children`.","isRequired":true,"uniqueKey":"metadata.page_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.page_count","typeLabel":"integer | null"},"output_markdown_chars":{"oneOf":[{"type":"integer","title":"Output Markdown Chars","description":"Number of Unicode code points in the returned `markdown` string.","isRequired":true,"uniqueKey":"metadata.output_markdown_chars.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Output Markdown Chars","description":"Number of Unicode code points in the returned `markdown` string.","isRequired":true,"uniqueKey":"metadata.output_markdown_chars.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.output_markdown_chars","typeLabel":"integer | null"},"range_units":{"const":"unicode_codepoints","description":"Units of every `range` offset in the response. Always `\"unicode_codepoints\"` (Unicode code points into `markdown`). Declared explicitly so consumers know how to slice the string — e.g. JavaScript strings are UTF-16, so a naive `.slice()` drifts when the markdown contains astral characters; such consumers must convert code-point offsets to UTF-16 indices first.","title":"Range Units","type":"string","isRequired":true,"uniqueKey":"metadata.range_units","typeLabel":"string"},"openapi_spec":{"description":"URL of the OpenAPI spec covering this API, for inspection and client generation.","title":"Openapi Spec","type":"string","isRequired":true,"uniqueKey":"metadata.openapi_spec","typeLabel":"string"},"failed_pages":{"description":"1-indexed page numbers that failed to parse. Empty when all pages succeed; failed pages also appear in `structure.children` with `status: failed`.","items":{"type":"integer","uniqueKey":"metadata.failed_pages.items.[INDEX]","typeLabel":"integer"},"title":"Failed Pages","type":"array","isRequired":true,"uniqueKey":"metadata.failed_pages","typeLabel":"integer[]"},"duration_ms":{"oneOf":[{"type":"integer","title":"Duration Ms","description":"Total processing time in milliseconds.","isRequired":true,"uniqueKey":"metadata.duration_ms.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Duration Ms","description":"Total processing time in milliseconds.","isRequired":true,"uniqueKey":"metadata.duration_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.duration_ms","typeLabel":"integer | null"},"billing":{"description":"Billing summary: the service tier and the credits charged.","properties":{"service_tier":{"oneOf":[{"type":"string","title":"Service Tier","description":"The service tier the request ran in: `standard` or `priority`. A sync request reports `priority` (same lane, same price).","enum":["standard","priority"],"isRequired":true,"uniqueKey":"metadata.billing.service_tier.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Service Tier","description":"The service tier the request ran in: `standard` or `priority`. A sync request reports `priority` (same lane, same price).","isRequired":true,"uniqueKey":"metadata.billing.service_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.billing.service_tier","typeLabel":"enum\u003cstring> | null"},"total_credits":{"oneOf":[{"type":"number","title":"Total Credits","description":"Credits charged for this request.","isRequired":true,"uniqueKey":"metadata.billing.total_credits.oneOf.0","typeLabel":"number"},{"type":"null","title":"Total Credits","description":"Credits charged for this request.","isRequired":true,"uniqueKey":"metadata.billing.total_credits.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.billing.total_credits","typeLabel":"number | null"}},"required":["service_tier","total_credits"],"title":"ParseBilling","type":"object","isRequired":true,"uniqueKey":"metadata.billing","typeLabel":"ParseBilling · object"}},"required":["job_id","model_version","page_count","output_markdown_chars","range_units","openapi_spec","failed_pages","duration_ms","billing"],"title":"ParseMetadata","type":"object","isRequired":true,"uniqueKey":"metadata","typeLabel":"ParseMetadata · object"},"structure":{"properties":{"type":{"const":"document","default":"document","description":"The node type. Identifies this node as the root of the structure tree.","title":"Type","type":"string","uniqueKey":"structure.type","typeLabel":"string"},"children":{"description":"The pages of the document, in source order.","items":{"properties":{"grounding":{"description":"The page's spatial data: `page` is the 1-indexed page number in the source document (not contiguous when `options.pages` filters out some pages); `range` covers this page's content in the top-level `markdown` string (zero-length `start == end` for failed pages); `box` is always the full page `{0, 0, 1, 1}`.","properties":{"page":{"description":"1-indexed page number this grounding is on. On a page node, the page's own number.","title":"Page","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.page","typeLabel":"integer"},"range":{"description":"`[start, end)` offsets into the top-level `markdown` string covered by this node or segment.","properties":{"start":{"description":"Inclusive start offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"Start","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.range.start","typeLabel":"integer"},"end":{"description":"Exclusive end offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"End","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.range.end","typeLabel":"integer"}},"required":["start","end"],"title":"Range","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.range","typeLabel":"Range · object"},"box":{"description":"Bounding box in normalized page coordinates (`0`–`1` fractions of page width/height, at most 5 decimal places). A page node's box is always the full page `{0, 0, 1, 1}`.","properties":{"xmin":{"description":"Left edge as a fraction of the page width, in `[0, 1]`.","title":"Xmin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box.xmin","typeLabel":"number"},"ymin":{"description":"Top edge as a fraction of the page height, in `[0, 1]`.","title":"Ymin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box.ymin","typeLabel":"number"},"xmax":{"description":"Right edge as a fraction of the page width, in `[0, 1]`.","title":"Xmax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box.xmax","typeLabel":"number"},"ymax":{"description":"Bottom edge as a fraction of the page height, in `[0, 1]`.","title":"Ymax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box.ymax","typeLabel":"number"}},"required":["xmin","ymin","xmax","ymax"],"title":"Box","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box","typeLabel":"Box · object"},"confidence":{"oneOf":[{"type":"number","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].grounding.confidence.oneOf.0","typeLabel":"number"},{"type":"null","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].grounding.confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].grounding.confidence","typeLabel":"number | null"}},"required":["page","range","box"],"title":"Grounding","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding","typeLabel":"Grounding · object"},"type":{"const":"page","default":"page","description":"The node type. Identifies this node as a page in the structure tree.","title":"Type","type":"string","uniqueKey":"structure.children.items.[INDEX].type","typeLabel":"string"},"status":{"default":"ok","description":"Whether this page was parsed successfully (`ok`) or failed (`failed`).","enum":["ok","failed"],"title":"Status","type":"string","uniqueKey":"structure.children.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Failure reason. Present only when `status` is `failed`.","uniqueKey":"structure.children.items.[INDEX].reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Failure reason. Present only when `status` is `failed`.","uniqueKey":"structure.children.items.[INDEX].reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].reason","typeLabel":"string | null"},"children":{"description":"The elements detected on this page, in reading order. Empty for failed pages.","items":{"description":"Hierarchical document element. All non-page elements share this shape.\n\nKeys off `type`; optional fields are excluded from the serialized JSON\nvia ``exclude_none=True`` when not set.","properties":{"type":{"description":"The element type. Determines which optional fields appear on this element.","enum":["text","table","table_cell","figure","marginalia","attestation","logo","card","scan_code"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"id":{"description":"Semantic element id, unique within the document. Format `\u003ctype>-\u003cindex>`, where `\u003cindex>` is a per-type 0-based counter assigned in reading order — `text-0` is the first text element in the document, `figure-0` the first figure, `table_cell-0` the first cell of the first table. Stable within a response but not across re-parses of the same document.","title":"Id","type":"string","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].id","typeLabel":"string"},"grounding":{"description":"The element's spatial data: the page it appears on, its `[start, end)` range in the top-level `markdown` string, and its bounding box in normalized page coordinates.","properties":{"page":{"description":"1-indexed page number this grounding is on. On a page node, the page's own number.","title":"Page","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.page","typeLabel":"integer"},"range":{"description":"`[start, end)` offsets into the top-level `markdown` string covered by this node or segment.","properties":{"start":{"description":"Inclusive start offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"Start","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.range.start","typeLabel":"integer"},"end":{"description":"Exclusive end offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"End","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.range.end","typeLabel":"integer"}},"required":["start","end"],"title":"Range","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.range","typeLabel":"Range · object"},"box":{"description":"Bounding box in normalized page coordinates (`0`–`1` fractions of page width/height, at most 5 decimal places). A page node's box is always the full page `{0, 0, 1, 1}`.","properties":{"xmin":{"description":"Left edge as a fraction of the page width, in `[0, 1]`.","title":"Xmin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box.xmin","typeLabel":"number"},"ymin":{"description":"Top edge as a fraction of the page height, in `[0, 1]`.","title":"Ymin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box.ymin","typeLabel":"number"},"xmax":{"description":"Right edge as a fraction of the page width, in `[0, 1]`.","title":"Xmax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box.xmax","typeLabel":"number"},"ymax":{"description":"Bottom edge as a fraction of the page height, in `[0, 1]`.","title":"Ymax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box.ymax","typeLabel":"number"}},"required":["xmin","ymin","xmax","ymax"],"title":"Box","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box","typeLabel":"Box · object"},"confidence":{"oneOf":[{"type":"number","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.confidence.oneOf.0","typeLabel":"number"},{"type":"null","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.confidence","typeLabel":"number | null"}},"required":["page","range","box"],"title":"Grounding","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding","typeLabel":"Grounding · object"},"atomic_grounding":{"oneOf":[{"type":"array","items":{"description":"Where a node lives: its page, its slice of `markdown`, and its box.\n\nThe same shape is used for page nodes, element nodes, and each\n`atomic_grounding` entry, so any grounding object is self-contained — it\ncan be lifted out of the tree and still locates its content.","properties":{"page":{"description":"1-indexed page number this grounding is on. On a page node, the page's own number.","title":"Page","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].page","typeLabel":"integer"},"range":{"description":"`[start, end)` offsets into the top-level `markdown` string covered by this node or segment.","properties":{"start":{"description":"Inclusive start offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"Start","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].range.start","typeLabel":"integer"},"end":{"description":"Exclusive end offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"End","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].range.end","typeLabel":"integer"}},"required":["start","end"],"title":"Range","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].range","typeLabel":"Range · object"},"box":{"description":"Bounding box in normalized page coordinates (`0`–`1` fractions of page width/height, at most 5 decimal places). A page node's box is always the full page `{0, 0, 1, 1}`.","properties":{"xmin":{"description":"Left edge as a fraction of the page width, in `[0, 1]`.","title":"Xmin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box.xmin","typeLabel":"number"},"ymin":{"description":"Top edge as a fraction of the page height, in `[0, 1]`.","title":"Ymin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box.ymin","typeLabel":"number"},"xmax":{"description":"Right edge as a fraction of the page width, in `[0, 1]`.","title":"Xmax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box.xmax","typeLabel":"number"},"ymax":{"description":"Bottom edge as a fraction of the page height, in `[0, 1]`.","title":"Ymax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box.ymax","typeLabel":"number"}},"required":["xmin","ymin","xmax","ymax"],"title":"Box","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box","typeLabel":"Box · object"},"confidence":{"oneOf":[{"type":"number","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].confidence.oneOf.0","typeLabel":"number"},{"type":"null","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].confidence","typeLabel":"number | null"}},"required":["page","range","box"],"title":"Grounding","type":"object","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX]","typeLabel":"Grounding · object"},"title":"Atomic Grounding","description":"Fine-grained grounding segments, at whichever granularity the model reads at: one entry per visual line for `dpt-3-pro`, one per **word** — each with its `confidence` — for `dpt-3-verity`, including the words inside table cells. Present only on leaf elements — every type except `table`. `[]` in three cases: an element whose markdown is suppressed via `blocks.\u003ctype>.markdown=false`; a `table_cell` on a line-granularity model (a cell has no finer granularity than itself there); and a `table_cell` on a word-granularity model whose words cannot be located in the rendered cell text — a `|` escaped on the way into a pipe table, or a character escaped on the way into an HTML table — where the segments are dropped rather than risk reporting offsets that point at the wrong characters. Any other leaf the model could not segment finer carries a single entry covering the element's full range and box. Omitted entirely when `options.atomic_grounding` is `false`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0","typeLabel":"Grounding · object[]"},{"type":"null","title":"Atomic Grounding","description":"Fine-grained grounding segments, at whichever granularity the model reads at: one entry per visual line for `dpt-3-pro`, one per **word** — each with its `confidence` — for `dpt-3-verity`, including the words inside table cells. Present only on leaf elements — every type except `table`. `[]` in three cases: an element whose markdown is suppressed via `blocks.\u003ctype>.markdown=false`; a `table_cell` on a line-granularity model (a cell has no finer granularity than itself there); and a `table_cell` on a word-granularity model whose words cannot be located in the rendered cell text — a `|` escaped on the way into a pipe table, or a character escaped on the way into an HTML table — where the segments are dropped rather than risk reporting offsets that point at the wrong characters. Any other leaf the model could not segment finer carries a single entry covering the element's full range and box. Omitted entirely when `options.atomic_grounding` is `false`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding","typeLabel":"Grounding · object[] | null"},"children":{"oneOf":[{"type":"array","items":{"oneOf":[{}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].children.oneOf.0.items.[INDEX]","typeLabel":"any"},"title":"Children","description":"The cells (`table_cell` elements) of a `table` element. Present only when `type` is `table`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].children.oneOf.0","typeLabel":"any[]"},{"type":"null","title":"Children","description":"The cells (`table_cell` elements) of a `table` element. Present only when `type` is `table`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].children.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].children","typeLabel":"any[] | null"},"markdown":{"oneOf":[{"type":"string","title":"Markdown","description":"The element's slice of the top-level `markdown` string (`markdown[grounding.range.start:grounding.range.end]`). `\"\"` for zero-length ranges (e.g. blocks suppressed via `blocks.\u003ctype>.markdown=false`). Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].markdown.oneOf.0","typeLabel":"string"},{"type":"null","title":"Markdown","description":"The element's slice of the top-level `markdown` string (`markdown[grounding.range.start:grounding.range.end]`). `\"\"` for zero-length ranges (e.g. blocks suppressed via `blocks.\u003ctype>.markdown=false`). Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].markdown","typeLabel":"string | null"},"row":{"oneOf":[{"type":"integer","title":"Row","description":"0-indexed row position of this cell within its parent `table`. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].row.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Row","description":"0-indexed row position of this cell within its parent `table`. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].row.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].row","typeLabel":"integer | null"},"col":{"oneOf":[{"type":"integer","title":"Col","description":"0-indexed column position of this cell within its parent `table`. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].col.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Col","description":"0-indexed column position of this cell within its parent `table`. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].col.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].col","typeLabel":"integer | null"},"colspan":{"oneOf":[{"type":"integer","title":"Colspan","description":"Number of columns this cell spans. `1` for unmerged cells. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].colspan.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Colspan","description":"Number of columns this cell spans. `1` for unmerged cells. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].colspan.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].colspan","typeLabel":"integer | null"},"rowspan":{"oneOf":[{"type":"integer","title":"Rowspan","description":"Number of rows this cell spans. `1` for unmerged cells. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].rowspan.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Rowspan","description":"Number of rows this cell spans. `1` for unmerged cells. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].rowspan.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].rowspan","typeLabel":"integer | null"}},"required":["type","id","grounding"],"title":"Element","type":"object","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX]","typeLabel":"Element · object"},"title":"Children","type":"array","uniqueKey":"structure.children.items.[INDEX].children","typeLabel":"Element · object[]"},"markdown":{"oneOf":[{"type":"string","title":"Markdown","description":"This page's slice of the top-level `markdown` string (`markdown[grounding.range.start:grounding.range.end]`). `\"\"` for failed pages. Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.children.items.[INDEX].markdown.oneOf.0","typeLabel":"string"},{"type":"null","title":"Markdown","description":"This page's slice of the top-level `markdown` string (`markdown[grounding.range.start:grounding.range.end]`). `\"\"` for failed pages. Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.children.items.[INDEX].markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].markdown","typeLabel":"string | null"}},"required":["grounding"],"title":"Page","type":"object","uniqueKey":"structure.children.items.[INDEX]","typeLabel":"Page · object"},"title":"Children","type":"array","uniqueKey":"structure.children","typeLabel":"Page · object[]"},"markdown":{"oneOf":[{"type":"string","title":"Markdown","description":"The full document markdown — identical to the top-level `markdown` field, included so the structure tree is self-contained. Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.markdown.oneOf.0","typeLabel":"string"},{"type":"null","title":"Markdown","description":"The full document markdown — identical to the top-level `markdown` field, included so the structure tree is self-contained. Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.markdown","typeLabel":"string | null"}},"title":"Document","type":"object","description":"The document's hierarchical structure: pages and the elements detected on each page. Every node below the root carries its spatial data inline in a `grounding` object (`{page, range, box}`, normalized page coordinates); leaf elements additionally carry `atomic_grounding`.","isRequired":true,"uniqueKey":"structure","typeLabel":"Document · object"}},"required":["markdown","metadata","structure"],"title":"ParseResponse","type":"object","uniqueKey":"","typeLabel":"ParseResponse · object"},"examples":{"Example":{"title":"Example","value":{"markdown":"\u003cstring>","metadata":{"job_id":"\u003cstring>","model_version":"\u003cstring>","page_count":123,"output_markdown_chars":123,"range_units":"unicode_codepoints","openapi_spec":"\u003cstring>","failed_pages":[123],"duration_ms":123,"billing":{"service_tier":"standard","total_credits":123}},"structure":{"type":"document","children":[{"grounding":{"page":123,"range":{"start":123,"end":123},"box":{"xmin":123,"ymin":123,"xmax":123,"ymax":123},"confidence":123},"type":"page","status":"ok","reason":"\u003cstring>","children":[{"type":"text","id":"\u003cstring>","grounding":{"page":123,"range":{"start":123,"end":123},"box":{"xmin":123,"ymin":123,"xmax":123,"ymax":123},"confidence":123},"atomic_grounding":[{"page":123,"range":{"start":123,"end":123},"box":{"xmin":123,"ymin":123,"xmax":123,"ymax":123},"confidence":123}],"children":["\u003cunknown>"],"markdown":"\u003cstring>","row":123,"col":123,"colspan":123,"rowspan":123}],"markdown":"\u003cstring>"}],"markdown":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7ca7c86d-7eb3-465d-841d-590bcc363fe1":{"description":"Partial success (some pages failed to parse)","content":{"application/json":{"schema":{"description":"The parse result: the full document as `markdown`, its hierarchical\n`structure` (with per-node spatial `grounding` inline), and request\n`metadata`.","properties":{"markdown":{"description":"The full document as a single Markdown string, in reading order.","title":"Markdown","type":"string","isRequired":true,"uniqueKey":"markdown","typeLabel":"string"},"metadata":{"description":"Information about the request: model version, page count, duration, billing, and more.","properties":{"job_id":{"oneOf":[{"type":"string","title":"Job Id","description":"The parse job identifier — always server-minted and unique per submit. On the async `/jobs` route this is the id the caller polls. Correlates with the job's entry in your billing dashboard. Format: ``\u003cservice>-\u003c26-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.","isRequired":true,"uniqueKey":"metadata.job_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Job Id","description":"The parse job identifier — always server-minted and unique per submit. On the async `/jobs` route this is the id the caller polls. Correlates with the job's entry in your billing dashboard. Format: ``\u003cservice>-\u003c26-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.","isRequired":true,"uniqueKey":"metadata.job_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.job_id","typeLabel":"string | null"},"model_version":{"oneOf":[{"type":"string","title":"Model Version","description":"The exact model snapshot that parsed the document, e.g. `dpt-3-pro-20260710`.","isRequired":true,"uniqueKey":"metadata.model_version.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model Version","description":"The exact model snapshot that parsed the document, e.g. `dpt-3-pro-20260710`.","isRequired":true,"uniqueKey":"metadata.model_version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.model_version","typeLabel":"string | null"},"page_count":{"oneOf":[{"type":"integer","title":"Page Count","description":"Total number of pages in the source document. Includes pages filtered out by `options.pages`; the actual returned pages are in `structure.children`.","isRequired":true,"uniqueKey":"metadata.page_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Page Count","description":"Total number of pages in the source document. Includes pages filtered out by `options.pages`; the actual returned pages are in `structure.children`.","isRequired":true,"uniqueKey":"metadata.page_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.page_count","typeLabel":"integer | null"},"output_markdown_chars":{"oneOf":[{"type":"integer","title":"Output Markdown Chars","description":"Number of Unicode code points in the returned `markdown` string.","isRequired":true,"uniqueKey":"metadata.output_markdown_chars.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Output Markdown Chars","description":"Number of Unicode code points in the returned `markdown` string.","isRequired":true,"uniqueKey":"metadata.output_markdown_chars.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.output_markdown_chars","typeLabel":"integer | null"},"range_units":{"const":"unicode_codepoints","description":"Units of every `range` offset in the response. Always `\"unicode_codepoints\"` (Unicode code points into `markdown`). Declared explicitly so consumers know how to slice the string — e.g. JavaScript strings are UTF-16, so a naive `.slice()` drifts when the markdown contains astral characters; such consumers must convert code-point offsets to UTF-16 indices first.","title":"Range Units","type":"string","isRequired":true,"uniqueKey":"metadata.range_units","typeLabel":"string"},"openapi_spec":{"description":"URL of the OpenAPI spec covering this API, for inspection and client generation.","title":"Openapi Spec","type":"string","isRequired":true,"uniqueKey":"metadata.openapi_spec","typeLabel":"string"},"failed_pages":{"description":"1-indexed page numbers that failed to parse. Empty when all pages succeed; failed pages also appear in `structure.children` with `status: failed`.","items":{"type":"integer","uniqueKey":"metadata.failed_pages.items.[INDEX]","typeLabel":"integer"},"title":"Failed Pages","type":"array","isRequired":true,"uniqueKey":"metadata.failed_pages","typeLabel":"integer[]"},"duration_ms":{"oneOf":[{"type":"integer","title":"Duration Ms","description":"Total processing time in milliseconds.","isRequired":true,"uniqueKey":"metadata.duration_ms.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Duration Ms","description":"Total processing time in milliseconds.","isRequired":true,"uniqueKey":"metadata.duration_ms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.duration_ms","typeLabel":"integer | null"},"billing":{"description":"Billing summary: the service tier and the credits charged.","properties":{"service_tier":{"oneOf":[{"type":"string","title":"Service Tier","description":"The service tier the request ran in: `standard` or `priority`. A sync request reports `priority` (same lane, same price).","enum":["standard","priority"],"isRequired":true,"uniqueKey":"metadata.billing.service_tier.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Service Tier","description":"The service tier the request ran in: `standard` or `priority`. A sync request reports `priority` (same lane, same price).","isRequired":true,"uniqueKey":"metadata.billing.service_tier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.billing.service_tier","typeLabel":"enum\u003cstring> | null"},"total_credits":{"oneOf":[{"type":"number","title":"Total Credits","description":"Credits charged for this request.","isRequired":true,"uniqueKey":"metadata.billing.total_credits.oneOf.0","typeLabel":"number"},{"type":"null","title":"Total Credits","description":"Credits charged for this request.","isRequired":true,"uniqueKey":"metadata.billing.total_credits.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"metadata.billing.total_credits","typeLabel":"number | null"}},"required":["service_tier","total_credits"],"title":"ParseBilling","type":"object","isRequired":true,"uniqueKey":"metadata.billing","typeLabel":"ParseBilling · object"}},"required":["job_id","model_version","page_count","output_markdown_chars","range_units","openapi_spec","failed_pages","duration_ms","billing"],"title":"ParseMetadata","type":"object","isRequired":true,"uniqueKey":"metadata","typeLabel":"ParseMetadata · object"},"structure":{"properties":{"type":{"const":"document","default":"document","description":"The node type. Identifies this node as the root of the structure tree.","title":"Type","type":"string","uniqueKey":"structure.type","typeLabel":"string"},"children":{"description":"The pages of the document, in source order.","items":{"properties":{"grounding":{"description":"The page's spatial data: `page` is the 1-indexed page number in the source document (not contiguous when `options.pages` filters out some pages); `range` covers this page's content in the top-level `markdown` string (zero-length `start == end` for failed pages); `box` is always the full page `{0, 0, 1, 1}`.","properties":{"page":{"description":"1-indexed page number this grounding is on. On a page node, the page's own number.","title":"Page","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.page","typeLabel":"integer"},"range":{"description":"`[start, end)` offsets into the top-level `markdown` string covered by this node or segment.","properties":{"start":{"description":"Inclusive start offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"Start","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.range.start","typeLabel":"integer"},"end":{"description":"Exclusive end offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"End","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.range.end","typeLabel":"integer"}},"required":["start","end"],"title":"Range","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.range","typeLabel":"Range · object"},"box":{"description":"Bounding box in normalized page coordinates (`0`–`1` fractions of page width/height, at most 5 decimal places). A page node's box is always the full page `{0, 0, 1, 1}`.","properties":{"xmin":{"description":"Left edge as a fraction of the page width, in `[0, 1]`.","title":"Xmin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box.xmin","typeLabel":"number"},"ymin":{"description":"Top edge as a fraction of the page height, in `[0, 1]`.","title":"Ymin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box.ymin","typeLabel":"number"},"xmax":{"description":"Right edge as a fraction of the page width, in `[0, 1]`.","title":"Xmax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box.xmax","typeLabel":"number"},"ymax":{"description":"Bottom edge as a fraction of the page height, in `[0, 1]`.","title":"Ymax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box.ymax","typeLabel":"number"}},"required":["xmin","ymin","xmax","ymax"],"title":"Box","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding.box","typeLabel":"Box · object"},"confidence":{"oneOf":[{"type":"number","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].grounding.confidence.oneOf.0","typeLabel":"number"},{"type":"null","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].grounding.confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].grounding.confidence","typeLabel":"number | null"}},"required":["page","range","box"],"title":"Grounding","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].grounding","typeLabel":"Grounding · object"},"type":{"const":"page","default":"page","description":"The node type. Identifies this node as a page in the structure tree.","title":"Type","type":"string","uniqueKey":"structure.children.items.[INDEX].type","typeLabel":"string"},"status":{"default":"ok","description":"Whether this page was parsed successfully (`ok`) or failed (`failed`).","enum":["ok","failed"],"title":"Status","type":"string","uniqueKey":"structure.children.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"type":"string","title":"Reason","description":"Failure reason. Present only when `status` is `failed`.","uniqueKey":"structure.children.items.[INDEX].reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","description":"Failure reason. Present only when `status` is `failed`.","uniqueKey":"structure.children.items.[INDEX].reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].reason","typeLabel":"string | null"},"children":{"description":"The elements detected on this page, in reading order. Empty for failed pages.","items":{"description":"Hierarchical document element. All non-page elements share this shape.\n\nKeys off `type`; optional fields are excluded from the serialized JSON\nvia ``exclude_none=True`` when not set.","properties":{"type":{"description":"The element type. Determines which optional fields appear on this element.","enum":["text","table","table_cell","figure","marginalia","attestation","logo","card","scan_code"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"id":{"description":"Semantic element id, unique within the document. Format `\u003ctype>-\u003cindex>`, where `\u003cindex>` is a per-type 0-based counter assigned in reading order — `text-0` is the first text element in the document, `figure-0` the first figure, `table_cell-0` the first cell of the first table. Stable within a response but not across re-parses of the same document.","title":"Id","type":"string","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].id","typeLabel":"string"},"grounding":{"description":"The element's spatial data: the page it appears on, its `[start, end)` range in the top-level `markdown` string, and its bounding box in normalized page coordinates.","properties":{"page":{"description":"1-indexed page number this grounding is on. On a page node, the page's own number.","title":"Page","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.page","typeLabel":"integer"},"range":{"description":"`[start, end)` offsets into the top-level `markdown` string covered by this node or segment.","properties":{"start":{"description":"Inclusive start offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"Start","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.range.start","typeLabel":"integer"},"end":{"description":"Exclusive end offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"End","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.range.end","typeLabel":"integer"}},"required":["start","end"],"title":"Range","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.range","typeLabel":"Range · object"},"box":{"description":"Bounding box in normalized page coordinates (`0`–`1` fractions of page width/height, at most 5 decimal places). A page node's box is always the full page `{0, 0, 1, 1}`.","properties":{"xmin":{"description":"Left edge as a fraction of the page width, in `[0, 1]`.","title":"Xmin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box.xmin","typeLabel":"number"},"ymin":{"description":"Top edge as a fraction of the page height, in `[0, 1]`.","title":"Ymin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box.ymin","typeLabel":"number"},"xmax":{"description":"Right edge as a fraction of the page width, in `[0, 1]`.","title":"Xmax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box.xmax","typeLabel":"number"},"ymax":{"description":"Bottom edge as a fraction of the page height, in `[0, 1]`.","title":"Ymax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box.ymax","typeLabel":"number"}},"required":["xmin","ymin","xmax","ymax"],"title":"Box","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.box","typeLabel":"Box · object"},"confidence":{"oneOf":[{"type":"number","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.confidence.oneOf.0","typeLabel":"number"},{"type":"null","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding.confidence","typeLabel":"number | null"}},"required":["page","range","box"],"title":"Grounding","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].grounding","typeLabel":"Grounding · object"},"atomic_grounding":{"oneOf":[{"type":"array","items":{"description":"Where a node lives: its page, its slice of `markdown`, and its box.\n\nThe same shape is used for page nodes, element nodes, and each\n`atomic_grounding` entry, so any grounding object is self-contained — it\ncan be lifted out of the tree and still locates its content.","properties":{"page":{"description":"1-indexed page number this grounding is on. On a page node, the page's own number.","title":"Page","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].page","typeLabel":"integer"},"range":{"description":"`[start, end)` offsets into the top-level `markdown` string covered by this node or segment.","properties":{"start":{"description":"Inclusive start offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"Start","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].range.start","typeLabel":"integer"},"end":{"description":"Exclusive end offset into the top-level `markdown` string, in the units declared by `metadata.range_units` (Unicode code points).","title":"End","type":"integer","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].range.end","typeLabel":"integer"}},"required":["start","end"],"title":"Range","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].range","typeLabel":"Range · object"},"box":{"description":"Bounding box in normalized page coordinates (`0`–`1` fractions of page width/height, at most 5 decimal places). A page node's box is always the full page `{0, 0, 1, 1}`.","properties":{"xmin":{"description":"Left edge as a fraction of the page width, in `[0, 1]`.","title":"Xmin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box.xmin","typeLabel":"number"},"ymin":{"description":"Top edge as a fraction of the page height, in `[0, 1]`.","title":"Ymin","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box.ymin","typeLabel":"number"},"xmax":{"description":"Right edge as a fraction of the page width, in `[0, 1]`.","title":"Xmax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box.xmax","typeLabel":"number"},"ymax":{"description":"Bottom edge as a fraction of the page height, in `[0, 1]`.","title":"Ymax","type":"number","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box.ymax","typeLabel":"number"}},"required":["xmin","ymin","xmax","ymax"],"title":"Box","type":"object","isRequired":true,"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].box","typeLabel":"Box · object"},"confidence":{"oneOf":[{"type":"number","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].confidence.oneOf.0","typeLabel":"number"},{"type":"null","title":"Confidence","description":"How sure the model is of the text in this segment, in `[0, 1]`. Present only on word-granularity `atomic_grounding` entries (`dpt-3-verity`), where it is the lowest per-character OCR confidence in the word — so a word is only as trustworthy as its weakest character. Omitted on node-level grounding and on models that ground at line granularity.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX].confidence","typeLabel":"number | null"}},"required":["page","range","box"],"title":"Grounding","type":"object","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0.items.[INDEX]","typeLabel":"Grounding · object"},"title":"Atomic Grounding","description":"Fine-grained grounding segments, at whichever granularity the model reads at: one entry per visual line for `dpt-3-pro`, one per **word** — each with its `confidence` — for `dpt-3-verity`, including the words inside table cells. Present only on leaf elements — every type except `table`. `[]` in three cases: an element whose markdown is suppressed via `blocks.\u003ctype>.markdown=false`; a `table_cell` on a line-granularity model (a cell has no finer granularity than itself there); and a `table_cell` on a word-granularity model whose words cannot be located in the rendered cell text — a `|` escaped on the way into a pipe table, or a character escaped on the way into an HTML table — where the segments are dropped rather than risk reporting offsets that point at the wrong characters. Any other leaf the model could not segment finer carries a single entry covering the element's full range and box. Omitted entirely when `options.atomic_grounding` is `false`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.0","typeLabel":"Grounding · object[]"},{"type":"null","title":"Atomic Grounding","description":"Fine-grained grounding segments, at whichever granularity the model reads at: one entry per visual line for `dpt-3-pro`, one per **word** — each with its `confidence` — for `dpt-3-verity`, including the words inside table cells. Present only on leaf elements — every type except `table`. `[]` in three cases: an element whose markdown is suppressed via `blocks.\u003ctype>.markdown=false`; a `table_cell` on a line-granularity model (a cell has no finer granularity than itself there); and a `table_cell` on a word-granularity model whose words cannot be located in the rendered cell text — a `|` escaped on the way into a pipe table, or a character escaped on the way into an HTML table — where the segments are dropped rather than risk reporting offsets that point at the wrong characters. Any other leaf the model could not segment finer carries a single entry covering the element's full range and box. Omitted entirely when `options.atomic_grounding` is `false`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].atomic_grounding","typeLabel":"Grounding · object[] | null"},"children":{"oneOf":[{"type":"array","items":{"oneOf":[{}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].children.oneOf.0.items.[INDEX]","typeLabel":"any"},"title":"Children","description":"The cells (`table_cell` elements) of a `table` element. Present only when `type` is `table`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].children.oneOf.0","typeLabel":"any[]"},{"type":"null","title":"Children","description":"The cells (`table_cell` elements) of a `table` element. Present only when `type` is `table`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].children.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].children","typeLabel":"any[] | null"},"markdown":{"oneOf":[{"type":"string","title":"Markdown","description":"The element's slice of the top-level `markdown` string (`markdown[grounding.range.start:grounding.range.end]`). `\"\"` for zero-length ranges (e.g. blocks suppressed via `blocks.\u003ctype>.markdown=false`). Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].markdown.oneOf.0","typeLabel":"string"},{"type":"null","title":"Markdown","description":"The element's slice of the top-level `markdown` string (`markdown[grounding.range.start:grounding.range.end]`). `\"\"` for zero-length ranges (e.g. blocks suppressed via `blocks.\u003ctype>.markdown=false`). Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].markdown","typeLabel":"string | null"},"row":{"oneOf":[{"type":"integer","title":"Row","description":"0-indexed row position of this cell within its parent `table`. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].row.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Row","description":"0-indexed row position of this cell within its parent `table`. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].row.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].row","typeLabel":"integer | null"},"col":{"oneOf":[{"type":"integer","title":"Col","description":"0-indexed column position of this cell within its parent `table`. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].col.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Col","description":"0-indexed column position of this cell within its parent `table`. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].col.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].col","typeLabel":"integer | null"},"colspan":{"oneOf":[{"type":"integer","title":"Colspan","description":"Number of columns this cell spans. `1` for unmerged cells. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].colspan.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Colspan","description":"Number of columns this cell spans. `1` for unmerged cells. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].colspan.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].colspan","typeLabel":"integer | null"},"rowspan":{"oneOf":[{"type":"integer","title":"Rowspan","description":"Number of rows this cell spans. `1` for unmerged cells. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].rowspan.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Rowspan","description":"Number of rows this cell spans. `1` for unmerged cells. Present only on `table_cell` elements.","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].rowspan.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX].rowspan","typeLabel":"integer | null"}},"required":["type","id","grounding"],"title":"Element","type":"object","uniqueKey":"structure.children.items.[INDEX].children.items.[INDEX]","typeLabel":"Element · object"},"title":"Children","type":"array","uniqueKey":"structure.children.items.[INDEX].children","typeLabel":"Element · object[]"},"markdown":{"oneOf":[{"type":"string","title":"Markdown","description":"This page's slice of the top-level `markdown` string (`markdown[grounding.range.start:grounding.range.end]`). `\"\"` for failed pages. Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.children.items.[INDEX].markdown.oneOf.0","typeLabel":"string"},{"type":"null","title":"Markdown","description":"This page's slice of the top-level `markdown` string (`markdown[grounding.range.start:grounding.range.end]`). `\"\"` for failed pages. Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.children.items.[INDEX].markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.children.items.[INDEX].markdown","typeLabel":"string | null"}},"required":["grounding"],"title":"Page","type":"object","uniqueKey":"structure.children.items.[INDEX]","typeLabel":"Page · object"},"title":"Children","type":"array","uniqueKey":"structure.children","typeLabel":"Page · object[]"},"markdown":{"oneOf":[{"type":"string","title":"Markdown","description":"The full document markdown — identical to the top-level `markdown` field, included so the structure tree is self-contained. Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.markdown.oneOf.0","typeLabel":"string"},{"type":"null","title":"Markdown","description":"The full document markdown — identical to the top-level `markdown` field, included so the structure tree is self-contained. Present only when `options.inline_markdown` is `true`.","uniqueKey":"structure.markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"structure.markdown","typeLabel":"string | null"}},"title":"Document","type":"object","description":"The document's hierarchical structure: pages and the elements detected on each page. Every node below the root carries its spatial data inline in a `grounding` object (`{page, range, box}`, normalized page coordinates); leaf elements additionally carry `atomic_grounding`.","isRequired":true,"uniqueKey":"structure","typeLabel":"Document · object"}},"required":["markdown","metadata","structure"],"title":"ParseResponse","type":"object","uniqueKey":"","typeLabel":"ParseResponse · object"},"examples":{"Example":{"title":"Example","value":{"markdown":"\u003cstring>","metadata":{"job_id":"\u003cstring>","model_version":"\u003cstring>","page_count":123,"output_markdown_chars":123,"range_units":"unicode_codepoints","openapi_spec":"\u003cstring>","failed_pages":[123],"duration_ms":123,"billing":{"service_tier":"standard","total_credits":123}},"structure":{"type":"document","children":[{"grounding":{"page":123,"range":{"start":123,"end":123},"box":{"xmin":123,"ymin":123,"xmax":123,"ymax":123},"confidence":123},"type":"page","status":"ok","reason":"\u003cstring>","children":[{"type":"text","id":"\u003cstring>","grounding":{"page":123,"range":{"start":123,"end":123},"box":{"xmin":123,"ymin":123,"xmax":123,"ymax":123},"confidence":123},"atomic_grounding":[{"page":123,"range":{"start":123,"end":123},"box":{"xmin":123,"ymin":123,"xmax":123,"ymax":123},"confidence":123}],"children":["\u003cunknown>"],"markdown":"\u003cstring>","row":123,"col":123,"colspan":123,"rowspan":123}],"markdown":"\u003cstring>"}],"markdown":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b713fda5-b382-4e08-83c4-2914f1f9204f":{"description":"Request validation failed.","content":{"application/json":{"schema":{"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``).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable detail.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"e6e50563-9293-4d25-b6fb-d67b2d75358a":{"url":"https://api.ade.landing.ai","description":"Production API"}}},"originalFileLocation":"dpt3/openapi-adev2.json"},"subdomain":"landingaitest","siteName":"LandingAI","title":"ADE Parse - LandingAI","navMaps":{"firstHrefInVersion":{"Gen1 (DPT-2, Legacy)":{"href":"/api-reference/tools/ade-parse","matchLevel":1},"Gen2 (DPT-3)":{"href":"/api-reference/parse/ade-parse","matchLevel":0},"Split v2 (Preview)":{"href":"/splitv2/splitv2","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-09-21T22:18:59.713Z","originalFileLocation":"api-reference/parse/ade-parse.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Parse a document and return the parse response inline.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LandingAI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"ADE Parse - LandingAI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Parse a document and return the parse response inline.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LandingAI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.landing.ai/api-reference/parse/ade-parse\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://landingaitest.mintlify.app/_mintlify/api/og/v2?division=Parse\u0026amp;title=ADE+Parse\u0026amp;description=Parse+a+document+and+return+the+parse+response+inline.\u0026amp;theme=a34bf4f81d76c424de69fa35\u0026amp;signature=180fbd5c4909aeb1e794ee297445377e350672ea321947e43d1d7166a47cbe36\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"ADE Parse - LandingAI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Parse a document and return the parse response inline.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://landingaitest.mintlify.app/_mintlify/api/og/v2?division=Parse\u0026amp;title=ADE+Parse\u0026amp;description=Parse+a+document+and+return+the+parse+response+inline.\u0026amp;theme=a34bf4f81d76c424de69fa35\u0026amp;signature=180fbd5c4909aeb1e794ee297445377e350672ea321947e43d1d7166a47cbe36\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/landingaitest/Dc4syFQMsb5qgeI1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LandingAI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#03221D\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"QxVeB4ljHtTtl3rG-tWb-RhE5z8vS_KkeAdO0zZQnqc\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.landing.ai/api-reference/parse/ade-parse\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/parse/ade-parse.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.landing.ai/#organization\",\"name\":\"LandingAI\",\"url\":\"https://docs.landing.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/landingaitest/zBBru77Y9z-WA7GH/logo/LandingAI-logo-primary-black.svg?fit=max\u0026auto=format\u0026n=zBBru77Y9z-WA7GH\u0026q=85\u0026s=e34765cb4164e3402d50f94476700495\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.landing.ai#website\",\"name\":\"LandingAI\",\"url\":\"https://docs.landing.ai\",\"publisher\":{\"@id\":\"https://docs.landing.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.landing.ai/api-reference/parse/ade-parse#webpage\",\"url\":\"https://docs.landing.ai/api-reference/parse/ade-parse\",\"name\":\"ADE Parse\",\"description\":\"Parse a document and return the parse response inline.\",\"dateModified\":\"2026-09-21T22:18:59.713Z\",\"isPartOf\":{\"@id\":\"https://docs.landing.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.landing.ai/api-reference/parse/ade-parse#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.landing.ai/api-reference/parse/ade-parse#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"LandingAI\",\"item\":\"https://docs.landing.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ADE Parse\",\"item\":\"https://docs.landing.ai/api-reference/parse/ade-parse\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.landing.ai/api-reference/parse/ade-parse#apireference\",\"headline\":\"ADE Parse\",\"name\":\"ADE Parse\",\"description\":\"Parse a document and return the parse response inline.\",\"url\":\"https://docs.landing.ai/api-reference/parse/ade-parse\",\"mainEntityOfPage\":{\"@id\":\"https://docs.landing.ai/api-reference/parse/ade-parse#webpage\"},\"dateModified\":\"2026-09-21T22:18:59.713Z\",\"publisher\":{\"@id\":\"https://docs.landing.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.landing.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LandingAI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LandingAI","nav":{"global":null,"versions":[{"version":"Gen1 (DPT-2, Legacy)","pages":[{"title":"Gen1 (DPT-2, Legacy)","href":"/api-reference/tools/ade-parse"}]},{"version":"Gen2 (DPT-3)","default":true,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API","groups":[{"group":"Parse","pages":[{"title":"ADE Parse","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json post /v2/parse","href":"/api-reference/parse/ade-parse"},{"title":"ADE List Parse Jobs","description":null,"deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json get /v2/parse/jobs","href":"/api-reference/parse/ade-list-parse-jobs"},{"title":"ADE Parse Jobs","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json post /v2/parse/jobs","href":"/api-reference/parse/ade-parse-jobs"},{"title":"ADE Get Parse Jobs","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json get /v2/parse/jobs/{job_id}","href":"/api-reference/parse/ade-get-parse-jobs"}]},{"group":"Extract","pages":[{"title":"ADE Extract","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json post /v2/extract","href":"/api-reference/extract/ade-extract"},{"title":"ADE List Extract Jobs","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json get /v2/extract/jobs","href":"/api-reference/extract/ade-list-extract-jobs"},{"title":"ADE Extract Jobs","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json post /v2/extract/jobs","href":"/api-reference/extract/ade-extract-jobs"},{"title":"ADE Get Extract Jobs","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json get /v2/extract/jobs/{job_id}","href":"/api-reference/extract/ade-get-extract-jobs"}]},{"group":"Ground","pages":[{"title":"ADE Ground","deprecated":null,"version":null,"openapi":"/dpt3/openapi-adev2.json post /v2/ground","href":"/api-reference/ground/ade-ground"}]}]},{"tab":"Sample Code","pages":[{"title":"Sample Code","href":"/dpt3/code-examples-resources"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/quickstart"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/dpt3/changelog"}]}]},{"version":"Split v2 (Preview)","hidden":true,"pages":[{"title":"Split v2 (Preview)","href":"/splitv2/splitv2","hidden":true}]}]},"title":"ADE Parse - LandingAI","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-CJDb0dYK.js","dist-Cv_O2fky.js","lib--scc4DXi.js","lib-B8HbPgcC.js","clsx-BGBGWFTt.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","AssistantPageLink-2C5OB2eV.js"]}