Skip to main content
Resolve Ultimate Beneficial Owners (UBOs) for a Malaysian company by SSM number. 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: IN_PROGRESS; 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 payload also returns three list variants — uboList (natural-person UBOs at or above the threshold), allUboList (all reachable UBOs and intermediaries), and otherboList (controllers below threshold) — along with the full uboGraph keyed by rootNodeId.