## 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:

```json
{
  "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

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