Skip to main content
WEBHOOK
customer.status
{
  "event": {
    "id": "29ceb6c4-4849-4312-9b2b-5e8360647da0",
    "event_reference_id": "f9e1b162-8a05-4611-9e13-f38e0eb24a29",
    "type": "customer.status",
    "created_at": "2026-01-18T09:08:18.66348Z",
    "sandbox_mode": true
  },
  "data": {
    "country_of_residence": "USA",
    "created_at": "0001-01-01T00:00:00Z",
    "customer_id": "f9e1b162-8a05-4611-9e13-f38e0eb24a29",
    "customer_status": "QUEUED",
    "email": "stagetest@email.com",
    "first_name": "afroja",
    "last_name": "Testrlnc",
    "phone": "+12597751234",
    "tos_policies_url": "67bd224e-9a71-4dc0-8782-f40ac07eb94e",
    "type": "INDIVIDUAL",
    "updated_at": "0001-01-01T00:00:00Z",
    "verification_type": "STANDARD"
  }
}
This webhook is triggered when a customer’s status changes during the verification process. The event captures transitions between different customer states such as QUEUED, REVIEWING, APPROVED, ASSOCIATED_PARTIES_REMAINING, ON_HOLD, REINITIATE, and others. This allows you to track the progression of customer verification and take appropriate actions based on status changes.

​
Customer Status Values

  • QUEUED: Indicates that the verification request has been sent to the work processor and is awaiting processing.
  • REVIEWING: The customer verification is currently under review.
  • APPROVED: The customer has been successfully verified and approved.
  • ASSOCIATED_PARTIES_REMAINING: Additional associated parties need to be verified.
  • ON_HOLD: The verification process has been paused and is on hold.
  • REINITIATE: A new document needs to be uploaded for this customer and attached again to continue verification.
Security: All webhook requests include HMAC signatures for verification. Learn how to verify webhook signatures to ensure requests are authentic.

Body

application/json

Webhook triggered when a customer's status changes during verification

​
event
object
required
​
data
object
required

Individual customer data in webhook payload

Response

200

Webhook received successfully