Skip to main content

Set Credit Usage Alerts

You can now set alerts that email your team when your organization’s credit consumption crosses a threshold. Organizations with a subscription start with three default alerts at 80%, 90%, and 100% of quota. See Credit Usage Alerts.Alert section of the Usage page, showing the three default credit alerts with their thresholds, recipients, and statuses

Billing Metadata for Jobs That Save Output to a URL

Parse Jobs and Extract Jobs created with output_save_url now report the job’s metadata (including billing) in the completed poll response, and the file delivered to your URL contains the complete response, also including metadata.This also applies to jobs that completed before this change: poll the job again, and the response now includes its metadata.

Smoother Job Progress Reporting

The progress field on Parse Jobs and Extract Jobs polls now updates on every poll as an estimate of how close the job is to completion, instead of staying at 0 for most of a run.

Playground Updates

  • Search the parse results with the toolbar’s find-in-page search, fold JSON objects, and toggle word wrap. See Review the Results.
  • The parse toolbar is redesigned, and the Config menu’s grounding control is now named Atomic grounding (previously “Fine-grained output”). See Customize the Parse Output with Config.
  • Hovering a block in the Parse tab reveals its per-line and per-cell boxes on the document, and hovering an extracted field in the Extract tab highlights and labels where its value appears in the document.

The ADE v2 APIs Are Generally Available

The v2 APIs, powered by , are now generally available: Parse, Parse Jobs, Extract, and Extract Jobs.We have made many improvements since the May Preview, including faster processing and a cleaner, more consistent response format.

Quickstart

Parse your first document with the v2 APIs.

Migration Guide

Move from the v1 (DPT-2) APIs.

New Guide: Choose a Processing Mode and Service Tier

The new Sync vs Async Processing guide compares the three ways to process documents, so you can choose the right call for each workload:
  • Synchronous requests
  • Jobs on the priority tier
  • Jobs on the standard tier (the default)

New Response Format for the Parse and Extract v2 APIs

We updated the response format of the Parse v2 and Extract v2 APIs based on developer feedback. The endpoints, authentication, and Markdown output format are unchanged. The changes are breaking if your code reads the structure or grounding output from Parse, the extraction_metadata output from Extract, sends the options.pages selector, or polls Parse Jobs.For the current response shapes, see Parse API Response and Extract API Response. For the full list of changes and how to update your code, see the July 17 Migration Notes.

Simplified Pricing

We have simplified pricing. For the Explore and Team plans, $1 buys 100 credits. This is applicable to both the EU and US regions. See Plans & Billing.Credit consumption rates are unchanged. To see how many credits each API call consumes, go to Credit Consumption for ADE v2.

Fixed: Bounding Boxes for EXIF

Images with EXIF orientation metadata (such as phone photos) are now parsed upright, so bounding boxes align with the image as a viewer sees it. See Working with Boxes.
This release updated the Parse v2 API and launched three new v2 APIs, all powered by :
  • Parse Jobs v2: Parse documents asynchronously. Submit a document, receive a job_id, and poll for the result. Jobs accept up to 6,000 pages and 1 GiB per PDF, and can save output directly to a URL you control.
  • Extract v2: Pull specific fields from Markdown with a JSON schema, with span-level grounding that maps each value back to its source.
  • Extract Jobs v2: Run long-running extractions asynchronously, for long documents or large schemas.
Parse Jobs and Extract Jobs choose a service tier when you create a job: standard (the default, half the credits) or priority (faster turnaround at the full rate). For current tier behavior, see Sync vs Async Processing.Also in this release:

HTML Tables by Default

Tables now return as HTML instead of pipe-syntax Markdown. HTML preserves merged cells and nested layouts that pipe syntax cannot represent.

Parse Options in the Playground

The Parse tab’s Config menu now exposes parse options directly in the browser: choose which element types to caption, set the table output format, toggle fine-grained grounding, and select specific pages.These controls map to the API’s options field.See Parse in the Playground.DPT-3 Pro Config drop-down menu showing the parse options

Preview of DPT-3 and the New Parse API

, our newest parsing model, and the redesigned API are now available in Preview. is a complete rethink of document parsing for the era of AI agents and agentic workflows: a new model architecture, a new response shape, and complexity-aware pricing.

Parse in the Playground

Upload a document directly in the browser. No code required.

Call the API

See parameters, response fields, and code samples.

Highlights

  • Designed for agent systems. Semantic block ids, a predictable hierarchy, and Markdown span pointers so AI agents 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.
  • Visual grounding. A bounding box on every block, plus finer-grained grounding within blocks.
  • Cleaner, more standardized Markdown. Consistent, structured Markdown output designed for RAG and downstream processing.
  • New endpoint and response shape. Calls go to the new API, which returns the document as Markdown plus a hierarchical structure tree. See the Migration Guide.

Get Started