What DPT-3 Changes
The Parse v2 API is a redesign, not just a model update.- Designed for agent systems. Built around how downstream AI agents consume document data: semantic block ids, predictable hierarchy, and Markdown ranges so you can map results back to source.
- Hierarchical layout model. The structured output is a nested hierarchy: pages, blocks on each page, and cells within tables.
- Line-level visual grounding. Bounding boxes per block, plus per-line boxes through each block’s atomic grounding, so you can highlight or extract content at the line level.
- Cleaner, more standardized Markdown. Structured figure elements with classification labels, bracketed attestation and scan-code labels, and standardized checkboxes.
- v2 endpoint and response shape. Calls go to the Parse v2 API. The response carries a hierarchical
structuretree in which every block holds its own location data. See Parse API Response.
Important to Know
A few things to keep in mind before integrating with the Parse v2 API.Using the Parse v2 API Requires Code Changes
The endpoint, request shape, and response shape all differ from the Parse v1 API. Existing pipelines that call the v1/v1/ade/parse endpoint need code changes to use the v2 /v2/parse endpoint. See the Migration Guide for the full diff.
Not Compatible with the v1 ADE APIs
The v1 ADE Extract and ADE Section APIs consume Parse output in the v1 response shape. To extract fields from Parse v2 output, use the Extract v2 API, which works on the v2 Markdown. If your workflow uses Section, keep that workflow on the Parse v1 API.Only PDFs and Images Are Supported
The Parse v2 API supports PDFs and images only. For other file types, use the Parse v1 API. See Supported File Types for the full list.Password-Protected Files Are Not Supported
The Parse v2 API does not support password-protected files. Decrypt the file and submit an unencrypted copy, or use the Parse v1 API.Find What You Need
Pick a starting point based on what you want to do.Try It in the Playground
See in action without writing code. Upload a file in your browser.
Quickstart (API)
Make your first API call in under five minutes.
How Parse Works
Understand the response shape: pages, blocks, and grounding.
Migrate from v1
Already using the Parse v1 API? See what’s changed.