> ## Documentation Index > Fetch the complete documentation index at: https://docs.landing.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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`. ## OpenAPI ````yaml /ade/va_openapi_ade2.json post /v1/ade/extract openapi: 3.1.0 info: title: >- LandingAI Agentic Document Extraction (ADE) API v1: Parse, Extract, Classify, Split, Section version: 0.1.0 description: >- Convert documents such as PDFs, images, and Office files into structured data with LandingAI's Agentic Document Extraction (ADE) v1 endpoints. Includes Parse (documents to Markdown and structured chunks with grounding), Extract (schema-based field extraction), Classify (page-level classification), Split (separate multi-document files), and Section (hierarchical table of contents), plus asynchronous jobs for parsing and extraction. Documentation: https://docs.landing.ai servers: - url: https://api.va.landing.ai description: Production vision tools API security: [] paths: /v1/ade/extract: post: tags: - Tools summary: ADE Extract description: |- 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`. operationId: tool_ade_extract_v1_ade_extract_post requestBody: content: multipart/form-data: schema: $ref: '#/components/schemas/ExtractRequest' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ExtractResponse' '206': description: >- Extraction completed with success but there was a schema validation error. content: application/json: schema: $ref: '#/components/schemas/ExtractResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit exceeded security: - Basic Auth: [] x-codeSamples: - lang: cURL label: cURL source: |- curl -X POST 'https://api.va.landing.ai/v1/ade/extract' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -F 'schema={"type": "object", "properties": {"field1": {"type": "string"}, "field2": {"type": "string"}}}' \ -F 'markdown=@markdown.md' \ -F 'model=extract-latest' - lang: Python label: Python source: >- import requests headers = { 'Authorization': 'Bearer YOUR_API_KEY' } url = 'https://api.va.landing.ai/v1/ade/extract' # Read the schema file as a string with open('schema.json', 'r') as f: schema_content = f.read() # Prepare files and data files = {'markdown': open('markdown.md', 'rb')} data = { 'schema': schema_content, 'model': 'extract-latest' } # Run extraction response = requests.post(url, files=files, data=data, headers=headers) # Return the results print(response.json()) - lang: JavaScript label: Node.js source: |- const axios = require('axios'); const FormData = require('form-data'); const fs = require('fs'); const form = new FormData(); form.append('markdown', fs.createReadStream('markdown.md')); form.append('schema', fs.readFileSync('schema.json', 'utf8')); form.append('model', 'extract-latest'); axios.post('https://api.va.landing.ai/v1/ade/extract', form, { headers: { 'Authorization': 'Bearer YOUR_API_KEY', ...form.getHeaders() } }) .then(response => console.log(response.data)) .catch(error => console.error(error)); components: schemas: ExtractRequest: properties: model: anyOf: - type: string - type: 'null' title: Model description: >- The version of the model to use for extraction. Use `extract-latest` to use the latest version. markdown: anyOf: - type: string format: binary - type: string - type: 'null' title: Markdown description: The Markdown file or Markdown content to extract data from. markdown_url: anyOf: - type: string - type: 'null' title: Markdown Url description: The URL to the Markdown file to extract data from. schema: type: string title: Schema description: >- JSON schema for field extraction. This schema determines what key-values pairs are extracted from the Markdown. The schema must be a valid JSON object and will be validated before processing the document. strict: type: boolean title: Strict description: >- If True, reject schemas with unsupported fields (HTTP 422). If False, prune unsupported fields and continue. Only applies to extract versions that support schema validation. default: false type: object required: - schema title: ExtractRequest ExtractResponse: properties: extraction: type: object title: Extraction description: The extracted key-value pairs. extraction_metadata: type: object title: Extraction Metadata description: The extracted key-value pairs and the chunk_reference for each one. metadata: $ref: '#/components/schemas/ExtractMetadata' description: The metadata for the extraction process. type: object required: - extraction - extraction_metadata - metadata title: ExtractResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ExtractMetadata: properties: filename: type: string title: Filename org_id: anyOf: - type: string - type: 'null' title: Org Id duration_ms: type: integer title: Duration Ms credit_usage: type: number title: Credit Usage job_id: type: string title: Job Id version: anyOf: - type: string - type: 'null' title: Version schema_violation_error: anyOf: - type: string - type: 'null' title: Schema Violation Error description: >- 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: anyOf: - type: string - type: 'null' title: Fallback Model Version description: >- The extract model that was actually used to extract the data when the initial extraction attempt failed with the requested version. warnings: items: $ref: '#/components/schemas/ExtractWarning' type: array title: Warnings description: >- 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. type: object required: - filename - org_id - duration_ms - credit_usage - job_id - version title: ExtractMetadata ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError ExtractWarning: properties: code: $ref: '#/components/schemas/ExtractWarningCode' description: The type of warning, used to translate to a status code downstream msg: type: string title: Msg description: Human-readable description of the warning with more details type: object required: - code - msg title: ExtractWarning ExtractWarningCode: type: string enum: - nonconformant_schema - nonconformant_output title: ExtractWarningCode securitySchemes: Basic Auth: type: http description: >- Your unique API key for authentication. Get your API key here: https://va.landing.ai/settings/api-key. If using the EU endpoint, get your API key here: https://va.eu-west-1.landing.ai/settings/api-key. scheme: bearer bearerFormat: Basic ````