Get Company UBO

Compute natural-person beneficial owners from cached German company ownership snapshots.

[!WARNING] get_company_ubo is a computed graph result from public mirror data. It is not a legal Transparenzregister extract, not AML evidence, and always includes computed_ubo: true plus the not_legal_aml_evidence warning.

Try it

Pricing

25 credits when at least one natural person reaches 25% effective ownership or control.
0 credits/refund when the company is unknown or no natural person reaches the threshold.

Endpoint

Input Parameters

Examples

curl -X POST https://api.skael.de/api/enrichments/get_company_ubo \
  -H "Authorization: Bearer eak_..." \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": "DE-HRB-F1103-267645",
    "async": true
  }'

Output Fields

Output Shape

computed_ubo is always true.
ubos[] contains natural persons whose summed effective ownership or control is at least 0.25.
effective_ownership compounds ownership along legal-person chains and sums split paths to the same natural person.
effective_control defaults to ownership when no separate control or voting share exists in the source snapshot.
paths[] lists the company IDs and ownership shares used for each path.
_registry_meta.traversal_depth and _registry_meta.total_nodes_visited expose the bounded traversal size.
_registry_meta.graph includes traversal limits, node count, actual traversal depth, and deterministic cycle paths.
_registry_meta.warnings always contains not_legal_aml_evidence and may contain cycle_detected, depth_cap_exceeded, node_cap_exceeded, edge_cap_exceeded, path_cap_exceeded, cycle_cap_exceeded, or no_natural_person_ubo_found.

Traversal uses only the latest owners snapshot per company. It is capped at depth 10, 200 unique company nodes, and bounded edge/path/cycle counts to protect workers from dense ownership graphs.

Cycles

Ownership cycles are cut deterministically. The enrichment completes, returns any UBOs reachable through non-cyclic paths, and emits cycle_detected with the cycle path in _registry_meta.graph.cycles.

Feature Disabled (403)

{
    "message": "German registry enrichments are not enabled for this organization."
}