# Verify Ledger

`POST /vault/audit-ledger/verify` · Keys & Secrets · Audit Ledger

Checks the project's ledger on the server: the hash chain and every signature. Needs `PROJECT_ADMIN` or `PROJECT_AUDITOR`.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `projectId` | query | yes | The project's id. Example: `"3f2c9a4e-8b1d-4c6f-9e2a-7d5b1c0a4e8f"`. |

## Responses

- **200**: The ledger is intact.

| Field | Type | Required | Description |
|---|---|---|---|
| `eventCount` | integer (int64) | yes | Total event count in the ledger as of verification. Example: `1842`. |
| `firstTamperedAt` | object | no |  |
| _one of_ | | |  |
| _or_ | | |  |
| `firstTamperedAt.eventId` | string | yes | Event identifier of the first tampered event. Example: `"5b0e8f3a-2c1d-4e7b-9a6f-0d1c2b3a4e5f"`. |
| `firstTamperedAt.sequenceNumber` | integer (int64) | yes | Sequence number of the first tampered event. Example: `917`. |
| `status` | string | yes | Verification status — `"intact"` or `"tampered"`. Example: `"intact"`. |
| `verifiedAt` | string (date-time) | yes | Verification timestamp. Example: `"2026-11-15T09:30:00.123Z"`. |


## Errors

| HTTP | Description |
|---|---|
| 401 | The request carries no authenticated caller. |
| 422 | The ledger was altered: `status` is `tampered`, and `firstTamperedAt` names the first altered event. |
| 500 | An internal error. Retry later. |

Canonical page: https://docs.kilimanjaro.dev/api-playground/keys-secrets/verify-ledger
