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

# ADE Parse

`POST /v1/ade/parse`

Parse a document or spreadsheet.

This endpoint parses documents (PDF, images)
    and spreadsheets (XLSX, CSV) into 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
    - `failed_pages` integer[]

## Other responses

- `206` — There were some pages that failed to be parsed.
- `422` — Validation Error
- `429` — Rate limit exceeded

## Changes

- **2026-04-22** `3052ba97a920` — 1 breaking, 1 info
  - removed `subschema #1` from the `custom_prompts` request property `anyOf` list
  - added `#/components/schemas/CustomPrompts` to the `custom_prompts` request property `anyOf` list
- **2026-04-03** `ceccbcbbf7a6` — 2 info
  - added the media type `application/json` for the response with the status `206`
  - added the non-success response with the status `429`
- **2026-03-20** `db7429fa53be` — 1 info
  - added the new optional request property `custom_prompts`
- **2026-03-12** `64b844e161ba` — 1 info
  - added the new optional request property `password`
- **2026-02-13** `62ce42134d4b` — 1 info
  - the endpoint scheme security `Basic Auth` was removed from the API

[Full 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/027fb87ba705/schema)