All requests must first be Authorized and must use the HTTP GET method over HTTPS.

This call allows you to purchase an Ultimate Beneficial Owner (UBO) report along with shareholder tree. This service is useful for Anti-Money Laundering (AML) or Know Your Customer (KYC) checks. This feature must be enabled on a per-account basis, so please contact our sales team.

Latest XSD schema is available - Right Click to Download here.

https://api.vision-net.ie/cws/2.3/ubo/{{COMPANY_NUM}}/report?format={{FORMAT}}&userRef={{USER_REF}}

Parameter	Type	Description
COMPANY_NUM	Positive Integer	The Irish CRO Company Number. This service does not apply to Registered Business Names.
format	XML, JSON, PDF, SVG, JPG	XML or JSON (default) return the ubo_report object PDF - Full UBO report as on VisionNet portal SVG, JPG - Ownership tree image
userRef	String	Optionally record a User Reference of your choice, for tracking your usage.

Sample response - json:

{ "ultimateBeneficialOwners" : { "ultimateBeneficialOwner" : [ { "name" : "John Doe", "sharesPercentage" : 68.9586206897, "address" : [ "ADD", "RESS", "CO.DUBLIN", "IRELAND", null ] } ] }, "ownershipTree" : { "treeNode" : [ { "id" : "1234", "parentId" : "2345", "name" : "COMPANY LIMITED", "sharesPercentage" : 6.9034482759, "country" : "IE", "level" : 2, "type" : "COMPANY" }, { "id" : "John Doe", "parentId" : "3456", "name" : "John Doe", "sharesPercentage" : 100.0, "country" : "", "level" : 3, "type" : "PERSON" }, { "id" : "3456", "parentId" : "2345", "name" : "OTHER UNLIMITED COMPANY", "sharesPercentage" : 68.9586206897, "country" : "IE", "level" : 2, "type" : "COMPANY" }, { "id" : "2345", "parentId" : "", "name" : "TECHNOLOGIES HOLDINGS", "sharesPercentage" : 0.0, "country" : "IE", "level" : 1, "type" : "COMPANY" }, { "id" : "John Smith", "parentId" : "4567", "name" : "John Smith", "sharesPercentage" : 11.1111111111, "country" : "", "level" : 3, "type" : "PERSON" }, { "id" : "Anna Gordon", "parentId" : "4567", "name" : "Anna Gordon", "sharesPercentage" : 88.8888888889, "country" : "", "level" : 3, "type" : "PERSON" }, { "id" : "4567", "parentId" : "2345", "name" : "COM DISTRIBUTION", "sharesPercentage" : 24.1379310345, "country" : "IE", "level" : 2, "type" : "COMPANY" }, { "id" : "Molly Biggle", "parentId" : "1234", "name" : "Molly Biggle", "sharesPercentage" : 100.0, "country" : "", "level" : 3, "type" : "PERSON" } ] } }

Sample response - xml:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ns2:ubo_report xmlns:ns2="https://api.vision-net.ie"> <ultimate_beneficial_owners> <ultimate_beneficial_owner> <name>John Doe</name> <shares_percentage>68.9586206897</shares_percentage> <address>ADD</address> <address>RESS</address> <address>CO.DUBLIN</address> <address>IRELAND</address> <address xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> </ultimate_beneficial_owner> </ultimate_beneficial_owners> <ownership_tree> <tree_node> <id>1234</id> <parent_id>2345</parent_id> <name>COMPANY LIMITED</name> <shares_percentage>6.9034482759</shares_percentage> <country>IE</country> <level>2</level> <type>COMPANY</type> </tree_node> <tree_node> <id>John Doe</id> <parent_id>3456</parent_id> <name>John Doe</name> <shares_percentage>100.0</shares_percentage> <country></country> <level>3</level> <type>PERSON</type> </tree_node> <tree_node> <id>3456</id> <parent_id>2345</parent_id> <name>OTHER UNLIMITED COMPANY</name> <shares_percentage>68.9586206897</shares_percentage> <country>IE</country> <level>2</level> <type>COMPANY</type> </tree_node> <tree_node> <id>2345</id> <parent_id></parent_id> <name>TECHNOLOGIES HOLDINGS</name> <shares_percentage>0.0</shares_percentage> <country>IE</country> <level>1</level> <type>COMPANY</type> </tree_node> <tree_node> <id>John Smith</id> <parent_id>4567</parent_id> <name>John Smith</name> <shares_percentage>11.1111111111</shares_percentage> <country></country> <level>3</level> <type>PERSON</type> </tree_node> <tree_node> <id>Anna Gordon</id> <parent_id>4567</parent_id> <name>Anna Gordon</name> <shares_percentage>88.8888888889</shares_percentage> <country></country> <level>3</level> <type>PERSON</type> </tree_node> <tree_node> <id>4567</id> <parent_id>2345</parent_id> <name>COM DISTRIBUTION</name> <shares_percentage>24.1379310345</shares_percentage> <country>IE</country> <level>2</level> <type>COMPANY</type> </tree_node> <tree_node> <id>Molly Biggle</id> <parent_id>1234</parent_id> <name>Molly Biggle</name> <shares_percentage>100.0</shares_percentage> <country></country> <level>3</level> <type>PERSON</type> </tree_node> </ownership_tree> </ns2:ubo_report>