## The classification history of a document, oldest first (tenant:dms:read)

`GET /api/dms/v1/documents/{id}/classifications`

Module: DMS · operationId: `listDocumentClassifications` · Tag: Classification · Auth: access token (`Authorization: Bearer <accessToken>`)

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes |  |

### Responses

- **200** Classifications (`application/json`)
- **404** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of Classification, required): The classification history, oldest first
  - `category` (string, required): The proposed or chosen document type
  - `confidence` (number, required): Confidence of the proposal (0–1) (max 1)
  - `createdAt` (string (date-time), required): Time of the classification
  - `documentId` (string (uuid), required): Document id
  - `final` (boolean, required): false: a proposal below the threshold that waits for review
  - `id` (integer (int64), required): Entry id
  - `source` (string, required): ai = the classifier model, einvoice = the e-invoice XML, manual = a person (one of `ai`, `einvoice`, `manual`)
  - `targetModule` (string, required): Module that processes documents of the type (one of `none`, `trade.invoice`, `trade.delivery_note`, `trade.order_confirmation`, `hr`)
  - `version` (integer, required): Document version that was classified
  - `actor` (string): Who chose the type (manual only)
  - `method` (string): Kind of model (ai only) (one of `native`, `llm`)
  - `model` (string): Model that answered (ai only)
  - `previousCategory` (string): The type the document had before
  - `reason` (string): Short justification of the model, if given
- `total` (integer, required): Number of entries

Example 200 answer:

```json
{
  "items": [
    {
      "category": "incoming_document",
      "confidence": 1,
      "createdAt": "2026-09-30T08:40:20Z",
      "documentId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c1f42",
      "final": true,
      "id": 4711,
      "source": "einvoice",
      "targetModule": "trade.invoice",
      "version": 1
    }
  ],
  "total": 1
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/dms/v1/documents/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/classifications' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
