Extract Ultimate Beneficial Owners (real-time)

Retrieve UBOs from beneficial ownership registers (asynchronous or synchronous processing).

This operation retrieves UBO information from official beneficial ownership registers.

Typical workflow:

1. Use GET /v2/companies/search/indexed?name=...&jurisdictionCode=... to find the company and get its kausateId.
2. Call this endpoint POST /v2/companies/{kausateId}/ubo with the required request body.
3. If sync=false (default): Use the returned orderId to poll GET /v2/orders/{orderId} for the extraction result.
4. If sync=true: The response will contain the UBO data directly (300s timeout).

• kausateId: Company ID to extract UBOs for
• customerReference: Optional reference for tracking
• sync: Return result synchronously with 300s timeout (default: false)

Returns order ID for tracking (async) or UBO data (sync).

Note: This endpoint costs 10 credits per request.