Check the integrity of a document (tenant:dms:read)
GET /api/dms/v1/documents/{id}/verify
Module: DMS · operationId: verifyDocument · Tag: Compliance · Auth: access token (Authorization: Bearer <accessToken>)
Recomputes the SHA-256 of every stored version, compares it with the recorded hash and verifies the tenant's audit chain.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id |
path | string (uuid) | yes |
Responses
- 200 Integrity report (
application/json) - 404 Error (
application/json) - 503 Error (
application/json)
Fields of the 200 answer:
auditChain(ChainVerification, required)entries(integer, required): Entries checkedvalid(boolean, required): Every entry hash matchesbrokenAtId(integer (int64)): First entry whose hash does not matchheadHash(string): Hash of the latest entry
documentId(string (uuid), required): Document idvalid(boolean, required): Every version and the audit chain are intactverifiedAt(string (date-time), required): Time of the checkversions(array of object, required): Result per versionexpectedSha256(string, required): Recorded SHA-256valid(boolean, required): Both hashes matchversionNumber(integer, required): Version numberactualSha256(string): SHA-256 of the stored fileerror(string): Why the file could not be checked
Example 200 answer:
{
"auditChain": {
"entries": 18342,
"headHash": "7b1e9c3a5f2d8e4b0a6c1f7d3e9b5a2c8f4d0e6a1b7c3f9d5e2a8b4c0f6d1e7a",
"valid": true
},
"documentId": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a9c1f42",
"valid": true,
"verifiedAt": "2026-11-18T09:30:00Z",
"versions": [
{
"actualSha256": "5e2b8c4f1a7d3e9b0c6f2a8d4e1b7c3f9a5d0e6b2c8f4a1d7e3b9c5f0a6d2e8b",
"expectedSha256": "5e2b8c4f1a7d3e9b0c6f2a8d4e1b7c3f9a5d0e6b2c8f4a1d7e3b9c5f0a6d2e8b",
"valid": true,
"versionNumber": 1
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/dms/v1/documents/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12/verify' \
-H "Authorization: Bearer $ACCESS_TOKEN"