> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idmetagroup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MYS UBO

> Ultimate Beneficial Owner discovery for Malaysian companies. Asynchronous.

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):

| Parameter   | Default | Meaning                                                                       |
| ----------- | ------- | ----------------------------------------------------------------------------- |
| `threshold` | `25`    | Minimum ownership percentage (combined across paths) to be reported as a UBO. |
| `layers`    | `10`    | Maximum graph depth to traverse before stopping.                              |

### Webhook outcomes

The webhook payload's `data.result.uboResult` indicates the resolution outcome:

| `uboResult`               | Meaning                                                                        |
| ------------------------- | ------------------------------------------------------------------------------ |
| `SUCCESS_UBO_FOUND`       | One or more natural-person UBOs were identified.                               |
| `SUCCESS_UBO_ENTITY_ONLY` | Top-level controllers are entities (not natural persons), within layer limits. |
| `SUCCESS_NO_UBO_FOUND`    | No 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`.