For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Getting Started
    • Introduction
    • How Verifa Works
    • Quickstart
    • Choosing an Integration Method
  • Use Cases
    • KYC Onboarding
    • Age Verification
    • AML Compliance
    • Fraud Prevention
    • Marketplace Trust & Safety
  • Core Concepts
    • Overview
    • Sessions
    • Verifications & Checks
    • Workflows
    • Identities
    • Cases
    • Screening & Reports
    • Lists
  • Integration Guides
    • Overview
    • JavaScript SDK
    • Web Capture Flow
    • API-Only Integration
    • Mobile SDK
    • Webhooks Guide
    • MCP Server
    • Migrating from Persona
  • API Details
    • Overview
    • Authentication
    • Pagination
    • Rate Limiting
    • Versioning
    • Errors
    • Webhooks
    • Idempotency
    • Key Inflection
    • Data Access
    • Data Retention
  • Tutorials
    • Creating Your First Verification Session
    • Creating a Workflow
    • Receiving Webhooks & Validating Signatures
    • Handling Webhook Events
    • Custom Document Types & AI Extraction
  • Best Practices
    • Testing
    • Preventing Duplicates
    • Fraud Signals
    • Changelog
  • API Reference
      • GETList audit events
      • GETRetrieve an audit event
API ReferenceEvents

Retrieve an audit event

GET
https://devapi.withverifa.com/api/v1/events/:event_id
GET
/api/v1/events/:event_id
$curl https://devapi.withverifa.com/api/v1/events/aud_abc123 \
>     -H "X-API-Key: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "id": "aud_abc123",
3  "type": "session.approved",
4  "created_at": "2024-01-15T09:30:00Z",
5  "resource_type": "session",
6  "resource_id": "ses_abc123",
7  "actor": "api_key:vk_live_abc1",
8  "metadata": {
9    "verification_result": "approved",
10    "user_id": "usr_789xyz",
11    "notes": "Session approved after manual review"
12  },
13  "ip_address": "203.0.113.42",
14  "request_method": "POST",
15  "request_path": "/api/v1/sessions/ses_abc123/approve",
16  "sequence_num": 42
17}
Returns a single audit event by its public ID.
Was this page helpful?
Previous

List review cases

Next
Built with

Authentication

X-API-Keystring

Organization API key. Keys are prefixed with vk_live_ (production) or vk_sandbox_ (sandbox).

Path parameters

event_idstringRequired

Headers

Verifa-VersiondateOptional

API version date string (e.g. 2026-02-01). If omitted, the version pinned to your API key is used.

Response

Audit event details.
idstring
Event ID.
typestring
Event action type.
created_atdatetime
resource_typestring or null
Type of resource affected.
resource_idstring or null
Public ID of the affected resource.
actorstring or null
Email or API key identifier of the actor.
metadatamap from strings to any
Additional context about the event.
ip_addressstring or null
request_methodstring or null
request_pathstring or null
sequence_numinteger or null
Monotonic sequence number for ordering.

Errors

401
Unauthorized Error
404
Not Found Error