Ownership ready webhook
Get notified once an entity's ownership structure has finished, so you know when to fetch it.
Owners can be found a short time after the verification result is sent, especially for companies with several layers of ownership. The ownership ready webhook tells you when that work has finished, so you can fetch the structure once instead of waiting a fixed time.
When it is sent
Once per entity, about 2 minutes after the last owner is found or the verification result is sent, whichever is later. If another owner is found in that time, the 2 minutes start again, so you receive one webhook rather than one per owner.
An entity with no owners still sends the webhook, with ownershipCount set to "0".
Webhook Response
{
"event": "entity.ownership_ready",
"applicantId": "1725329761404x0000000000000",
"ownershipCount": "3",
"sourceKey": "Example Source Key",
"externalUserId": "[\"user_123\"]",
"sentAt": "2026-11-03T03:19:23.417Z"
}event
Always entity.ownership_ready
applicantId
The entity's ID
ownershipCount
Number of owners found, as text
sourceKey
The source key you set when creating the entity, or null
externalUserId
A JSON-encoded string of your external user IDs
sentAt
When the webhook was sent (ISO 8601, UTC)
When you receive it, call Retrieving entity ownership structures to get the full structure.
Was this helpful?