Webhook Event Catalog

Complete reference of all webhook events fired by VerifyHQ. Subscribe to specific events when configuring your webhook endpoint.

Identity Events

Parameter	Type	Description
`identity.verified`	event	Full identity verification completed and approved
`identity.rejected`	event	Identity verification rejected
`identity.manual_review`	event	Verification flagged for manual review

identity.verified payloadjson

{
  "event": "identity.verified",
  "timestamp": "2026-02-18T13:35:00Z",
  "data": {
    "verificationId": "ver_abc123",
    "userId": "user_123",
    "tier": "ENHANCED",
    "status": "VERIFIED",
    "steps": {
      "document": "VERIFIED",
      "liveness": "PASSED"
    }
  }
}

Document Events

Parameter	Type	Description
`document.verified`	event	Document passed all verification checks
`document.rejected`	event	Document failed verification (tampered, expired, or unreadable)

document.verified payloadjson

{
  "event": "document.verified",
  "timestamp": "2026-02-18T13:31:45Z",
  "data": {
    "verificationId": "doc_xyz789",
    "userId": "user_123",
    "documentType": "ID_CARD",
    "documentCountry": "NG",
    "status": "VERIFIED",
    "confidence": 0.97,
    "extractedFields": {
      "fullName": "Adebayo Ogunlesi",
      "documentNumber": "A12345678"
    }
  }
}

Liveness Events

Parameter	Type	Description
`liveness.passed`	event	User passed liveness check (is alive, no spoofing)
`liveness.failed`	event	Liveness check failed (spoof detected or challenges not met)

liveness.passed payloadjson

{
  "event": "liveness.passed",
  "timestamp": "2026-02-18T13:32:00Z",
  "data": {
    "userId": "user_123",
    "sessionToken": "ses_abc123",
    "isAlive": true,
    "confidence": 0.95,
    "antiSpoofScore": 0.98
  }
}

Phone Verification Events

Parameter	Type	Description
`phone.verified`	event	Phone number successfully verified via OTP
`phone.failed`	event	Phone verification failed (expired or max attempts)

phone.verified payloadjson

{
  "event": "phone.verified",
  "timestamp": "2026-02-18T13:02:15Z",
  "data": {
    "verificationId": "pv_abc123",
    "userId": "user_123",
    "phoneNumber": "+2250700000000",
    "channel": "SMS"
  }
}

Email Verification Events

Parameter	Type	Description
`email.verified`	event	Email address successfully verified
`email.failed`	event	Email verification failed

email.verified payloadjson

{
  "event": "email.verified",
  "timestamp": "2026-02-18T13:01:45Z",
  "data": {
    "verificationId": "ev_abc123",
    "userId": "user_123",
    "email": "user@example.com",
    "method": "OTP"
  }
}

Address Verification Events

Parameter	Type	Description
`address.verified`	event	Address verified from proof-of-address document
`address.rejected`	event	Address verification rejected
`address.manual_review`	event	Address verification requires manual review

address.verified payloadjson

{
  "event": "address.verified",
  "timestamp": "2026-02-18T13:00:35Z",
  "data": {
    "verificationId": "addr_abc123",
    "userId": "user_123",
    "documentType": "UTILITY_BILL",
    "extractedAddress": "12 Rue du Commerce, Abidjan"
  }
}

AML Screening Events

Parameter	Type	Description
`aml.clear`	event	AML screening completed with no matches
`aml.flagged`	event	AML screening found matches on sanctions/PEP/adverse media lists
`aml.batch_complete`	event	Batch AML screening job completed

aml.flagged payloadjson

{
  "event": "aml.flagged",
  "timestamp": "2026-02-18T13:00:02Z",
  "data": {
    "screeningId": "aml_def456",
    "userId": "user_456",
    "riskLevel": "HIGH",
    "matchCount": 1,
    "matches": [
      {
        "listName": "PEP",
        "matchScore": 0.92,
        "matchedName": "Adebayo O. Ogunlesi"
      }
    ]
  }
}

Watchlist Monitoring Events

Parameter	Type	Description
`watchlist.alert`	event	New match detected during continuous monitoring
`watchlist.clear`	event	Previously flagged match removed from watchlists

watchlist.alert payloadjson

{
  "event": "watchlist.alert",
  "timestamp": "2026-02-18T02:05:00Z",
  "data": {
    "alertId": "alert_xyz789",
    "subscriptionId": "wl_sub_abc123",
    "userId": "user_123",
    "match": {
      "listName": "SANCTIONS",
      "matchScore": 0.94,
      "source": "OFAC SDN List"
    }
  }
}

Business Verification Events

Parameter	Type	Description
`business.verified`	event	Business verification (KYB) completed successfully
`business.rejected`	event	Business verification rejected
`business.manual_review`	event	Business verification flagged for review

business.verified payloadjson

{
  "event": "business.verified",
  "timestamp": "2026-02-18T13:05:00Z",
  "data": {
    "verificationId": "biz_abc123",
    "userId": "user_123",
    "businessName": "Korido Technologies SARL",
    "registrationNumber": "RCCM-ABJ-2024-B-12345",
    "country": "CI",
    "steps": {
      "registration": "VERIFIED",
      "directors": "VERIFIED",
      "ubo": "VERIFIED",
      "amlScreening": "CLEAR"
    }
  }
}

Biometric Deduplication Events

Parameter	Type	Description
`dedup.unique`	event	Biometric check confirmed unique identity
`dedup.match`	event	Duplicate biometric match detected

dedup.match payloadjson

{
  "event": "dedup.match",
  "timestamp": "2026-02-18T13:00:01Z",
  "data": {
    "checkId": "dedup_def456",
    "userId": "user_456",
    "matchedUserId": "user_789",
    "similarity": 0.97
  }
}

Mobile Money Events

Parameter	Type	Description
`mobile_money.verified`	event	Mobile money account ownership confirmed
`mobile_money.failed`	event	Mobile money verification failed

mobile_money.verified payloadjson

{
  "event": "mobile_money.verified",
  "timestamp": "2026-02-18T13:00:02Z",
  "data": {
    "verificationId": "mm_abc123",
    "userId": "user_123",
    "phoneNumber": "+2250700000000",
    "provider": "MTN_MOMO",
    "accountHolder": "MOUSSA KONATE",
    "nameMatch": true
  }
}