Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

This webhook is opt-in. Ask us to turn it on for your workspace. It is sent to the same endpoint, with the same token in the header, as the Setting up a webhook.

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"
}
Field
Description

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?