Verify Events

Triggers

Trigger	Description
Verify flow is completed	This webhook fires whenever an individual completes their steps in the verification portal.

Webhook Payload

The payload of the webhook provides the following information in JSON format:

Attribute	Description
event	Will always be event.completed
profile_reference	the unique reference of the profile
customer_reference	the unique customer assigned reference for the profile
representative_id	the unique reference for that representative in the platform
completed_at	The date/time the verification was completed
flow_id	The unique reference of the flow for this KYC Journey
users_email	The email address of the user who completed the verification
verification_information	The detailed information of the verifications performed by the user
result	This will provide core information on the verifications that have been performed, see this API for more information:Retrieves a list of verifications for a representative

{
  "event": "verify.completed",
  "timestamp": "2026-06-19T15:18:30.430126Z",
  "data": {
    "representative_id": "a20fae1b-01c5-4fc6-b436-afd7964aeef9",
    "profile_reference": "536a8313-9e06-4b55-9237-c73fb1e81cb7",
    "customer_reference": "api-verify-individual-personal-and-form",
    "flow_id": "e9619aeb-7a03-49d7-9c7d-de4b9cf323fe",
    "completed_at": "2026-06-19T15:18:29.000000Z",
    "users_email": "[email protected]",
    "result": []
  }
}

---
config:
  theme: redux-dark
  look: classic
---
sequenceDiagram
    participant Customer as Customer
    participant Verify as Verify Portal
    participant Detected as Detected
    participant Hook as Your webhook endpoint
    participant App as Client's app
    Customer->>Verify: Open verify link
    Note over Customer,Verify: Mid-flow — forms, IDV / ID3, personal info
    Customer->>Verify: Complete mid-flow steps
    Note over Detected,Hook: Optional — not KYC complete
    Detected-->>Hook: profile.updated (optional)
    Customer->>Verify: Final Submit
    Note over Detected,Hook: KYC completion
    Detected->>Hook: verify.completed
    Detected->>Hook: profile.updated (usually same second)
    Note over App,Detected: Pull KYC detail
    App->>Detected: GET /representatives/{uuid}/verifications
    Detected-->>App: Verification results