ConnectCloud Developers

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 checked
    • valid (boolean, required): Every entry hash matches
    • brokenAtId (integer (int64)): First entry whose hash does not match
    • headHash (string): Hash of the latest entry
  • documentId (string (uuid), required): Document id
  • valid (boolean, required): Every version and the audit chain are intact
  • verifiedAt (string (date-time), required): Time of the check
  • versions (array of object, required): Result per version
    • expectedSha256 (string, required): Recorded SHA-256
    • valid (boolean, required): Both hashes match
    • versionNumber (integer, required): Version number
    • actualSha256 (string): SHA-256 of the stored file
    • error (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"

View as Markdown · Interactive reference · OpenAPI