Skip to content

Audit trail

Audit activity

Audit activity, needing audit_event.view. An append-only record of who did what.

What is recorded

AreaEvents
Merchantsentity.created, entity.details_updated, entity.document_added
Reviewsentity_review.approved, .rejected, .escalated, .escalated_to_aml, .assigned, .checks_queued
Screeningscreening_match.false_positive, .adjudication_reverted, .adjudication_voided
API keysapi_key.created, api_key.revoked
Provider settingsprovider_configuration.changed
Teamteam_member.invited, team_member.invitation_resent, team_member.access_updated
Webhookswebhook_endpoint.created, .updated

Each carries the account, the auditable record, the actor, a human-readable summary and structured metadata.

Decisions carry their context

An approval made while a PEP match was present records that fact and the matched names. The trail therefore shows the decision was informed — which is the question an auditor actually asks.

Record versioning

Verity also keeps versions of changed records (via PaperTrail) with the acting user attributed, so field-level history is available beyond the event summaries.

What the trail is for

Three questions, in practice:

  1. Who decided this, and what did they know?
  2. When did this access change, and who changed it?
  3. Was this check actually run, or is the state inherited? — the audit trail plus the provider fetch runs answer this together