Webhooks

Subscribe to receive async results and event notifications instead of polling. Configure endpoint URLs and signing secrets in the Console.

Each delivery is signed. Recompute an HMAC-SHA256 of the raw body with your webhook secret and compare it to the X-Signature header. Respond with 2xx within 5 seconds. Failed deliveries retry with backoff.

Event	Fires when
verification.completed	An async verification finishes.
score.completed	A composite credit score is computed.
statement.analyzed	A statement analysis job finishes.

{
  "event": "verification.completed",
  "reference": "VR-D4ACE26C68A3",
  "status": "VERIFIED",
  "data": {
    "first_name": "JANE",
    "last_name": "WANJIKU"
  },
  "delivered_at": "2026-08-25T10:15:00Z"
}