---
title: "ADE Parse"
method: POST
path: "/v1/ade/parse"
tags: ["Tools"]
---

# ADE Parse

`POST /v1/ade/parse`

Parse a document.

This endpoint parses documents and structured Markdown,
    chunks, and metadata.

 For EU users, use this endpoint:


    `https://api.va.eu-west-1.landing.ai/v1/ade/parse`.

## Response `200`

Successful Response

- ParseResponse
  - `markdown` string, required
  - `chunks` ParseChunk[], required
    - `markdown` string, required
    - `type` string, required
    - `id` string, required
    - `grounding` ParseGrounding, required
      - `box` ParseGroundingBox, required
        - `left` number, required
        - `top` number, required
        - `right` number, required
        - `bottom` number, required
      - `page` integer, required
  - `splits` ParseSplit[], required
    - `class` string, required
    - `identifier` string, required
    - `pages` integer[], required
    - `markdown` string, required
    - `chunks` string[], required
  - `grounding` object
  - `metadata` ParseMetadata, required
    - `filename` string, required
    - `org_id` string, nullable, required
    - `page_count` integer, required
    - `duration_ms` integer, required
    - `credit_usage` number, required
    - `job_id` string, required
    - `version` string, nullable, required

## Other responses

- `422` — Validation Error

## Changes

- **2025-09-29** `542a8c1e9161` — 1 breaking, 6 info
  - the `chunks/items/grounding` response's property type changed from no type to `object` for status `200`
  - the endpoint scheme security `Basic Auth` was removed from the API
  - added the optional property `grounding` to the response with the `200` status
  - removed `#/components/schemas/ParseGrounding, subschema #2` from the `chunks/items/grounding` response property `anyOf` list for the response status `200`
  - …3 more
- **2025-09-24** `f84d9496fa14` — 1 breaking, 2 info
  - response property `metadata/version` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the new optional request property `model`
  - added the required property `metadata/job_id` to the response with the `200` status

[Change history](https://skmtc.dev/landing-ai/apis/ade-api/changes/v1/ade/parse/post.md)

---

[API](https://skmtc.dev/landing-ai/apis/ade-api.md) · [All operations](https://skmtc.dev/landing-ai/apis/ade-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/landing-ai/ade-api/revisions/49f90dffde89/schema)