{
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"kind": "kyb",
"event": "approved",
"submission_id": "e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8091",
"external_customer_id": "cust_456",
"status": "approved",
"risk_band": "low",
"decision_source": "auto"
}Kyb verification status changed
Fires on every KYB submission lifecycle change, including AML/risk/report signals from the review. decision_source tells whether the decision was made by the automatic engine (auto) or by a human reviewer (admin); it is present on final decisions.
WEBHOOK
kyb_verification_status_changed
{
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"kind": "kyb",
"event": "approved",
"submission_id": "e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8091",
"external_customer_id": "cust_456",
"status": "approved",
"risk_band": "low",
"decision_source": "auto"
}Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Response
200
Return any 2xx to acknowledge.