Skip to main content
Weavr API
Corporates

Corporate beneficiary status update

Webhook/corporates/kyb/beneficiaries/watch

Sent when the verification status or details of a corporate beneficiary change. A beneficiary is a director, UBO, shareholder, or partner whose own verification feeds into the corporate's KYB outcome.

Use it to prompt a beneficiary for a fresh document before identityRestrictionDate passes and the corporate is restricted, rather than waiting for the KYB status itself to regress.

Enable and configure webhooks in the Embedder Portal; recent events are listed on its Webhook Logs page. Weavr sends this event to {Webhook URL}/corporates/kyb/beneficiaries/watch.

Payload

*
application/json

Sent on the /corporates/kyb/beneficiaries/watch webhook when the verification status or details of a corporate beneficiary change. A beneficiary is a director, UBO, shareholder, or partner whose own verification contributes to the corporate's KYB outcome.

{}
CorporateBeneficiaryEventCorporateBeneficiaryEvent · object · 4 fields

Responses

204No Content

Event received.