Skip to main content
Use the Classify API to classify each page in a document by type. You provide a document and a list of classes, and the API assigns a class to each page. Use those classes to decide how to handle each page downstream, for example which pages to parse, how to split a batch, or which extraction schema to apply. Classify runs as a synchronous request at https://api.ade.landing.ai/v1/ade/classify (EU: https://api.ade.eu-west-1.landing.ai/v1/ade/classify). It works on the original document, so you can call it before or alongside Parse.

​
Example Use Cases

  • Financial Services: Financial institutions receiving batches of mixed documents can classify pages to identify bank statements, utility bills, and identification documents before routing them to the appropriate processing pipeline.
  • Healthcare: Healthcare systems ingesting patient records can classify pages to identify intake forms, pathology reports, and medication lists before parsing or extraction.
  • Legal: Legal teams processing incoming documents can classify pages by section type (for example, cover page, terms, signature page) before routing each page to the appropriate review workflow.
  • Insurance: Insurance companies receiving claim submissions can classify pages to identify claim forms, invoices, and medical records before extraction.
For credit consumption rates, see Credit Consumption.

​
Process Overview

Follow these steps to classify pages in a document:
  1. Define your class list by creating the classes that describe the page types in your document. Learn more about Classes.
  2. Classify your document using the Classify API. Pass your document and class list. All pages are classified concurrently.
  3. Use the classification results in your downstream workflows. Route pages to Parse, Split, Extract, or other systems based on the class assigned to each page. Learn more about the response structure.

​
Classes

A class is an object with a required class name and an optional description. Include a description when the class name alone may be ambiguous (for example, "spec" vs "manual"). You can omit the description when the name is self-explanatory. You can mix classes with and without descriptions in the same request.

​
Classify with the API

Classify the pages in a document by calling the Classify endpoint. In the EU, send the request to https://api.ade.eu-west-1.landing.ai with an EU API key. See European Union (EU). This example classifies a document that may contain invoices, bank statements, and earnings statements. The invoice and bank_statement classes include descriptions, and earnings statement does not.

​
Parameters

Get the full parameters from the API reference.

​
Use Classify with Our Libraries

Click one of the tiles to learn how to use the Classify API with our libraries.

Python Library

Use Classify with our Python library.

TypeScript Library

Use Classify with our TypeScript library.

​
Supported File Types

The Classify API accepts PDFs, images, Office text documents, and PowerPoint presentations, up to 50 MiB per request. Office text documents and presentations are converted to PDF before classification. Spreadsheets (XLSX, CSV) and legacy PowerPoint (PPT) files are not supported.

​
Share Your Feedback

To share your experience with Classify, schedule a feedback session with us. Come prepared to discuss:
  • What is working well
  • Any challenges you’ve encountered and how the feature could improve
  • The email address for your Agentic Document Extraction account, found in your profile page
  • The documents you used
  • The code you used