> ## 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 Classify > Classify the pages of a document into classes you define. This endpoint accepts PDFs, images, and other supported file types (either as a `document` upload or `document_url`) together with a list of `classes`, and returns a classification result for each page. For EU users, use this endpoint: `https://api.va.eu-west-1.landing.ai/v1/ade/classify`. ## OpenAPI ````yaml /ade/va_openapi_ade2.json post /v1/ade/classify 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/classify: post: tags: - Tools summary: ADE Classify description: |- Classify the pages of a document into classes you define. This endpoint accepts PDFs, images, and other supported file types (either as a `document` upload or `document_url`) together with a list of `classes`, and returns a classification result for each page. For EU users, use this endpoint: `https://api.va.eu-west-1.landing.ai/v1/ade/classify`. operationId: tool_ade_classify_v1_ade_classify_post requestBody: content: multipart/form-data: schema: $ref: '#/components/schemas/ClassifyRequest' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ClassifyResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - Basic Auth: [] x-codeSamples: - lang: cURL label: cURL source: |- curl -X POST 'https://api.va.landing.ai/v1/ade/classify' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -F 'classes=[{"class":"Class 1","description":"Description of Class 1"},{"class":"Class 2","description":"Description of Class 2"}]' \ -F 'document=@document.pdf' - lang: Python label: Python source: >- import requests import json headers = { 'Authorization': 'Bearer YOUR_API_KEY' } url = 'https://api.va.landing.ai/v1/ade/classify' classes = [ {'class': 'Class 1', 'description': 'Description of Class 1'}, {'class': 'Class 2', 'description': 'Description of Class 2'} ] files = {'document': open('document.pdf', 'rb')} data = {'classes': json.dumps(classes)} response = requests.post(url, files=files, data=data, headers=headers) 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('document', fs.createReadStream('document.pdf')); const classes = [ { class: 'Class 1', description: 'Description of Class 1' }, { class: 'Class 2', description: 'Description of Class 2' } ]; form.append('classes', JSON.stringify(classes)); axios.post('https://api.va.landing.ai/v1/ade/classify', form, { headers: { 'Authorization': 'Bearer YOUR_API_KEY', ...form.getHeaders() } }) .then(response => console.log(response.data)) .catch(error => console.error(error)); components: schemas: ClassifyRequest: properties: classes: items: $ref: '#/components/schemas/ClassifyClass' type: array title: Classes description: >- The possible classes that can be assigned to pages in the document. Each entry is an object with a `class` name and an optional `description`. Only one class is assigned per page; unclassifiable pages receive 'unknown'. Can be provided as a JSON string in form data. document: anyOf: - type: string format: binary - type: 'null' title: Document description: >- A file to be classified. Either this parameter or the `document_url` parameter must be provided. document_url: anyOf: - type: string - type: 'null' title: Document Url description: >- The URL of the document to be classified. Either this parameter or the `document` parameter must be provided. model: anyOf: - type: string - type: 'null' title: Model description: Classification model version. Defaults to the latest. type: object required: - classes title: ClassifyRequest ClassifyResponse: properties: classification: items: $ref: '#/components/schemas/ClassificationItem' type: array title: Classification metadata: $ref: '#/components/schemas/ClassifyMetadata' type: object required: - classification - metadata title: ClassifyResponse description: Response model for the classify endpoint. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ClassifyClass: properties: class: type: string title: Class description: Name of the class. description: anyOf: - type: string - type: 'null' title: Description description: Detailed description of what this class represents. type: object required: - class title: ClassifyClass description: 'A single classification option: a class name plus optional description.' ClassificationItem: properties: class: type: string title: Class description: Predicted class label or 'unknown'. reason: type: string title: Reason description: Reason for the classification (for debugging). default: '' suggested_class: anyOf: - type: string - type: 'null' title: Suggested Class description: Proposed class when the prediction is 'unknown'. page: type: integer title: Page description: Page number (0-based). type: object required: - class - page title: ClassificationItem description: A single page-level classification result. ClassifyMetadata: properties: filename: type: string title: Filename org_id: anyOf: - type: string - type: 'null' title: Org Id page_count: type: integer title: Page Count duration_ms: type: integer title: Duration Ms credit_usage: type: number title: Credit Usage job_id: type: string title: Job Id default: '' version: anyOf: - type: string - type: 'null' title: Version type: object required: - filename - page_count - duration_ms - credit_usage title: ClassifyMetadata description: Metadata for the classify response. 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 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 ````