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 firstcreatedAt(string (date-time), required): Upload timecreatedBy(string, required): Who uploaded the versioncustomerNo(string, required): Customer number of the tenantdocumentId(string (uuid), required): The document of the versionfileName(string, required): File name of the versionfileSize(integer (int64), required): Size in bytesid(string (uuid), required): Version idmimeType(string, required): MIME type of the versions3Path(string, required): Storage key of the versionscanStatus(ScanStatus, required): Malware scan of the version (one ofPENDING,CLEAN,INFECTED,SKIPPED,FAILED)sha256Hash(string, required): SHA-256 (hex) of the versiontenantName(string, required): Tenant nameversionNumber(integer, required): Version number, from 1changeSummary(string): What changed with this version
total(integer, required): Number of versions
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/dms/v1/documents/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/versions' \
-H "Authorization: Bearer $ACCESS_TOKEN"