compliance.ubo_chain
Trace the beneficial ownership chain for any legal entity up to 3 levels deep using GLEIF relationship records, then screen every node in the chain against the OpenSanctions consolidated sanctions list (OFAC SDN, EU, UN, UK OFSI). Returns chain structure (SUBJECT → DIRECT_PARENT → ULTIMATE_PARENT), per-node sanctions status, LEI lapse flags, overall CLEAR / REVIEW_REQUIRED / BLOCKED verdict, and FATF R.16 beneficial ownership compliance attestation. Required for correspondent banking due diligence, FATF R.12/13 UBO identification, and MiCA Article 72 counterparty risk management.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lei | Yes | 20-character GLEIF LEI of the entity to trace (e.g. "2594007XIACKNMUAW223"). | |
| deep | No | Set true to attempt 3-level traversal including intermediate nodes. Default false (direct + ultimate parent only). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Per-node: level, role, lei, entityName, country, leiStatus, sanctions (matched, score, datasets), riskFlag | |
| fatfR16 | No | FATF R.16 beneficial ownership compliance attestation | |
| riskFlags | No | Nodes with sanctions hits or lapsed LEIs | |
| chainDepth | No | ||
| overallStatus | No | ||
| ultimateBeneficialOwner | No | lei, entityName, country, leiStatus of the UBO |