---
title: "ADE Extract"
method: POST
path: "/v1/ade/extract"
tags: ["Tools"]
---

# ADE Extract

`POST /v1/ade/extract`

Extract structured data from Markdown using a JSON schema.

This endpoint
    processes Markdown content and extracts structured data according to the provided
    JSON schema.

For EU users, use this endpoint:


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

## Response `200`

Successful Response

- ExtractResponse
  - `extraction` object, required — The extracted key-value pairs.
  - `extraction_metadata` object, required — The extracted key-value pairs and the chunk_reference for each one.
  - `metadata` ExtractMetadata, required
    - `filename` string, required
    - `org_id` string, nullable, required
    - `duration_ms` integer, required
    - `credit_usage` number, required
    - `job_id` string, required
    - `version` string, nullable, required
    - `schema_violation_error` string, nullable — A detailed error message shows why the extracted data does not fully conform to the input schema. Null means the extraction result is consistent with the input schema.
    - `fallback_model_version` string, nullable — The extract model that was actually used to extract the data when the initial extraction attempt failed with the requested version.
    - `warnings` ExtractWarning[] — Structured warnings from the extraction process. Each warning is an instance of ExtractWarning with 'code' (e.g. 'nonconformant_schema') and 'msg' (human-readable description). Present only for extract versions from extract-20260314 and above that support structured warnings.
      - `code` 'nonconformant_schema' | 'nonconformant_output', required
      - `msg` string, required — Human-readable description of the warning with more details

## Other responses

- `206` — Extraction completed with success but there was a schema validation error.
- `422` — Validation Error
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e.md) · [All operations](https://skmtc.net/landing-ai/apis/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/landing-ai/landingai-agentic-document-extraction-ade-api-v2-parse-and-e/revisions/b07477df91eb/schema)