Skip to main content
POST/vault/audit-ledger/verify

Verify Ledger

Checks the project's ledger on the server: the hash chain and every signature.

Needs PROJECT_ADMIN or PROJECT_AUDITOR.

Parameters
projectId *query

The project's id.

Responses
HTTPK9O CodeDescription
200The ledger is intact.
401The request carries no authenticated caller.
422The ledger was altered: `status` is `tampered`, and `firstTamperedAt` names the first altered event.
500An internal error. Retry later.
Response body (200)
eventCount *integer <int64>

Total event count in the ledger as of verification.

Example: 1842
firstTamperedAtany
One of: null
or: object
eventId *string

Event identifier of the first tampered event.

Example: "5b0e8f3a-2c1d-4e7b-9a6f-0d1c2b3a4e5f"
sequenceNumber *integer <int64>

Sequence number of the first tampered event.

Example: 917
status *string

Verification status — "intact" or "tampered".

Example: "intact"
verifiedAt *string <date-time>

Verification timestamp.

Example: "2026-11-15T09:30:00.123Z"
Response example (200)
{
  "eventCount": 1842,
  "status": "intact",
  "verifiedAt": "2026-11-15T09:30:00.123Z"
}

More in Audit Ledger