> ## 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.

# AUS UBO

> Ultimate Beneficial Owner discovery for Australian companies. Asynchronous.

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

| 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 `verificationStatus` reflects the finalised Trust Validation outcome (commonly `REVIEW_NEEDED` for graphs that require operator review).