Verification.Revoke

Emitted when one or more previously passed verifications have been revoked, for example due to fraudulent activity or a provider-reported error. The data.verifications array always contains at least one item and can contain multiple items when revocations are processed in bulk.

When you receive this event, you should treat the referenced verifications as no longer valid and take appropriate action (for example, re-triggering verification for affected users).

Fields

Field	Type	Required	Description
eventType	string	yes	Always "Verification.Revoke"
data	object	yes	Revocation data
data.verifications	array	yes	List of revoked verifications (minimum 1 item)
data.verifications[].id	string (UUID)	yes	The verification ID being revoked
data.verifications[].reason	string	yes	The reason for revocation: fraudulent-activity-detected or provider-reported-error

Example

Single revocation

{
  "eventType": "Verification.Revoke",
  "data": {
    "verifications": [
      {
        "id": "4e57301e-a4d1-498f-ac3f-f3d4de19abf6",
        "reason": "fraudulent-activity-detected"
      }
    ]
  }
}

Bulk revocation

{
  "eventType": "Verification.Revoke",
  "data": {
    "verifications": [
      {
        "id": "4e57301e-a4d1-498f-ac3f-f3d4de19abf6",
        "reason": "fraudulent-activity-detected"
      },
      {
        "id": "b2c8e91f-7a23-4d5c-8f1e-2a9b3c4d5e6f",
        "reason": "provider-reported-error"
      }
    ]
  }
}