---
title: "Run a saved Classifier against a document"
method: POST
path: "/v1/classifiers/{classifier_id}/classify"
tags: ["Classify"]
---

# Run a saved Classifier against a document

`POST /v1/classifiers/{classifier_id}/classify`

## Request

- Base URL: `https://api.documentpro.ai`
- URL: `https://api.documentpro.ai/v1/classifiers/{classifier_id}/classify`
- Auth: API key in header `x-api-key`

Recommended for automation pipelines that reuse the same label set. The document must already be uploaded and OCR-processed.

## Path parameters

- `classifier_id` string, uuid, required

## Request body

- object
  - `document_id` string, uuid, required
  - `page_range` string: Overrides the Classifier's default page range for this call only.
  - `query_model` 'gpt-4o-mini' | 'gpt-4o': Overrides the Classifier's default model for this call only.

## Response `200`

Classification result.

- ClassificationResult
  - `request_id` string, uuid
  - `document_id` string, uuid
  - `classifier_id` string, uuid, nullable: null for inline classification via POST /v1/classify.
  - `classification` string: The best-matching label.
  - `confidence_scores` object: Score 0.0-1.0 per label, summing to ~1.0.
  - `request_status` 'completed' | 'failed' | 'exception'
  - `credits_used` integer
  - `num_pages` integer
  - `duration` number, float: Seconds.

## Other responses

- `400`: Malformed request or invalid arguments.
- `403`: API key does not have access to the requested resource, or a plan limit was hit.
- `404`: The requested resource does not exist on this account.
- `500`: Something went wrong on DocumentPro's side.

---

[API](https://skmtc.dev/documentpro/apis/documentpro-api.md) · [All operations](https://skmtc.dev/documentpro/apis/documentpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/documentpro/apis/documentpro-api/revisions/05d6bd485e28?raw)