## The versions of a document, newest first (tenant:dms:read)

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

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

### Parameters

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

### Responses

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

Fields of the 200 answer:

- `items` (array of DocumentVersion, required): The versions, newest first
  - `createdAt` (string (date-time), required): Upload time
  - `createdBy` (string, required): Who uploaded the version
  - `customerNo` (string, required): Customer number of the tenant
  - `documentId` (string (uuid), required): The document of the version
  - `fileName` (string, required): File name of the version
  - `fileSize` (integer (int64), required): Size in bytes
  - `id` (string (uuid), required): Version id
  - `mimeType` (string, required): MIME type of the version
  - `s3Path` (string, required): Storage key of the version
  - `scanStatus` (ScanStatus, required): Malware scan of the version (one of `PENDING`, `CLEAN`, `INFECTED`, `SKIPPED`, `FAILED`)
  - `sha256Hash` (string, required): SHA-256 (hex) of the version
  - `tenantName` (string, required): Tenant name
  - `versionNumber` (integer, required): Version number, from 1
  - `changeSummary` (string): What changed with this version
- `total` (integer, required): Number of versions

Example 200 answer:

```json
{
  "items": [
    {
      "createdAt": "2026-09-30T08:40:12Z",
      "createdBy": "christina.adler@muster-it.example",
      "customerNo": "99999",
      "documentId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c1f42",
      "fileName": "RE-482117.pdf",
      "fileSize": 184320,
      "id": "8a0c2e4a-6b8c-4d0e-8f2a-4b6c8d0e2f4a",
      "mimeType": "application/pdf",
      "s3Path": "dms/99999/DEMO/2026/09/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c1f42/RE-482117.pdf",
      "scanStatus": "CLEAN",
      "sha256Hash": "5e2b8c4f1a7d3e9b0c6f2a8d4e1b7c3f9a5d0e6b2c8f4a1d7e3b9c5f0a6d2e8b",
      "tenantName": "DEMO",
      "versionNumber": 1
    }
  ],
  "total": 1
}
```

### Example request

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