Skip to main content
Resolve Ultimate Beneficial Owners (UBOs) for an Australian company by ACN. UBO discovery traverses the ownership graph layer by layer to identify the natural persons (or top-level entities) who ultimately control the company. UBO is always asynchronous. The initial API response acknowledges the order with verificationStatus: REVIEW_NEEDED; the resolved ownership graph is delivered to the resultNotificationURL you supply.

​
Configuration

Two parameters control how deep and how wide the graph traversal runs. Both are configured on the Trust Flow (not in the request body):
ParameterDefaultMeaning
threshold25Minimum ownership percentage (combined across paths) to be reported as a UBO.
layers10Maximum graph depth to traverse before stopping.

​
Webhook outcomes

The webhook payload’s data.result.uboResult indicates the resolution outcome:
uboResultMeaning
SUCCESS_UBO_FOUNDOne or more natural-person UBOs were identified.
SUCCESS_UBO_ENTITY_ONLYTop-level controllers are entities (not natural persons), within layer limits.
SUCCESS_NO_UBO_FOUNDNo UBOs met the threshold.
The webhook verificationStatus reflects the finalised Trust Validation outcome (commonly REVIEW_NEEDED for graphs that require operator review).