VERIFICATION_STATUS_UPDATED Event

This webhook event is sent when the status of a verification check changes. Verification checks validate various aspects of entity data such as identity verification, address verification, or business legitimacy.

When This Event Is Sent

A user updates a specific verification status on the Underwriters Dashboard.

Decrypted Data Parameters

This event includes all default parameter for version 1.0 in the decrypted data parameter, plus the following parameters:

Parameter	Type	Required	Description
decision_type	string	Yes	The type of verification check that was performed (e.g., `entity_place_analysis`, `identity_verification`).
verification_status	string	Yes	The result of the verification check. Must be one of the VERIFICATION_STATUS values.
verification_record_ids	array	Yes	Array of verification record identifiers (UUIDs) associated with this verification decision.
decision_note	string	No	Optional human-readable note or comment about the verification decision.

Example Payload

Note: This example shows the decrypted payload. When you receive this webhook, the data field will be encrypted. See the encryption reminder for details.

{
  "id": "wh_1XDQE2Vnxk9Z8bHCjtc9nT",
  "event_type": "VERIFICATION_STATUS_UPDATED",
  "timestamp": "2026-03-18T22:15:03Z",
  "account_id": "account_id",
  "schema_version": "2025-11-21",
  "key_id": "whk_20260318_03",
  "data": {
    "version": "1.0",
    "subject_record_id": "sr_6Hnns6QjaGuoZI1vMKFUnE",
    "workflow_id": "w_3JeL6yROr7foIHe0OwbSAj",
    "workflow_type": "BUSINESS_UNDERWRITING",
    "user_context": {
      "user_id": "[email protected]",
      "user_type": "USER"
    },
    "decision_type": "entity_place_analysis",
    "verification_status": "PASS",
    "verification_record_ids": [
      "5c84b303-d484-4d05-840f-edd71be7e80a"
    ],
    "decision_note": "This information looks good."
  }
}