---
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

## Changes

- **2026-04-03** `ceccbcbbf7a6` — 4 info
  - added the new optional request property `strict`
  - added the media type `application/json` for the response with the status `206`
  - added the non-success response with the status `429`
  - added the optional property `metadata/warnings` to the response with the `200` status
- **2026-03-12** `289dbe904bcc` — 1 warning
  - removed the request property `strict`
- **2026-03-12** `64b844e161ba` — 1 info
  - added the new optional request property `strict`
- **2026-02-13** `62ce42134d4b` — 1 info
  - the endpoint scheme security `Basic Auth` was removed from the API
- **2026-02-13** `eeb4eb7952ab` — 5 breaking, 4 info
  - removed the media type `application/json` from the request body
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - the request property `markdown` became not nullable
  - the request property `markdown_url` became not nullable
  - …5 more

[Full history](https://skmtc.dev/landing-ai/apis/ade-api/changes/v1/ade/extract/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)