Skip to main content

​
Overview

Webhook events that occur during instant verification operations. These webhooks notify your system when an instant verification request completes or fails.

​
Instant Verification Completed

Event Type: instant-verification-completed This webhook triggers when an instant verification request finishes processing and results are available. The verification status will be completed or partial depending on data availability.

​
Example Payload

{
  "webhook_id": "a12b3c4d5e6f7a8b9c0d1e2f3a4b5c6d",
  "event": "instant-verification-completed",
  "data": {
    "verification_id": "iv_8f3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c",
    "status": "completed",
    "timestamp": "2025-09-15T14:30:12.345678Z"
  }
}

​
Instant Verification Failed

Event Type: instant-verification-failed This webhook triggers when an instant verification request fails to process. This can occur due to insufficient data, invalid input, or an internal processing error.

​
Example Payload

{
  "webhook_id": "b23c4d5e6f7a8b9c0d1e2f3a4b5c6d7e",
  "event": "instant-verification-failed",
  "data": {
    "verification_id": "iv_9e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b",
    "status": "failed",
    "timestamp": "2025-09-15T15:05:33.123456Z"
  }
}

​
Common Webhook Fields

FieldDescription
webhook_idUnique identifier for the webhook delivery
eventWebhook event classification
data.verification_idThe instant verification request identifier
data.statusFinal status of the verification (completed, partial, or failed)
data.timestampISO 8601 timestamp of when the event occurred