Verify Audit Event Hash Chain

Use this endpoint to verify the integrity of the audit event hash chain up to a specific event. Detects tampering attempts. Designed for SOX/GLBA compliance.

GET /v1/audit-events/{id}/verify

Verify Audit Event Hash Chain

cURL

curl --request GET \
  --url https://tracer.lerian.io/v1/audit-events/{id}/verify \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <api-key>'

200

{
  "isValid": true,
  "totalChecked": 1234,
  "message": "Hash chain integrity verified successfully"
}

Authorizations

ApiKeyAuthBearerAuth

X-API-Key · string · header · required

API Key authentication. Used by single-tenant deployments (MULTI_TENANT_ENABLED=false). Sent on every /v1/* request.

Headers

Content-Type · string · required

The type of media of the resource. Must be application/json.

X-API-Key · string · required

The API Key for authentication. This header is required for all endpoints except health checks.

X-Request-Id · string<uuid>

A unique identifier used to trace and track each request.

Path Parameters

id · string<uuid> · required

The unique identifier of the audit event that you want to retrieve or verify.

Response

200

application/json

Indicates that the hash chain verification was completed successfully.

Result of hash chain integrity verification.

isValid · boolean

Whether the hash chain is intact.

totalChecked · integer

Number of events verified in the chain.

firstInvalidId · integer

ID of first invalid event (only present if isValid is false).

message · string

Human-readable verification result.