---
title: "ADE Split"
method: POST
path: "/v1/ade/split"
tags: ["Tools"]
---

# ADE Split

`POST /v1/ade/split`

Split classification for documents.

This endpoint classifies document sections
    based on markdown content and split options.

For EU users, use this endpoint:


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

## Response `200`

Successful Response

- SplitResponse — Response model for split classification endpoint.
  - `splits` SplitData[], required
    - `classification` string, required
    - `identifier` string, nullable, required
    - `pages` integer[], required
    - `markdowns` string[], required
  - `metadata` SplitMetadata, required — Metadata for split classification response.
    - `filename` string, required
    - `org_id` string, nullable — Organization ID
    - `page_count` integer, required
    - `duration_ms` integer, required
    - `credit_usage` number, required
    - `job_id` string — Inference history job ID
    - `version` string, nullable — Model version used for split classification

## Other responses

- `422` — Validation Error

## Changes

- **2026-03-20** `db7429fa53be` — 1 warning, 1 info
  - removed the request property `markdownUrl`
  - added the new optional request property `markdown_url`
- **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 `markdownUrl` became not nullable
  - …5 more
- **2026-02-13** `e8084df42cc1` — 3 info
  - added `subschema #1, subschema #2` to the request body `oneOf` list (media type: application/json)
  - added `subschema #1, subschema #2` to the request body `oneOf` list (media type: multipart/form-data)
  - the request property `markdown` became nullable (media type: multipart/form-data)
- **2026-02-13** `73d13502c1d0` — 3 breaking, 3 info
  - request property `markdown` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - request property `markdownUrl` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - request property `model` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - added the media type `application/json` to the request body
  - …2 more

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