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

# Parse Documents

> Parse documents with the Parse v2 API into Markdown, structured blocks, and per-block grounding.

export const dpt3pro = 'DPT-3 Pro';

export const dpt3 = 'DPT-3';

export const parseDpt3 = 'Parse';

export const ade = 'Agentic Document Extraction';

The [Parse v2 API](https://docs.landing.ai/api-reference/parse/ade-parse) converts a document into structured data for retrieval-augmented generation (RAG), search, extraction, or any downstream workflow. It returns a reading-order Markdown rendering of the document, a hierarchical structure of its pages and blocks, and per-block grounding that maps everything back to the source.

## How Parse Works

You send a PDF or image to the parse endpoint, optionally choosing a [model version](./parse-input#model-version) and customizing the parse with [options](./parse-input#request-options). The API returns a single JSON response containing the reading-order Markdown, the document structure, per-block grounding, and request metadata. See [Parse API Response](./parse-response) for the field-by-field reference.

If you haven't made an API call yet, start with the [Quickstart](./quickstart) to get a real response to follow along with.

## Call the Parse API

Send a document to the parse endpoint with a POST request. Replace `YOUR_API_KEY` with your [API key](./agentic-api-key) and `document.pdf` with the path to your file.

The [`options`](./parse-input#request-options) field is optional: the defaults suit most documents, so include it only to customize the parse (here, to process specific pages).

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST 'https://api.ade.landing.ai/v2/parse' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -F 'document=@document.pdf' \
    -F 'model=dpt-3-pro-latest' \
    -F 'options={"pages":[1]}'
  ```

  ```python Python theme={null}
  from pathlib import Path
  from landingai_ade import LandingAIADE

  client = LandingAIADE()

  response = client.v2.parse(
      document=Path("document.pdf"),
      model="dpt-3-pro-latest",
      options={"pages": [1]},
  )
  print(response.markdown)
  ```

  ```typescript TypeScript theme={null}
  import fs from "fs";
  import LandingAIADE from "landingai-ade";

  const client = new LandingAIADE();

  const response = await client.v2.parse({
    document: fs.createReadStream("document.pdf"),
    model: "dpt-3-pro-latest",
    options: { pages: [1] },
  });
  console.log(response.markdown);
  ```
</CodeGroup>

<Info>
  For the full request and response contract, see the [API reference](https://docs.landing.ai/api-reference/parse/ade-parse).
</Info>