Response code for the retrieval request. "200" indicates a successful retrieval, covering both in-progress and completed states.
Example:
"200"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema/docs.json","name":"Kyckr Developer Portal","colors":{"primary":"#0A955D","light":"#0CF191","dark":"#022A37"},"logo":{"light":"https://mintcdn.com/kyckr-0823abd6/9HYzjBYpwF1KfywI/logo/kyckr-light.svg?fit=max\u0026auto=format\u0026n=9HYzjBYpwF1KfywI\u0026q=85\u0026s=20b2e45cb5a675284a993a6e1a528191","dark":"https://mintcdn.com/kyckr-0823abd6/9HYzjBYpwF1KfywI/logo/kyckr-dark.svg?fit=max\u0026auto=format\u0026n=9HYzjBYpwF1KfywI\u0026q=85\u0026s=b662f6c44f6491f637c636b5dd752083"},"background":{"color":{"dark":"#022A37"}},"fonts":{"family":"Inter","format":"woff2"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kyckr-0823abd6","hasAudioNarration":false,"actualSubdomain":"kyckr-0823abd6","customDomains":["developer.kyckr.com"],"gitSource":{"type":"github","owner":"kyckr","repo":"kyckr-developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3c7d4f804892cd158cf8c","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":34},{"language":"default","tag":"Country Guides","count":29},{"language":"default","tag":"Documentation","count":28},{"language":"default","tag":"Europe","count":20},{"language":"default","tag":"Company V1 API","count":18},{"language":"default","tag":"Features","count":12},{"language":"default","tag":"Company V2 API","count":10},{"language":"default","tag":"Platform Details","count":8},{"language":"default","tag":"Asia-Pacific","count":7},{"language":"default","tag":"Companies","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/ubo-verify/retrieve-ownership-tree","slug":"/api-reference/ubo-verify/retrieve-ownership-tree","pageMetadata":{"title":"Retrieve Ownership Tree","description":"Check and return the results for an asynchronous request for an ownership tree.","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/uboverify/list/{orderId}","href":"/api-reference/ubo-verify/retrieve-ownership-tree","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Check and return the results for an asynchronous request for an ownership tree.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Retrieve Ownership Tree","description":"Check and return the results for an asynchronous request for an ownership tree.","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/uboverify/list/{orderId}","href":"/api-reference/ubo-verify/retrieve-ownership-tree","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Retrieve Ownership Tree","tags":["UBO Verify"],"operationId":"UboVerify_Get","description":"Check and return the results for an asynchronous request for an ownership tree.","responses":{"200":"898ef1dd-710d-468a-adab-6aff89324495","401":"3d69a532-1930-4e9d-ac8a-09a8680cfdf7","403":"12e73233-cfe7-4001-ba71-b75a3febae82","404":"8c818d79-32a1-4fef-bddf-0d48bad867cb"},"method":"get","type":"path","servers":["ab77aa9a-8800-4209-bec3-91bd345df839","2d71126a-49a7-4c75-865e-f233de1de4bf"],"security":["020739ea-5148-43cc-a9c0-4403d1e836eb"],"path":"/core/uboverify/list/{orderId}","baseUrlOptions":["https://rest.kyckr.com","https://rest.kyckr.com/test"],"title":"Retrieve Ownership Tree","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5d7257b1-94b4-475b-9fb0-a1764e2abb7b":{"schema":{"type":"string","isRequired":true,"description":"ID retrieved from create UBO order response","uniqueKey":"","typeLabel":"string"},"name":"orderId","in":"path","required":true,"description":"ID retrieved from create UBO order response"}},"responses":{"898ef1dd-710d-468a-adab-6aff89324495":{"description":"Example response","content":{"application/json":{"schema":{"type":"object","properties":{"ownershipTreeField":{"type":"object","properties":{"idField":{"type":"string","description":"Unique identifier for this specific ownership tree version. Multiple versions can exist as the ownership structure evolves over time.","example":"2700226","uniqueKey":"ownershipTreeField.idField","typeLabel":"string"},"nameField":{"type":"string","description":"Name of the root company of this UBO request.","example":"EXAMPLE COMPANY PTE. LTD.","uniqueKey":"ownershipTreeField.nameField","typeLabel":"string"},"addressField":{"type":"string","description":"Registered address of the root company.","example":"123 Business Street, Financial District, 123456","uniqueKey":"ownershipTreeField.addressField","typeLabel":"string"},"nodesField":{"type":"array","description":"Array of nodes representing entities in the ownership tree. Each node contains details about a company, person, or other entity at a specific level in the ownership hierarchy.","items":{"type":"object","properties":{"levelField":{"type":"integer","description":"Hierarchical level of this entity in the ownership tree, where 1 is the root company and higher numbers are deeper in the ownership structure.","minimum":1,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].levelField","typeLabel":"integer"},"entityField":{"type":"object","description":"Detailed information about the entity at this node.","properties":{"idField":{"type":"string","description":"Unique identifier for this entity within this ownership tree.","example":"2efd9277-1e7b-4bf1-98b8-96ae6988b071","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.idField","typeLabel":"string"},"typeField":{"type":"string","description":"Type of entity - COMPANY for corporate entities, PERSON for individual entities, or OTHER for entities that are neither (for example trusts or other arrangements).","enum":["COMPANY","PERSON","OTHER"],"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.typeField","typeLabel":"enum\u003cstring>"},"nameField":{"type":"string","description":"Legal name of the entity in its original language/script.","example":"EXAMPLE SUBSIDIARY CO. LTD.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.nameField","typeLabel":"string"},"nameInEnglishField":{"type":"string","description":"English transliteration of the entity name.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.nameInEnglishField","typeLabel":"string"},"countryISOField":{"type":"string","description":"Two-letter ISO country code where the entity is registered or domiciled.","example":"SG","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.countryISOField","typeLabel":"string"},"companyCodeField":{"type":"string","description":"Official registration number or code for the entity in its jurisdiction.","example":"123456789A","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.companyCodeField","typeLabel":"string"},"addressField":{"type":"string","description":"Registered address of the entity.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.addressField","typeLabel":"string"},"linksField":{"type":"object","description":"External links and resources related to this entity.","properties":{"enhancedProfileField":{"type":"string","format":"uri","description":"URL to download an enhanced company profile for this entity. **Changing on 23 November 2026:** from 08:30 GMT, this link moves to `document.kyckr.com`, carries `expires` and `token` parameters, and is valid for 30 days from issue. Use it exactly as returned; no Authorization header is needed. Links in the current `download.kyckr.com` format stop working on 23 December 2026. See the [release note](/company-v1/developer-news/2026-11-signed-document-links).","example":"https://download.kyckr.com/file/json/1231231234-0","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.linksField.enhancedProfileField","typeLabel":"string\u003curi>"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.linksField","typeLabel":"object"},"registrationAuthorityField":{"type":"string","description":"Name of the registration authority where the entity is registered.","example":"Companies House, United Kingdom","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.registrationAuthorityField","typeLabel":"string"},"registrationAuthorityCodeField":{"type":"string","description":"Code identifier for the registration authority.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.registrationAuthorityCodeField","typeLabel":"string"},"reasonForNonContinuationField":{"type":"object","description":"Information explaining why the ownership analysis did not proceed for this entity.\nReasons fall into three categories:\n\n**Requires user confirmation (candidatesField populated — review and select via continuation key):**\n- `LOW_CONFIDENCE_MATCH`: A single matching company was found, but confidence is insufficient to continue automatically.\n- `COMPANY_NOT_FOUND`: No matching company in registry, or multiple companies share the same name (in one or more jurisdictions). Candidates are returned when ambiguous same-name matches exist.\n\n**Hard failures (cannot proceed):**\n- `REGISTRY_NOT_AVAILABLE`: Registry data unavailable\n- `NO_SHAREHOLDERS`: No shareholder data exists\n- `UNSUPPORTED_JURISDICTION`: Jurisdiction not supported\n- `INVALID_REGAUTH`: Invalid registration authority\n- `POSSIBLE_PLC`: Public company (shareholders not tracked)\n- `SERVER_ERROR`: System error during resolution\n- `DESERIALIZATION_ERROR_ENHANCED_PROFILE`: Data parsing error\n\n**Resource limits:**\n- `INSUFFICIENT_MAX_CREDIT_COST`: Would exceed credit budget\n- `INSUFFICIENT_MAX_LAYERS`: Maximum depth reached\n- `INSUFFICIENT_CREDITS`: Account credits exhausted\n- `SHAREHOLDING_TOO_LOW`: Ownership below threshold\n","properties":{"detailsField":{"type":"string","description":"Human-readable explanation of why continuation stopped. Provides\ncontext for audit and support workflows. Examples:\n","example":"Multiple matches with the same name in the same jurisdiction","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.detailsField","typeLabel":"string"},"typeField":{"type":"string","description":"Type of continuation barrier encountered. See object description\nfor categorization of each type.\n","enum":["COMPANY_NOT_FOUND","INSUFFICIENT_MAX_CREDIT_COST","REGISTRY_NOT_AVAILABLE","NO_SHAREHOLDERS","INSUFFICIENT_CREDITS","DESERIALIZATION_ERROR_ENHANCED_PROFILE","SERVER_ERROR","UNSUPPORTED_JURISDICTION","INSUFFICIENT_MAX_LAYERS","SHAREHOLDING_TOO_LOW","INVALID_REGAUTH","POSSIBLE_PLC","LOW_CONFIDENCE_MATCH"],"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.typeField","typeLabel":"enum\u003cstring>"},"candidatesField":{"type":"array","description":"List of candidate entities to select from for continuation. Populated for LOW_CONFIDENCE_MATCH, and for COMPANY_NOT_FOUND when multiple same-name matches were found.","items":{"type":"object","properties":{"addressField":{"type":"string","description":"Address of the candidate entity.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.candidatesField.items.[INDEX].addressField","typeLabel":"string"},"companyIdField":{"type":"string","description":"Registration ID of the candidate entity.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.candidatesField.items.[INDEX].companyIdField","typeLabel":"string"},"companyNameField":{"type":"string","description":"Name of the candidate entity.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.candidatesField.items.[INDEX].companyNameField","typeLabel":"string"},"countryIsoField":{"type":"string","description":"Country code of the candidate entity.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.candidatesField.items.[INDEX].countryIsoField","typeLabel":"string"},"registrationAuthorityField":{"type":"string","description":"Registration authority of the candidate entity.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.candidatesField.items.[INDEX].registrationAuthorityField","typeLabel":"string"},"continuationKeyField":{"type":"string","format":"uuid","description":"Continuation key to use for selecting this candidate in a subsequent request.","example":"ba26a0bb-f632-4421-8092-58ed3a76d3be","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.candidatesField.items.[INDEX].continuationKeyField","typeLabel":"string\u003cuuid>"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.candidatesField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.candidatesField","typeLabel":"object[]"},"continuationKeyField":{"type":"string","format":"uuid","description":"Continuation key that can be used to continue the analysis from this point. For example, INSUFFICIENT_MAX_CREDIT_COST, will trigger this continuation key.","example":"1bb8bdd5-7484-401e-b049-9d4dec3dcd9c","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField.continuationKeyField","typeLabel":"string\u003cuuid>"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField.reasonForNonContinuationField","typeLabel":"object"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entityField","typeLabel":"object"},"edgesField":{"type":"array","description":"Array of relationships (edges) from this entity to other entities in the ownership structure.","items":{"type":"object","properties":{"nodeIdField":{"type":"string","description":"Unique identifier referencing another entity in the ownership tree.","example":"dcc4311c-d1dd-4fe1-9fd6-178f691c2160","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].nodeIdField","typeLabel":"string"},"typeField":{"type":"string","description":"Type of relationship to the target entity.","enum":["SHAREHOLDER","REPRESENTATIVE"],"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].typeField","typeLabel":"enum\u003cstring>"},"percentageField":{"type":"number","description":"Percentage ownership or control that this entity has over the target entity. Only applicable for SHAREHOLDER relationships. When percentageIsRangeField is true, this is the upper bound of the band.","minimum":0,"maximum":100,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].percentageField","typeLabel":"number"},"percentageIsRangeField":{"type":"boolean","description":"True when the register records this holding as a band rather than an exact figure, as the Danish Business Authority does. percentageLowerField and percentageUpperField then give the band. Returned only for a band.","example":true,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].percentageIsRangeField","typeLabel":"boolean"},"percentageLowerField":{"type":"number","description":"Lower bound of the holding band. Present when percentageIsRangeField is true.","minimum":0,"maximum":100,"example":10,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].percentageLowerField","typeLabel":"number"},"percentageUpperField":{"type":"number","description":"Upper bound of the holding band. Present when percentageIsRangeField is true.","minimum":0,"maximum":100,"example":14.99,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].percentageUpperField","typeLabel":"number"},"isCircularField":{"type":"boolean","description":"Indicates whether this relationship creates a circular ownership structure.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].isCircularField","typeLabel":"boolean"},"roleField":{"type":"string","description":"Specific role or position held by this entity. Only applicable for REPRESENTATIVE relationships.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].roleField","typeLabel":"string"},"nameField":{"type":"string","description":"Shareholder name as recorded by the parent company. Compare with\nthe resolved entity's nameField (node.entity.nameField) to see\nname variations and normalization effects. Particularly useful\nin multi-parent scenarios where the same entity may appear under\ndifferent names.\n","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].nameField","typeLabel":"string"},"addressField":{"type":"string","description":"Shareholder address as recorded by the parent company. May differ from\nthe resolved entity's addressField when the parent has older or different\nrecords. Compare with node.entity.addressField for the canonical address.\n","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].addressField","typeLabel":"string"},"shareholdingsField":{"type":"array","description":"Detailed breakdown of shareholdings","items":{"type":"object","properties":{"isJointlyHeldField":{"type":"boolean","description":"Indicates if these shares are held jointly with other shareholders.","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].shareholdingsField.items.[INDEX].isJointlyHeldField","typeLabel":"boolean"},"jointHoldingGroupIdField":{"type":"string","format":"uuid","description":"Unique identifier grouping together shareholders who jointly hold shares. Only present when isJointlyHeldField is true.","example":"378202dd-4a52-4f96-b9d7-62f4a16665bb","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].shareholdingsField.items.[INDEX].jointHoldingGroupIdField","typeLabel":"string\u003cuuid>"},"percentageField":{"type":"number","description":"Percentage of ownership for this specific shareholding. When percentageIsRangeField is true, this is the upper bound of the band.","minimum":0,"maximum":100,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].shareholdingsField.items.[INDEX].percentageField","typeLabel":"number"},"percentageIsRangeField":{"type":"boolean","description":"True when the register records this shareholding as a band rather than an exact figure. percentageLowerField and percentageUpperField then give the band. Returned only for a band.","example":true,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].shareholdingsField.items.[INDEX].percentageIsRangeField","typeLabel":"boolean"},"percentageLowerField":{"type":"number","description":"Lower bound of the shareholding band. Present when percentageIsRangeField is true.","minimum":0,"maximum":100,"example":10,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].shareholdingsField.items.[INDEX].percentageLowerField","typeLabel":"number"},"percentageUpperField":{"type":"number","description":"Upper bound of the shareholding band. Present when percentageIsRangeField is true.","minimum":0,"maximum":100,"example":14.99,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].shareholdingsField.items.[INDEX].percentageUpperField","typeLabel":"number"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].shareholdingsField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX].shareholdingsField","typeLabel":"object[]"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].edgesField","typeLabel":"object[]"},"rollupPercentageField":{"type":"number","description":"Calculated cumulative ownership percentage that this entity represents in the root company, taking into account the full ownership chain. Only present for entities that are not at level 1. When rollupPercentageIsRangeField is true, this is the upper bound of the range.","minimum":0,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].rollupPercentageField","typeLabel":"number"},"rollupPercentageIsRangeField":{"type":"boolean","description":"True when a holding in this entity's ownership chain is a band, so its cumulative ownership in the root company is a range. rollupPercentageLowerField and rollupPercentageUpperField then give the range. Returned only for a range.","example":true,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].rollupPercentageIsRangeField","typeLabel":"boolean"},"rollupPercentageLowerField":{"type":"number","description":"Cumulative ownership in the root company calculated from the lower bound of every band in the chain, rounded down to two decimal places. Present when rollupPercentageIsRangeField is true.","minimum":0,"maximum":100,"example":10,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].rollupPercentageLowerField","typeLabel":"number"},"rollupPercentageUpperField":{"type":"number","description":"Cumulative ownership in the root company calculated from the upper bound of every band in the chain, rounded up to two decimal places. Present when rollupPercentageIsRangeField is true.","minimum":0,"example":14.99,"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].rollupPercentageUpperField","typeLabel":"number"},"entitySelectionMetadataField":{"oneOf":[{"type":"object","description":"Metadata documenting how this entity was selected or resolved in the ownership tree. Indicates whether the entity was automatically resolved by the algorithm or manually selected via continuation. Null (absent) for the root node — the requested company is not itself resolved via entity resolution. Present on resolved nodes.","properties":{"sourceField":{"type":"string","enum":["ALGORITHM","USER_SELECTED"],"description":"How this entity was selected:\n- `ALGORITHM`: Entity automatically resolved by the system's matching algorithm\n- `USER_SELECTED`: Entity manually selected via continuation key\n","example":"ALGORITHM","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entitySelectionMetadataField.oneOf.0.sourceField","typeLabel":"enum\u003cstring>"},"continuationKeyField":{"type":"string","format":"uuid","description":"The specific continuation key that was used to select this entity. Only present when sourceField is USER_SELECTED.","example":"812a3543-2e95-4bda-a357-88b023392f28","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entitySelectionMetadataField.oneOf.0.continuationKeyField","typeLabel":"string\u003cuuid>"},"dateSelectedField":{"type":"string","format":"date-time","description":"Timestamp when this entity was resolved or selected. Returned for both USER_SELECTED and ALGORITHM resolutions.","example":"2026-01-14T07:51:31.0470409Z","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entitySelectionMetadataField.oneOf.0.dateSelectedField","typeLabel":"string\u003cdate-time>"},"matchVerificationField":{"type":"string","enum":["NAME_ONLY","NAME_AND_JURISDICTION"],"description":"For algorithm-resolved entities, indicates how the automated match was verified.\nAn entity is resolved automatically only when a single unambiguous match is\nfound; where competing or near matches exist, none is auto-selected — the\ncandidates are surfaced for manual selection via continuation\n(sourceField = USER_SELECTED). The value records the basis of that single match:\n- `NAME_ONLY`: the company name alone produced a single match, with no\n jurisdiction filter applied — no usable address was available on the\n shareholder record to derive a jurisdiction. Because the name search does\n not cover every jurisdiction and company names are not globally unique, a\n matching entity in another jurisdiction cannot be excluded.\n- `NAME_AND_JURISDICTION`: the company name produced a single match within a\n jurisdiction derived from the shareholder address. Address quality is not\n guaranteed; the jurisdiction is a best-effort derivation.\nPresent when `sourceField` is `ALGORITHM`.\n","example":"NAME_AND_JURISDICTION","uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entitySelectionMetadataField.oneOf.0.matchVerificationField","typeLabel":"enum\u003cstring>"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entitySelectionMetadataField.oneOf.0","typeLabel":"object"},{"type":"null","description":"Metadata documenting how this entity was selected or resolved in the ownership tree. Indicates whether the entity was automatically resolved by the algorithm or manually selected via continuation. Null (absent) for the root node — the requested company is not itself resolved via entity resolution. Present on resolved nodes.","properties":{"sourceField":{"type":"string","enum":["ALGORITHM","USER_SELECTED"],"description":"How this entity was selected:\n- `ALGORITHM`: Entity automatically resolved by the system's matching algorithm\n- `USER_SELECTED`: Entity manually selected via continuation key\n","example":"ALGORITHM"},"continuationKeyField":{"type":"string","format":"uuid","description":"The specific continuation key that was used to select this entity. Only present when sourceField is USER_SELECTED.","example":"812a3543-2e95-4bda-a357-88b023392f28"},"dateSelectedField":{"type":"string","format":"date-time","description":"Timestamp when this entity was resolved or selected. Returned for both USER_SELECTED and ALGORITHM resolutions.","example":"2026-01-14T07:51:31.0470409Z"},"matchVerificationField":{"type":"string","enum":["NAME_ONLY","NAME_AND_JURISDICTION"],"description":"For algorithm-resolved entities, indicates how the automated match was verified.\nAn entity is resolved automatically only when a single unambiguous match is\nfound; where competing or near matches exist, none is auto-selected — the\ncandidates are surfaced for manual selection via continuation\n(sourceField = USER_SELECTED). The value records the basis of that single match:\n- `NAME_ONLY`: the company name alone produced a single match, with no\n jurisdiction filter applied — no usable address was available on the\n shareholder record to derive a jurisdiction. Because the name search does\n not cover every jurisdiction and company names are not globally unique, a\n matching entity in another jurisdiction cannot be excluded.\n- `NAME_AND_JURISDICTION`: the company name produced a single match within a\n jurisdiction derived from the shareholder address. Address quality is not\n guaranteed; the jurisdiction is a best-effort derivation.\nPresent when `sourceField` is `ALGORITHM`.\n","example":"NAME_AND_JURISDICTION"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entitySelectionMetadataField.oneOf.1","typeLabel":"null"}],"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX].entitySelectionMetadataField","typeLabel":"object | null"}},"uniqueKey":"ownershipTreeField.nodesField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ownershipTreeField.nodesField","typeLabel":"object[]"},"ultimateBeneficialOwnersField":{"type":"array","description":"Summary list of persons determined to be Ultimate Beneficial Owners (UBOs) based on the uboThresholdField percentage. Only includes entities that meet or exceed the threshold. An owner whose holding is a range is included when the upper bound reaches the threshold, before that bound is rounded, so an owner shown with an upper bound equal to the threshold can fall outside this list. Percentages in this list can total more than 100 when holdings are ranges or jointly held.","items":{"type":"object","properties":{"idField":{"type":"string","description":"Unique identifier for this UBO, corresponding to an entity ID in the nodesField array.","example":"907bae93-f2d4-4c8c-95b2-f10fe9c89f2f","uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].idField","typeLabel":"string"},"nameField":{"type":"string","description":"Legal name of the Ultimate Beneficial Owner.","uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].nameField","typeLabel":"string"},"nameInEnglishField":{"type":"string","description":"English transliteration of the UBO's name.","uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].nameInEnglishField","typeLabel":"string"},"percentageField":{"type":"string","description":"Total percentage of beneficial ownership this person has in the root company. When percentageIsRangeField is true, this is the upper bound of the range.","uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].percentageField","typeLabel":"string"},"percentageIsRangeField":{"type":"boolean","description":"True when this person's beneficial ownership in the root company is a range because a holding in the chain is a band. percentageLowerField and percentageUpperField then give the range. Returned only for a range.","example":true,"uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].percentageIsRangeField","typeLabel":"boolean"},"percentageLowerField":{"type":"string","description":"Lower bound of this person's beneficial ownership in the root company, rounded down to two decimal places. Present when percentageIsRangeField is true.","example":"38.33","uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].percentageLowerField","typeLabel":"string"},"percentageUpperField":{"type":"string","description":"Upper bound of this person's beneficial ownership in the root company, rounded up to two decimal places. Present when percentageIsRangeField is true.","example":"59.98","uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].percentageUpperField","typeLabel":"string"},"entityTypeField":{"type":"string","description":"Type of the beneficial owner entity.","enum":["PERSON","COMPANY"],"uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].entityTypeField","typeLabel":"enum\u003cstring>"},"addressField":{"type":"string","description":"Known address of the Ultimate Beneficial Owner.","uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX].addressField","typeLabel":"string"}},"uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ownershipTreeField.ultimateBeneficialOwnersField","typeLabel":"object[]"},"statusField":{"type":"string","description":"Status of the UBO request.","enum":["COMPANY_NOT_FOUND","IN_PROGRESS","INSUFFICIENT_CREDITS","INSUFFICIENT_MAX_CREDIT_COST","INSUFFICIENT_MAX_LAYERS","NO_SHAREHOLDERS","ORDER_NOT_FOUND","REGISTRY_NOT_AVAILABLE","SERVICE_UNAVAILABLE","SUCCESS"],"uniqueKey":"ownershipTreeField.statusField","typeLabel":"enum\u003cstring>"},"errorStatusExtraInfoField":{"type":"string","description":"Additional error information when status is not SUCCESS. Provides detailed explanation of the failure reason.","example":"No shareholder data available to display ownership","uniqueKey":"ownershipTreeField.errorStatusExtraInfoField","typeLabel":"string"},"uboThresholdField":{"type":"integer","description":"User's requested threshold percentage for determining beneficial ownership. Entities with ownership percentage at or above this threshold are considered Ultimate Beneficial Owners (UBOs). A holding given as a range is compared with the threshold using its upper bound.","minimum":1,"maximum":100,"uniqueKey":"ownershipTreeField.uboThresholdField","typeLabel":"integer"},"maxCreditCostField":{"type":"integer","description":"Maximum number of credits the user was willing to spend on this UBO request. Controls the depth and breadth of the ownership tree analysis.","minimum":1,"uniqueKey":"ownershipTreeField.maxCreditCostField","typeLabel":"integer"},"maxLayersField":{"type":"integer","description":"Maximum number of layers (levels) in the ownership hierarchy that will be analyzed. Deeper layers require more credits.","minimum":3,"uniqueKey":"ownershipTreeField.maxLayersField","typeLabel":"integer"},"dateCreatedField":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the UBO request was processed.","uniqueKey":"ownershipTreeField.dateCreatedField","typeLabel":"string\u003cdate-time>"},"regAuthField":{"type":"string","description":"Name of the registration authority for the root company node.","example":"Companies House, United Kingdom","uniqueKey":"ownershipTreeField.regAuthField","typeLabel":"string"},"retrievalLocationField":{"type":"string","format":"uri","description":"URL link to download a PDF report of the complete UBO analysis results. **Changing on 23 November 2026:** from 08:30 GMT, this link moves to `document.kyckr.com`, carries `expires` and `token` parameters, and is valid for 30 days from issue. Use it exactly as returned; no Authorization header is needed. Links in the current `download.kyckr.com` format stop working on 23 December 2026. See the [release note](/company-v1/developer-news/2026-11-signed-document-links).","example":"https://download.kyckr.com/file/1231231234","uniqueKey":"ownershipTreeField.retrievalLocationField","typeLabel":"string\u003curi>"},"totalCreditsSpentField":{"type":"integer","description":"Total number of credits consumed during this UBO request. This may be less than or equal to maxCreditCostField.","minimum":0,"uniqueKey":"ownershipTreeField.totalCreditsSpentField","typeLabel":"integer"},"unwrapFeeField":{"type":"integer","description":"Fee charged for unwrapping the ownership structure, separate from the credit cost for data retrieval.","uniqueKey":"ownershipTreeField.unwrapFeeField","typeLabel":"integer"},"countryISOField":{"type":"string","description":"Two-letter ISO country code of the root company's jurisdiction.","uniqueKey":"ownershipTreeField.countryISOField","typeLabel":"string"},"companyCodeField":{"type":"string","description":"Company registration code of the root entity.","uniqueKey":"ownershipTreeField.companyCodeField","typeLabel":"string"},"continuationKeysUsedField":{"type":"array","description":"List of continuation keys that were used to continue the ownership analysis from previous requests or to resolve ambiguous company matches.","items":{"type":"string","format":"uuid","uniqueKey":"ownershipTreeField.continuationKeysUsedField.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"ownershipTreeField.continuationKeysUsedField","typeLabel":"string\u003cuuid>[]"},"selectedCandidatesField":{"type":"array","description":"Historical record of candidate selections made during continuation process when multiple matching companies were found. Provides audit trail showing which specific entities were chosen to continue the ownership tree analysis.","items":{"type":"object","properties":{"parentNodeIdField":{"type":"string","format":"uuid","description":"The node ID where multiple candidate matches appeared, triggering the need for selection.","example":"2e777682-3efc-478f-8472-fd78efb7f60e","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].parentNodeIdField","typeLabel":"string\u003cuuid>"},"candidateField":{"type":"object","description":"Details of the candidate that was selected from the available options.","properties":{"addressField":{"type":"string","description":"Address of the selected candidate company.","example":"145 LONDON ROAD, KINGSTON UPON THAMES, SURREY","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].candidateField.addressField","typeLabel":"string"},"companyIdField":{"type":"string","description":"Kyckr's internal company identifier for the selected candidate.","example":"01329311","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].candidateField.companyIdField","typeLabel":"string"},"companyNameField":{"type":"string","description":"Name of the selected candidate company.","example":"WOLTERS KLUWER HOLDINGS (UK) LIMITED","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].candidateField.companyNameField","typeLabel":"string"},"countryIsoField":{"type":"string","description":"ISO country code for the selected candidate.","example":"GB","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].candidateField.countryIsoField","typeLabel":"string"},"registrationAuthorityField":{"type":"string","description":"Registration authority for the selected candidate (optional).","example":"Companies House","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].candidateField.registrationAuthorityField","typeLabel":"string"},"continuationKeyField":{"type":"string","format":"uuid","description":"The continuation key that was used to select this candidate.","example":"15ce9621-87f9-49b5-bac2-6497b2c38cd9","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].candidateField.continuationKeyField","typeLabel":"string\u003cuuid>"}},"uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].candidateField","typeLabel":"object"},"nodeIdField":{"type":"string","format":"uuid","description":"The node ID that was created from this candidate selection, allowing you to trace which node resulted from which continuation choice.","example":"dac4985e-501d-41f7-933b-44c0b8de0f54","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].nodeIdField","typeLabel":"string\u003cuuid>"},"dateSelectedField":{"type":"string","format":"date-time","description":"Timestamp when this candidate was selected.","example":"2026-01-14T07:49:43.2377905Z","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].dateSelectedField","typeLabel":"string\u003cdate-time>"},"orderIdField":{"type":"string","description":"The order ID when this selection was made, linking to the specific UBO request version.","example":"332003","uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX].orderIdField","typeLabel":"string"}},"uniqueKey":"ownershipTreeField.selectedCandidatesField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ownershipTreeField.selectedCandidatesField","typeLabel":"object[]"},"previousVersionsField":{"type":"array","description":"Ordered list of previous order IDs in the continuation chain, showing the evolution history of this ownership tree. Each entry represents a prior version before continuation selections were made.","items":{"type":"string","uniqueKey":"ownershipTreeField.previousVersionsField.items.[INDEX]","typeLabel":"string"},"example":["332003","331999"],"uniqueKey":"ownershipTreeField.previousVersionsField","typeLabel":"string[]"}},"uniqueKey":"ownershipTreeField","typeLabel":"object"},"uboAnalysisField":{"type":"object","description":"Advanced UBO discovery completion status, metrics, and actionable recommendations.","properties":{"statusField":{"type":"string","enum":["COMPLETE_UBO_IDENTIFIED","COMPLETE_BELOW_THRESHOLD","INCOMPLETE_REQUIRED_PROFILES","INCOMPLETE_NO_SHAREHOLDERS","INCOMPLETE_BLOCKING_RFNC","INCOMPLETE_CIRCULAR_OWNERSHIP","INDETERMINATE_CORRUPT_DATA","INDETERMINATE_INSUFFICIENT_DATA","PLC_NO_SHAREHOLDERS_EXPECTED","UNKNOWN"],"description":"Overall UBO discovery completion status. \n\n**Complete statuses:**\n- `COMPLETE_UBO_IDENTIFIED`: Discovery is complete - found one or more UBOs above threshold\n- `COMPLETE_BELOW_THRESHOLD`: Discovery is complete - all shareholders below threshold\n\n**Incomplete statuses** (missing data prevents completion):\n- `INCOMPLETE_REQUIRED_PROFILES`: Additional company profiles needed - see requiredProfilesField for recommendations\n- `INCOMPLETE_NO_SHAREHOLDERS`: No shareholder data available for root company\n- `INCOMPLETE_BLOCKING_RFNC`: Required profiles ordered but have blocking errors\n- `INCOMPLETE_CIRCULAR_OWNERSHIP`: Circular ownership structure detected\n\n**Indeterminate statuses** (data quality issues prevent analysis):\n- `INDETERMINATE_CORRUPT_DATA`: Shareholder data corrupt (total ownership = 0%)\n- `INDETERMINATE_INSUFFICIENT_DATA`: Shareholding covering insufficient to comprehensively determine UBOs (i.e. total percent is less than 100% - threshold). A root company registered in Denmark is exempt from this check: registration with the Danish Business Authority is required from 5% ownership, so a Danish company's registered holdings can total less than 100%.\n\n**Special cases:**\n- `PLC_NO_SHAREHOLDERS_EXPECTED`: Public company with expected lack of shareholder data\n- `UNKNOWN`: Fallback value (scenario not covered by this enum)\n","example":"INCOMPLETE_REQUIRED_PROFILES","uniqueKey":"uboAnalysisField.statusField","typeLabel":"enum\u003cstring>"},"blockingReasonField":{"type":"string","description":"When status indicates an incomplete analysis, provides a summary of\nthe primary blocking reason with jurisdiction context.\nFormat: \"REASON_CODE (JURISDICTION)\" or just \"REASON_CODE\"\n","example":"NO_SHAREHOLDERS (FR)","uniqueKey":"uboAnalysisField.blockingReasonField","typeLabel":"string"},"metricsField":{"type":"object","description":"Quantitative metrics measuring the quality and completeness of the UBO analysis.","properties":{"uboCoverageField":{"type":"number","format":"float","description":"Percentage of root company ownership traced to identified UBOs (0-100).\nHigher values indicate more complete beneficial ownership identification.\nUse for risk scoring thresholds (e.g., require ≥80% for approval).\nA holding given as a range counts at its lower bound.\n","minimum":0,"maximum":100,"example":46.14,"uniqueKey":"uboAnalysisField.metricsField.uboCoverageField","typeLabel":"number\u003cfloat>"},"shareholdingCoverageField":{"type":"number","format":"float","description":"Percentage of root company ownership successfully analyzed through the tree (0-100).\nIndicates how much of the ownership structure was explored.\nUse for data completeness assessment. 100% with low uboCoverage means\nmore profiles need to be ordered.\nA holding given as a range counts at its lower bound.\n","minimum":0,"maximum":100,"example":100,"uniqueKey":"uboAnalysisField.metricsField.shareholdingCoverageField","typeLabel":"number\u003cfloat>"},"unpurchasedTotalField":{"type":"number","format":"float","description":"Percentage of ownership held in entities without enhanced profiles.\nRepresents the ownership gap that could be filled by ordering additional profiles.\nUse for gap analysis and continuation strategy planning.\nHigh values indicate clear opportunities to improve coverage.\nWhen unpurchasedTotalIsRangeField is true, this is the upper bound of the range.\n","minimum":0,"example":24.06,"uniqueKey":"uboAnalysisField.metricsField.unpurchasedTotalField","typeLabel":"number\u003cfloat>"},"unpurchasedTotalIsRangeField":{"type":"boolean","description":"True when a holding in an entity without an enhanced profile is a band, so the unpurchased total is a range. unpurchasedTotalLowerField and unpurchasedTotalUpperField then give the range. Returned only for a range.","example":true,"uniqueKey":"uboAnalysisField.metricsField.unpurchasedTotalIsRangeField","typeLabel":"boolean"},"unpurchasedTotalLowerField":{"type":"number","format":"float","description":"Unpurchased total calculated from the lower bound of each band, with exact holdings counted at their figure. Present when unpurchasedTotalIsRangeField is true.","minimum":0,"maximum":100,"example":50,"uniqueKey":"uboAnalysisField.metricsField.unpurchasedTotalLowerField","typeLabel":"number\u003cfloat>"},"unpurchasedTotalUpperField":{"type":"number","format":"float","description":"Unpurchased total calculated from the upper bound of each band, with exact holdings counted at their figure. Present when unpurchasedTotalIsRangeField is true.","minimum":0,"example":66.66,"uniqueKey":"uboAnalysisField.metricsField.unpurchasedTotalUpperField","typeLabel":"number\u003cfloat>"},"enhancedProfilesPurchasedField":{"type":"integer","description":"Number of enhanced company profiles retrieved during this analysis.","minimum":0,"example":5,"uniqueKey":"uboAnalysisField.metricsField.enhancedProfilesPurchasedField","typeLabel":"integer"}},"uniqueKey":"uboAnalysisField.metricsField","typeLabel":"object"},"requiredProfilesField":{"type":"array","description":"Prioritized list of companies that should be ordered to improve\nUBO coverage. Ranked by potential impact - ordering profiles at\nthe top of the list will likely increase uboCoverageField the most.\n","items":{"type":"object","properties":{"entityIdField":{"type":"string","format":"uuid","description":"UUID referencing the entity in the nodesField array.","example":"5ac26d8e-0ade-4c28-9a3d-f490a07adfad","uniqueKey":"uboAnalysisField.requiredProfilesField.items.[INDEX].entityIdField","typeLabel":"string\u003cuuid>"},"entityNameField":{"type":"string","description":"Name of the company requiring enhanced profile data.","example":"INDEX VENTURES IX (JERSEY) L.P.","uniqueKey":"uboAnalysisField.requiredProfilesField.items.[INDEX].entityNameField","typeLabel":"string"},"companyCodeField":{"type":"string","description":"Registration number of the entity.","example":"REG123","uniqueKey":"uboAnalysisField.requiredProfilesField.items.[INDEX].companyCodeField","typeLabel":"string"}},"uniqueKey":"uboAnalysisField.requiredProfilesField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"uboAnalysisField.requiredProfilesField","typeLabel":"object[]"},"potentialBeneficialOwnersField":{"type":"array","description":"Potentially beneficial owners - potential to exceed threshold with additional profile orders, or through name similarity analysis, helping detect consolidated ownership that may exceed UBO thresholds.","items":{"type":"object","properties":{"canonicalNameField":{"type":"string","description":"Representative name chosen for this group of related individuals.","example":"JONATHAN DAVIES","uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].canonicalNameField","typeLabel":"string"},"totalOwnershipField":{"type":"number","format":"float","description":"For MULTIPLE_NON_UBOS_COMBINED_TO_UBO, the combined beneficial ownership percentage of all members in this group, which may exceed the UBO threshold even if individual holdings do not. For NON_UBO_MAY_REACH_THRESHOLD_WITH_FURTHER_PURCHASE, the most the group could hold in the root company, which is its current holding plus all root company ownership held through entities whose ownership was not traced, with each range counted at its upper bound, so this figure can exceed 100. When totalOwnershipIsRangeField is true, this is the upper bound of the range.","minimum":0,"example":29.62,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].totalOwnershipField","typeLabel":"number\u003cfloat>"},"totalOwnershipIsRangeField":{"type":"boolean","description":"True when the group's total ownership is a range, as it is in any jurisdiction for a group that may reach the threshold with further profile orders. totalOwnershipLowerField and totalOwnershipUpperField then give the range.","example":true,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].totalOwnershipIsRangeField","typeLabel":"boolean"},"totalOwnershipLowerField":{"type":"number","format":"float","description":"Lower bound of the group's total ownership, equal to currentHoldingLowerField when that field is present and to currentHoldingField otherwise. Present when totalOwnershipIsRangeField is true.","minimum":0,"maximum":100,"example":10,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].totalOwnershipLowerField","typeLabel":"number\u003cfloat>"},"totalOwnershipUpperField":{"type":"number","format":"float","description":"Upper bound of the group's total ownership. Present when totalOwnershipIsRangeField is true.","minimum":0,"example":81.65,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].totalOwnershipUpperField","typeLabel":"number\u003cfloat>"},"currentHoldingField":{"type":"number","format":"float","description":"Ownership in the root company already traced to the members of this group. When currentHoldingIsRangeField is true, this is the upper bound of the range.","minimum":0,"example":14.99,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].currentHoldingField","typeLabel":"number\u003cfloat>"},"currentHoldingIsRangeField":{"type":"boolean","description":"True when a member's holding is a band, so the current holding is a range. currentHoldingLowerField and currentHoldingUpperField then give the range. Returned only for a range.","example":true,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].currentHoldingIsRangeField","typeLabel":"boolean"},"currentHoldingLowerField":{"type":"number","format":"float","description":"Lower bound of the current holding. Present when currentHoldingIsRangeField is true.","minimum":0,"maximum":100,"example":10,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].currentHoldingLowerField","typeLabel":"number\u003cfloat>"},"currentHoldingUpperField":{"type":"number","format":"float","description":"Upper bound of the current holding. Present when currentHoldingIsRangeField is true.","minimum":0,"example":14.99,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].currentHoldingUpperField","typeLabel":"number\u003cfloat>"},"isFuzzyGroupField":{"type":"boolean","description":"True if members were grouped through fuzzy name matching.\nMatching uses first name + last name similarity. Conservative matching - verify\nthrough additional due diligence before concluding same identity.\nFalse indicates exact name match or single-member group.\n","example":true,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].isFuzzyGroupField","typeLabel":"boolean"},"reasonField":{"type":"string","description":"Reason why this entry is classified as a potential beneficial owner rather than a confirmed UBO. Observed values:\n- NON_UBO_MAY_REACH_THRESHOLD_WITH_FURTHER_PURCHASE: additional profile orders could reveal ownership that exceeds the UBO threshold.\n- MULTIPLE_NON_UBOS_COMBINED_TO_UBO: the combined ownership of name-matched members exceeds the threshold even though no single holding does.\n","example":"NON_UBO_MAY_REACH_THRESHOLD_WITH_FURTHER_PURCHASE","uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].reasonField","typeLabel":"string"},"membersField":{"type":"array","description":"Individual beneficial owners that are part of this group, with their respective ownership percentages.","items":{"type":"object","properties":{"nameField":{"type":"string","description":"Name variation as it appears in the ownership data.","example":"Jonathan Gray Davies","uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].membersField.items.[INDEX].nameField","typeLabel":"string"},"ownershipField":{"type":"number","format":"float","description":"Beneficial ownership percentage for this specific name variation. When ownershipIsRangeField is true, this is the upper bound of the range.","minimum":0,"example":5.56,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].membersField.items.[INDEX].ownershipField","typeLabel":"number\u003cfloat>"},"ownershipIsRangeField":{"type":"boolean","description":"True when this name variation's holding is a band, so its ownership is a range. ownershipLowerField and ownershipUpperField then give the range. Returned only for a range.","example":true,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].membersField.items.[INDEX].ownershipIsRangeField","typeLabel":"boolean"},"ownershipLowerField":{"type":"number","format":"float","description":"Lower bound of this name variation's ownership. Present when ownershipIsRangeField is true.","minimum":0,"maximum":100,"example":10,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].membersField.items.[INDEX].ownershipLowerField","typeLabel":"number\u003cfloat>"},"ownershipUpperField":{"type":"number","format":"float","description":"Upper bound of this name variation's ownership. Present when ownershipIsRangeField is true.","minimum":0,"example":14.99,"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].membersField.items.[INDEX].ownershipUpperField","typeLabel":"number\u003cfloat>"}},"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].membersField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX].membersField","typeLabel":"object[]"}},"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField.items.[INDEX]","typeLabel":"object"},"uniqueKey":"uboAnalysisField.potentialBeneficialOwnersField","typeLabel":"object[]"}},"uniqueKey":"uboAnalysisField","typeLabel":"object"},"responseCodeField":{"type":"string","description":"Response code for the retrieval request. \"200\" indicates a successful retrieval, covering both in-progress and completed states.","example":"200","uniqueKey":"responseCodeField","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Ownership Tree":{"title":"Ownership Tree","value":{"ownershipTreeField":{"idField":"0000000000","nameField":"TEST COMPANY LIMITED","addressField":"23 The Street, Test Town, UK","nodesField":[{"levelField":1,"entityField":{"idField":"0c7f23d9-30ca-41bb-8733-31d0180bbc8a","typeField":"COMPANY","nameField":"TEST COMPANY LIMITED","nameInEnglishField":"TEST COMPANY LIMITED","countryISOField":"GB","companyCodeField":"0000000000","addressField":"23 The Street, Test Town, UK","linksField":{"enhancedProfileField":"https://download.kyckr.com/file/json/1874665464-0"},"registrationAuthorityField":"Companies House, United Kingdom"},"edgesField":[{"nodeIdField":"654b7cd3-08d5-4f4c-a33c-a05f48705fb7","typeField":"SHAREHOLDER","percentageField":75.1,"isCircularField":false,"nameField":"TEST COMPANY GROUPCO LIMITED","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":75.1}]},{"nodeIdField":"17aa746e-90b4-4d05-afc4-55058dc7255b","typeField":"SHAREHOLDER","percentageField":24.9,"isCircularField":false,"nameField":"JOE BLOGGS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":24.9}]},{"nodeIdField":"85eaf0ca-9cf3-481e-b692-e971a24ccf07","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"2480d30d-c83c-4c6b-9e44-8f18d3ad8fa6","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"e13b8465-b5b2-43b0-9144-7c9d6bc6c50e","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"3ea2b731-cf94-411c-9e08-e8f55a1d7f5e","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"b290f3e2-14c7-462c-9b07-ad0fb5fa5240","typeField":"REPRESENTATIVE","roleField":"Company Secretary","isCircularField":false}]},{"levelField":2,"entityField":{"idField":"17aa746e-90b4-4d05-afc4-55058dc7255b","typeField":"PERSON","nameField":"JOE BLOGGS","nameInEnglishField":"JOE BLOGGS"},"edgesField":[],"rollupPercentageField":24.9},{"levelField":2,"entityField":{"idField":"85eaf0ca-9cf3-481e-b692-e971a24ccf07","typeField":"PERSON","nameField":"Jim Bloggs","nameInEnglishField":"Jim Bloggs"},"edgesField":[]},{"levelField":2,"entityField":{"idField":"2480d30d-c83c-4c6b-9e44-8f18d3ad8fa6","typeField":"PERSON","nameField":"John Bloggs","nameInEnglishField":"John Bloggs"},"edgesField":[]},{"levelField":2,"entityField":{"idField":"e13b8465-b5b2-43b0-9144-7c9d6bc6c50e","typeField":"PERSON","nameField":"George Bloggs","nameInEnglishField":"George Bloggs"},"edgesField":[]},{"levelField":2,"entityField":{"idField":"3ea2b731-cf94-411c-9e08-e8f55a1d7f5e","typeField":"PERSON","nameField":"Jasper Bloggs","nameInEnglishField":"Jasper Bloggs"},"edgesField":[]},{"levelField":2,"entityField":{"idField":"b290f3e2-14c7-462c-9b07-ad0fb5fa5240","typeField":"PERSON","nameField":"John Doe","nameInEnglishField":"John Doe"},"edgesField":[]},{"levelField":2,"entityField":{"idField":"654b7cd3-08d5-4f4c-a33c-a05f48705fb7","typeField":"COMPANY","nameField":"TEST COMPANY GROUPCO LIMITED","nameInEnglishField":"TEST COMPANY GROUPCO LIMITED","countryISOField":"GB","companyCodeField":"10376414","linksField":{"enhancedProfileField":"https://download.kyckr.com/file/json/1307211989-0"},"registrationAuthorityField":"Companies House, United Kingdom"},"edgesField":[{"nodeIdField":"9070194e-b598-47b5-b3e8-cb1464d3c0ce","typeField":"SHAREHOLDER","percentageField":100,"isCircularField":false,"nameField":"TEST COMPANY HOLDINGS LIMITED","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":100}]},{"nodeIdField":"c7fead02-42f7-4157-9d0a-e960ddcf9b83","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"c47b9a7a-4734-4a2d-bdf4-01bc3cef7d42","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"e4496e08-4a14-420d-a64a-47db610a0d18","typeField":"REPRESENTATIVE","roleField":"Company Secretary","isCircularField":false}],"rollupPercentageField":75.1,"entitySelectionMetadataField":{"sourceField":"ALGORITHM"}},{"levelField":3,"entityField":{"idField":"c7fead02-42f7-4157-9d0a-e960ddcf9b83","typeField":"PERSON","nameField":"Jim Bloggs","nameInEnglishField":"Jim Bloggs"},"edgesField":[]},{"levelField":3,"entityField":{"idField":"c47b9a7a-4734-4a2d-bdf4-01bc3cef7d42","typeField":"PERSON","nameField":"George Bloggs","nameInEnglishField":"George Bloggs"},"edgesField":[]},{"levelField":3,"entityField":{"idField":"e4496e08-4a14-420d-a64a-47db610a0d18","typeField":"PERSON","nameField":"John Doe","nameInEnglishField":"John Doe"},"edgesField":[]},{"levelField":3,"entityField":{"idField":"9070194e-b598-47b5-b3e8-cb1464d3c0ce","typeField":"COMPANY","nameField":"TEST COMPANY HOLDINGS LIMITED","nameInEnglishField":"TEST COMPANY HOLDINGS LIMITED","countryISOField":"GB","companyCodeField":"00066076","linksField":{"enhancedProfileField":"https://download.kyckr.com/file/json/739758514-0"},"registrationAuthorityField":"Companies House, United Kingdom"},"edgesField":[{"nodeIdField":"9909394e-97af-44a9-a83a-95a20292d7b1","typeField":"SHAREHOLDER","percentageField":100,"isCircularField":false,"nameField":"TEST COMPANY TOPCO LTD","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":100}]},{"nodeIdField":"2292c5b3-8d6c-4f45-a323-7c09161c4903","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"a7a50010-0b7a-4c76-b9aa-83bf4100287b","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"5dbf09ee-2f17-4336-83b9-d83798b80d5a","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"97c8ee1b-e2d2-4c04-8410-a25ad391a80a","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"f8b384e3-66bf-4116-abd0-9bbfa702ebf8","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false},{"nodeIdField":"d84ddc61-f181-45c4-84fd-ae0d18f07eb3","typeField":"REPRESENTATIVE","roleField":"Company Secretary","isCircularField":false}],"rollupPercentageField":75.1,"entitySelectionMetadataField":{"sourceField":"ALGORITHM"}},{"levelField":4,"entityField":{"idField":"2292c5b3-8d6c-4f45-a323-7c09161c4903","typeField":"PERSON","nameField":"Jane Doe","nameInEnglishField":"Jane Doe"},"edgesField":[]},{"levelField":4,"entityField":{"idField":"a7a50010-0b7a-4c76-b9aa-83bf4100287b","typeField":"PERSON","nameField":"Jim Bloggs","nameInEnglishField":"Jim Bloggs"},"edgesField":[]},{"levelField":4,"entityField":{"idField":"5dbf09ee-2f17-4336-83b9-d83798b80d5a","typeField":"PERSON","nameField":"James Doe","nameInEnglishField":"James Doe"},"edgesField":[]},{"levelField":4,"entityField":{"idField":"97c8ee1b-e2d2-4c04-8410-a25ad391a80a","typeField":"PERSON","nameField":"Julia Doe","nameInEnglishField":"Julia Doe"},"edgesField":[]},{"levelField":4,"entityField":{"idField":"f8b384e3-66bf-4116-abd0-9bbfa702ebf8","typeField":"PERSON","nameField":"Jim Doe","nameInEnglishField":"Jim Doe"},"edgesField":[]},{"levelField":4,"entityField":{"idField":"d84ddc61-f181-45c4-84fd-ae0d18f07eb3","typeField":"PERSON","nameField":"John Doe","nameInEnglishField":"John Doe"},"edgesField":[]},{"levelField":4,"entityField":{"idField":"9909394e-97af-44a9-a83a-95a20292d7b1","typeField":"COMPANY","nameField":"TEST COMPANY TOPCO LTD","nameInEnglishField":"TEST COMPANY TOPCO LTD","countryISOField":"GB","companyCodeField":"04494323","reasonForNonContinuationField":{"detailsField":"Max layers reached","typeField":"INSUFFICIENT_MAX_LAYERS","candidatesField":[]}},"edgesField":[],"rollupPercentageField":75.1}],"ultimateBeneficialOwnersField":[],"statusField":"SUCCESS","uboThresholdField":25,"maxCreditCostField":15,"maxLayersField":3,"dateCreatedField":"2023-10-03T12:34:52.9816751Z","retrievalLocationField":"https://download.kyckr.com/file/294635291","totalCreditsSpentField":12,"unwrapFeeField":2,"countryISOField":"GB","companyCodeField":"0000000000"},"uboAnalysisField":{"statusField":"INCOMPLETE_REQUIRED_PROFILES","metricsField":{"uboCoverageField":0,"shareholdingCoverageField":75.1,"unpurchasedTotalField":75.1},"requiredProfilesField":[{"entityIdField":"9909394e-97af-44a9-a83a-95a20292d7b1","entityNameField":"TEST COMPANY TOPCO LTD","companyCodeField":"04494323"}],"potentialBeneficialOwnersField":[]}}},"Order In Progress":{"title":"Order In Progress","value":{"ownershipTreeField":{"idField":"110588","nodesField":[],"ultimateBeneficialOwnersField":[],"statusField":"IN_PROGRESS","uboThresholdField":25,"maxCreditCostField":100,"dateCreatedField":"2023-10-17T11:02:23.3314325Z"}}},"Company Not Found":{"title":"Company Not Found","value":{"ownershipTreeField":{"idField":"104713","nodesField":[],"ultimateBeneficialOwnersField":[],"statusField":"COMPANY_NOT_FOUND","errorStatusExtraInfoField":"There is no Profile for 000794212 in Sandbox environment.","uboThresholdField":25,"maxCreditCostField":50,"dateCreatedField":"2023-06-15T12:58:49.1648999Z","retrievalLocationField":"https://download.kyckr.com/000000000000"},"responseCodeField":"200"}},"No Shareholders Listed":{"title":"No Shareholders Listed","value":{"ownershipTreeField":{"idField":"110588","nodesField":[],"ultimateBeneficialOwnersField":[],"statusField":"NO_SHAREHOLDERS","uboThresholdField":25,"maxCreditCostField":100,"dateCreatedField":"2023-10-17T11:02:23.3314325Z"}}},"Insufficient Credits":{"title":"Insufficient Credits","value":{"ownershipTreeField":{"idField":"954502","nodesField":[],"ultimateBeneficialOwnersField":[],"statusField":"INSUFFICIENT_CREDITS","errorStatusExtraInfoField":"Not enough credits","uboThresholdField":25,"maxCreditCostField":3,"dateCreatedField":"2023-10-17T11:09:03.7182691Z"}}},"Invalid Registration Authority":{"title":"Invalid Registration Authority","value":{"ownershipTreeField":{"idField":"105126","nodesField":[],"ultimateBeneficialOwnersField":[],"statusField":"COMPANY_NOT_FOUND","errorStatusExtraInfoField":"Invalid Registration Authority","uboThresholdField":25,"maxCreditCostField":100,"dateCreatedField":"2023-06-19T12:44:38.1519183Z","retrievalLocationField":"https://download.kyckr.com/000000000000"}}},"Example 1":{"title":"Example 1","value":{"ownershipTreeField":{"idField":"string","nameField":"string","addressField":"string","nodesField":[{"levelField":1,"entityField":{"idField":"string","typeField":"COMPANY","nameField":"string","nameInEnglishField":"string","countryISOField":"string","companyCodeField":"string","addressField":"string","linksField":{"enhancedProfileField":"http://example.com"},"registrationAuthorityField":"string","reasonForNonContinuationField":{"detailsField":"string","typeField":"COMPANY_NOT_FOUND","candidatesField":[{"addressField":"string","companyIdField":"string","companyNameField":"string","countryIsoField":"string","registrationAuthorityField":"string","continuationKeyField":"57533abe-cd07-4702-ad93-4695827bec1c"}],"continuationKeyField":"57533abe-cd07-4702-ad93-4695827bec1c"}},"edgesField":[{"nodeIdField":"string","typeField":"SHAREHOLDER","percentageField":0,"isCircularField":true,"roleField":"string","nameField":"string","shareholdingsField":[{"isJointlyHeldField":true,"percentageField":0,"jointHoldingGroupIdField":"11035a62-d82b-40d9-a821-e19a6c87dfd3"}]}],"rollupPercentageField":0}],"ultimateBeneficialOwnersField":[{"idField":"string","nameField":"string","percentageField":"25.00","entityTypeField":"PERSON"}],"statusField":"SUCCESS","uboThresholdField":25,"maxCreditCostField":10,"maxLayersField":3,"dateCreatedField":"2025-01-01T00:00:00.0000000Z","retrievalLocationField":"http://example.com","totalCreditsSpentField":0,"unwrapFeeField":0,"countryISOField":"string","companyCodeField":"string","continuationKeysUsedField":["497f6eca-6276-4993-bfeb-53cbbbba6f08"],"selectedCandidatesField":[],"previousVersionsField":[]},"uboAnalysisField":{"statusField":"COMPLETE_UBO_IDENTIFIED","metricsField":{"uboCoverageField":25,"shareholdingCoverageField":100,"unpurchasedTotalField":0},"requiredProfilesField":[],"potentialBeneficialOwnersField":[]}}},"Ownership Tree with Continuation and Analysis":{"title":"Ownership Tree with Continuation and Analysis","value":{"ownershipTreeField":{"idField":"334285","nameField":"HICKS HOLDINGS (WOODLEY) LIMITED","addressField":"15 Headley Road, Woodley, Berkshire, RG5 4JB","nodesField":[{"levelField":1,"entityField":{"idField":"53b2ac85-d23a-4724-90dc-6f7d86e20ca9","typeField":"COMPANY","nameField":"HICKS HOLDINGS (WOODLEY) LIMITED","nameInEnglishField":"HICKS HOLDINGS (WOODLEY) LIMITED","countryISOField":"GB","companyCodeField":"01428331","addressField":"15 Headley Road, Woodley, Berkshire, RG5 4JB","linksField":{"enhancedProfileField":"https://download.kyckr.com/file/json/1475611711-1"},"registrationAuthorityField":"Companies House, United Kingdom"},"edgesField":[{"nodeIdField":"ace3716f-2949-414e-b897-17873820cd1d","typeField":"SHAREHOLDER","percentageField":38.46,"isCircularField":false,"nameField":"MAUREEN JOYCE HICKS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":38.46}]},{"nodeIdField":"782cebfd-453b-412a-b945-f2d01a225fa1","typeField":"SHAREHOLDER","percentageField":48.71,"isCircularField":false,"nameField":"JOHN LESLIE HICKS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":48.71}]}]},{"levelField":2,"entityField":{"idField":"ace3716f-2949-414e-b897-17873820cd1d","typeField":"COMPANY","nameField":"MAUREEN HANCOCK LTD","nameInEnglishField":"MAUREEN HANCOCK LTD","countryISOField":"GB","companyCodeField":"15406001","addressField":"Cardiff, CF14 8LH","linksField":{"enhancedProfileField":"https://download.kyckr.com/file/json/1920734934-1"},"registrationAuthorityField":"Companies House, United Kingdom"},"edgesField":[{"nodeIdField":"29ee403a-bdfc-4010-bdc2-791c6e400e90","typeField":"SHAREHOLDER","percentageField":100,"isCircularField":false,"nameField":"MAUREEN HANCOCK","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":100}]}],"rollupPercentageField":38.46,"entitySelectionMetadataField":{"sourceField":"USER_SELECTED","continuationKeyField":"b4942e6b-3065-4e2c-95ad-580d86b0aa28","dateSelectedField":"2026-02-20T04:48:50.8907584Z"}},{"levelField":3,"entityField":{"idField":"29ee403a-bdfc-4010-bdc2-791c6e400e90","typeField":"PERSON","nameField":"MAUREEN HANCOCK"},"rollupPercentageField":38.46},{"levelField":2,"entityField":{"idField":"782cebfd-453b-412a-b945-f2d01a225fa1","typeField":"COMPANY","nameField":"JOHN LESLIE LTD","nameInEnglishField":"JOHN LESLIE LTD","countryISOField":"GB","companyCodeField":"07463447","addressField":"40 Driftway Road, Hook, Berkshire, England, RG27 9SB","linksField":{"enhancedProfileField":"https://download.kyckr.com/file/json/785827984-1"},"registrationAuthorityField":"Companies House, United Kingdom"},"edgesField":[{"nodeIdField":"5ca172c5-243a-4173-8ff3-42e61c1fea8f","typeField":"REPRESENTATIVE","roleField":"Director","isCircularField":false,"nameField":"Martin John Rooke"}],"rollupPercentageField":48.71,"entitySelectionMetadataField":{"sourceField":"USER_SELECTED","continuationKeyField":"a308714b-0f90-4243-b4c2-8df964af5cfb","dateSelectedField":"2026-02-20T04:48:50.8909634Z"}}],"ultimateBeneficialOwnersField":[{"idField":"29ee403a-bdfc-4010-bdc2-791c6e400e90","nameField":"MAUREEN HANCOCK","nameInEnglishField":"MAUREEN HANCOCK","percentageField":"38.4600","entityTypeField":"PERSON"}],"statusField":"SUCCESS","uboThresholdField":25,"maxCreditCostField":1000,"maxLayersField":15,"dateCreatedField":"2026-02-20T04:48:50.7840536Z","retrievalLocationField":"https://download.kyckr.com/file/340704761","totalCreditsSpentField":6,"unwrapFeeField":2,"countryISOField":"GB","companyCodeField":"01428331","continuationKeysUsedField":["b4942e6b-3065-4e2c-95ad-580d86b0aa28","a308714b-0f90-4243-b4c2-8df964af5cfb"],"selectedCandidatesField":[{"parentNodeIdField":"53b2ac85-d23a-4724-90dc-6f7d86e20ca9","candidateField":{"addressField":"Cardiff, CF14 8LH","companyIdField":"15406001","companyNameField":"MAUREEN HANCOCK LTD","countryIsoField":"GB","registrationAuthorityField":"Companies House, United Kingdom","continuationKeyField":"b4942e6b-3065-4e2c-95ad-580d86b0aa28"},"nodeIdField":"ace3716f-2949-414e-b897-17873820cd1d","dateSelectedField":"2026-02-20T04:48:50.8907584Z","orderIdField":"334285"},{"parentNodeIdField":"53b2ac85-d23a-4724-90dc-6f7d86e20ca9","candidateField":{"addressField":"40 Driftway Road, Hook, Berkshire, England, RG27 9SB","companyIdField":"07463447","companyNameField":"JOHN LESLIE LTD","countryIsoField":"GB","registrationAuthorityField":"Companies House, United Kingdom","continuationKeyField":"a308714b-0f90-4243-b4c2-8df964af5cfb"},"nodeIdField":"782cebfd-453b-412a-b945-f2d01a225fa1","dateSelectedField":"2026-02-20T04:48:50.8909634Z","orderIdField":"334285"}],"previousVersionsField":["334282"]},"uboAnalysisField":{"statusField":"COMPLETE_UBO_IDENTIFIED","metricsField":{"uboCoverageField":38.46,"shareholdingCoverageField":100,"unpurchasedTotalField":6.54},"requiredProfilesField":[],"potentialBeneficialOwnersField":[]},"responseCodeField":"200"}},"Incomplete Analysis with Potential UBOs":{"title":"Incomplete Analysis with Potential UBOs","value":{"ownershipTreeField":{"idField":"334282","nameField":"HICKS HOLDINGS (WOODLEY) LIMITED","addressField":"15 Headley Road, Woodley, Berkshire, RG5 4JB","nodesField":[{"levelField":1,"entityField":{"idField":"53b2ac85-d23a-4724-90dc-6f7d86e20ca9","typeField":"COMPANY","nameField":"HICKS HOLDINGS (WOODLEY) LIMITED","nameInEnglishField":"HICKS HOLDINGS (WOODLEY) LIMITED","countryISOField":"GB","companyCodeField":"01428331","addressField":"15 Headley Road, Woodley, Berkshire, RG5 4JB","linksField":{"enhancedProfileField":"https://download.kyckr.com/file/json/1475611711-1"},"registrationAuthorityField":"Companies House, United Kingdom"},"edgesField":[{"nodeIdField":"ace3716f-2949-414e-b897-17873820cd1d","typeField":"SHAREHOLDER","percentageField":38.46,"isCircularField":false,"nameField":"MAUREEN JOYCE HICKS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":38.46}]},{"nodeIdField":"185740bd-3c6c-40bb-aa8d-d58fc91e724d","typeField":"SHAREHOLDER","percentageField":2.33,"isCircularField":false,"nameField":"DAVID JOHN HICKS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":2.33}]}]},{"levelField":2,"entityField":{"idField":"185740bd-3c6c-40bb-aa8d-d58fc91e724d","typeField":"PERSON","nameField":"DAVID JOHN HICKS"},"rollupPercentageField":2.33},{"levelField":2,"entityField":{"idField":"ace3716f-2949-414e-b897-17873820cd1d","typeField":"COMPANY","nameField":"MAUREEN JOYCE HICKS","nameInEnglishField":"MAUREEN JOYCE HICKS","reasonForNonContinuationField":{"detailsField":"Company name matches were lower than the matching threshold","typeField":"COMPANY_NOT_FOUND","candidatesField":[{"addressField":"Cardiff, CF14 8LH","companyIdField":"15406001","companyNameField":"MAUREEN HANCOCK LTD","countryIsoField":"GB","registrationAuthorityField":"Companies House, United Kingdom","continuationKeyField":"b4942e6b-3065-4e2c-95ad-580d86b0aa28"}]}},"edgesField":[],"rollupPercentageField":38.46,"entitySelectionMetadataField":{"sourceField":"ALGORITHM"}}],"ultimateBeneficialOwnersField":[],"statusField":"SUCCESS","uboThresholdField":25,"maxCreditCostField":1000,"maxLayersField":5,"dateCreatedField":"2026-02-20T04:23:46.6052032Z","retrievalLocationField":"https://download.kyckr.com/file/2043065186","totalCreditsSpentField":3,"unwrapFeeField":2,"countryISOField":"GB","companyCodeField":"01428331","continuationKeysUsedField":[],"selectedCandidatesField":[],"previousVersionsField":[]},"uboAnalysisField":{"statusField":"INCOMPLETE_REQUIRED_PROFILES","blockingReasonField":"COMPANY_NOT_FOUND","metricsField":{"uboCoverageField":0,"shareholdingCoverageField":100,"unpurchasedTotalField":95.34},"requiredProfilesField":[{"entityIdField":"ace3716f-2949-414e-b897-17873820cd1d","entityNameField":"MAUREEN JOYCE HICKS"}],"potentialBeneficialOwnersField":[{"canonicalNameField":"DAVID HICKS","currentHoldingField":2.33,"totalOwnershipField":97.67,"totalOwnershipIsRangeField":true,"totalOwnershipLowerField":2.33,"totalOwnershipUpperField":97.67,"isFuzzyGroupField":false,"reasonField":"NON_UBO_MAY_REACH_THRESHOLD_WITH_FURTHER_PURCHASE","membersField":[{"nameField":"DAVID JOHN HICKS","ownershipField":2.33}]}]},"responseCodeField":"200"}},"Ownership Tree with Ownership Ranges":{"title":"Ownership Tree with Ownership Ranges","value":{"ownershipTreeField":{"idField":"1234567","nameField":"Example Root ApS","addressField":"1 Example Street, 1234 Example City, Denmark","nodesField":[{"levelField":1,"entityField":{"idField":"3f6c1b2e-8a4d-4f7e-9c21-5d8e7a6b4c10","typeField":"COMPANY","nameField":"Example Root ApS","nameInEnglishField":"Example Root ApS","countryISOField":"DK","companyCodeField":"12345678","addressField":"1 Example Street, 1234 Example City, Denmark","registrationAuthorityField":"Danish Business Authority"},"edgesField":[{"nodeIdField":"a1d4e7c2-5b3f-4e8a-9d06-2c7b1f9e3a45","typeField":"SHAREHOLDER","percentageField":14.99,"percentageIsRangeField":true,"percentageLowerField":10,"percentageUpperField":14.99,"isCircularField":false,"nameField":"Example Holding ApS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":14.99,"percentageIsRangeField":true,"percentageLowerField":10,"percentageUpperField":14.99}]},{"nodeIdField":"c8b2f5a9-1e6d-4b3c-8f47-9a0e2d5c7b18","typeField":"SHAREHOLDER","percentageField":66.66,"percentageIsRangeField":true,"percentageLowerField":50,"percentageUpperField":66.66,"isCircularField":false,"nameField":"Example Capital K/S","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":66.66,"percentageIsRangeField":true,"percentageLowerField":50,"percentageUpperField":66.66}]},{"nodeIdField":"4b7e1d93-c2a8-4f65-9e0b-3a6d8c2f5e71","typeField":"SHAREHOLDER","percentageField":9.99,"percentageIsRangeField":true,"percentageLowerField":5,"percentageUpperField":9.99,"isCircularField":false,"nameField":"Example Investment ApS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":9.99,"percentageIsRangeField":true,"percentageLowerField":5,"percentageUpperField":9.99}]},{"nodeIdField":"d2a6f8b4-7e3c-4a19-b5d0-8c1e4f7a2b36","typeField":"SHAREHOLDER","percentageField":49.99,"percentageIsRangeField":true,"percentageLowerField":33.33,"percentageUpperField":49.99,"isCircularField":false,"nameField":"Example Investment II ApS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":49.99,"percentageIsRangeField":true,"percentageLowerField":33.33,"percentageUpperField":49.99}]}]},{"levelField":2,"entityField":{"idField":"a1d4e7c2-5b3f-4e8a-9d06-2c7b1f9e3a45","typeField":"COMPANY","nameField":"Example Holding ApS","nameInEnglishField":"Example Holding ApS","countryISOField":"DK","companyCodeField":"23456789","addressField":"2 Example Street, 1234 Example City, Denmark","registrationAuthorityField":"Danish Business Authority"},"edgesField":[{"nodeIdField":"e5f9a3c7-2d8b-4a1e-b6c4-7f3d9e1a8b52","typeField":"SHAREHOLDER","percentageField":100,"isCircularField":false,"nameField":"John Example","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":100}]}],"rollupPercentageField":14.99,"rollupPercentageIsRangeField":true,"rollupPercentageLowerField":10,"rollupPercentageUpperField":14.99,"entitySelectionMetadataField":{"sourceField":"ALGORITHM","dateSelectedField":"2026-10-20T03:33:27.9598563Z","matchVerificationField":"NAME_AND_JURISDICTION"}},{"levelField":3,"entityField":{"idField":"e5f9a3c7-2d8b-4a1e-b6c4-7f3d9e1a8b52","typeField":"PERSON","nameField":"John Example","nameInEnglishField":"John Example"},"edgesField":[],"rollupPercentageField":14.99,"rollupPercentageIsRangeField":true,"rollupPercentageLowerField":10,"rollupPercentageUpperField":14.99},{"levelField":2,"entityField":{"idField":"c8b2f5a9-1e6d-4b3c-8f47-9a0e2d5c7b18","typeField":"COMPANY","nameField":"Example Capital K/S","nameInEnglishField":"Example Capital K/S","countryISOField":"DK","addressField":"3 Example Street, 1234 Example City, Denmark","reasonForNonContinuationField":{"detailsField":"Max credit cost reached","typeField":"INSUFFICIENT_MAX_CREDIT_COST","continuationKeyField":"9b4e2a7c-6d1f-4c8e-a3b5-0e7f2d9c1a64"}},"edgesField":[],"rollupPercentageField":66.66,"rollupPercentageIsRangeField":true,"rollupPercentageLowerField":50,"rollupPercentageUpperField":66.66},{"levelField":2,"entityField":{"idField":"d2a6f8b4-7e3c-4a19-b5d0-8c1e4f7a2b36","typeField":"COMPANY","nameField":"Example Investment II ApS","nameInEnglishField":"Example Investment II ApS","countryISOField":"DK","addressField":"5 Example Street, 1234 Example City, Denmark","registrationAuthorityField":"Danish Business Authority"},"edgesField":[{"nodeIdField":"4b7e1d93-c2a8-4f65-9e0b-3a6d8c2f5e71","typeField":"SHAREHOLDER","percentageField":100,"isCircularField":false,"nameField":"Example Investment ApS","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":100}]}],"rollupPercentageField":49.99,"rollupPercentageIsRangeField":true,"rollupPercentageLowerField":33.33,"rollupPercentageUpperField":49.99},{"levelField":2,"entityField":{"idField":"4b7e1d93-c2a8-4f65-9e0b-3a6d8c2f5e71","typeField":"COMPANY","nameField":"Example Investment ApS","nameInEnglishField":"Example Investment ApS","countryISOField":"DK","addressField":"4 Example Street, 1234 Example City, Denmark","registrationAuthorityField":"Danish Business Authority"},"edgesField":[{"nodeIdField":"f1c3e5a7-9b2d-4e6f-8a0c-5d7b9e1f3a28","typeField":"SHAREHOLDER","percentageField":100,"isCircularField":false,"nameField":"Jane Example","shareholdingsField":[{"isJointlyHeldField":false,"percentageField":100}]}],"rollupPercentageField":59.98,"rollupPercentageIsRangeField":true,"rollupPercentageLowerField":38.33,"rollupPercentageUpperField":59.98},{"levelField":3,"entityField":{"idField":"f1c3e5a7-9b2d-4e6f-8a0c-5d7b9e1f3a28","typeField":"PERSON","nameField":"Jane Example","nameInEnglishField":"Jane Example"},"edgesField":[],"rollupPercentageField":59.98,"rollupPercentageIsRangeField":true,"rollupPercentageLowerField":38.33,"rollupPercentageUpperField":59.98}],"ultimateBeneficialOwnersField":[{"idField":"f1c3e5a7-9b2d-4e6f-8a0c-5d7b9e1f3a28","nameField":"Jane Example","nameInEnglishField":"Jane Example","percentageField":"59.98","percentageIsRangeField":true,"percentageLowerField":"38.33","percentageUpperField":"59.98","entityTypeField":"PERSON","addressField":"6 Example Street, 1234 Example City, Denmark"}],"statusField":"SUCCESS","uboThresholdField":25,"maxCreditCostField":10,"dateCreatedField":"2026-10-20T03:33:07.2412497Z","retrievalLocationField":"https://download.kyckr.com/file/1231231234","totalCreditsSpentField":10,"unwrapFeeField":6,"countryISOField":"DK","companyCodeField":"12345678"},"uboAnalysisField":{"statusField":"INCOMPLETE_REQUIRED_PROFILES","blockingReasonField":"Max credit cost reached","metricsField":{"uboCoverageField":38.33,"shareholdingCoverageField":98.33,"unpurchasedTotalField":66.66,"unpurchasedTotalIsRangeField":true,"unpurchasedTotalLowerField":50,"unpurchasedTotalUpperField":66.66},"requiredProfilesField":[{"entityIdField":"c8b2f5a9-1e6d-4b3c-8f47-9a0e2d5c7b18","entityNameField":"Example Capital K/S"}],"potentialBeneficialOwnersField":[{"canonicalNameField":"JOHN EXAMPLE","currentHoldingField":14.99,"currentHoldingIsRangeField":true,"currentHoldingLowerField":10,"currentHoldingUpperField":14.99,"totalOwnershipField":81.65,"totalOwnershipIsRangeField":true,"totalOwnershipLowerField":10,"totalOwnershipUpperField":81.65,"isFuzzyGroupField":false,"reasonField":"NON_UBO_MAY_REACH_THRESHOLD_WITH_FURTHER_PURCHASE","membersField":[{"nameField":"John Example","ownershipField":14.99,"ownershipIsRangeField":true,"ownershipLowerField":10,"ownershipUpperField":14.99}]}]},"responseCodeField":"200"}}},"exampleType":"examples"}},"exampleType":"examples"},"3d69a532-1930-4e9d-ac8a-09a8680cfdf7":{"description":"Unauthorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"12e73233-cfe7-4001-ba71-b75a3febae82":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"responseCodeField":{"type":"string","uniqueKey":"responseCodeField","typeLabel":"string"},"responseDetailsField":{"type":"string","uniqueKey":"responseDetailsField","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Forbidden":{"title":"Forbidden","value":{"responseCodeField":"403","responseDetailsField":"You have insufficient permissions to access UBO Verify"}}},"exampleType":"examples"}},"exampleType":"examples"},"8c818d79-32a1-4fef-bddf-0d48bad867cb":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","uniqueKey":"statusCode","typeLabel":"integer"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"example-1":{"title":"example-1","value":{"statusCode":404,"message":"Resource not found"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"020739ea-5148-43cc-a9c0-4403d1e836eb":{"apiKey":{"type":"apiKey","name":"Authorization","in":"header","scopes":[],"schemeName":"apiKey"}}},"servers":{"ab77aa9a-8800-4209-bec3-91bd345df839":{"url":"https://rest.kyckr.com","description":"Production"},"2d71126a-49a7-4c75-865e-f233de1de4bf":{"url":"https://rest.kyckr.com/test","description":"Test"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"Authorization","in":"header","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi/company_v1.yaml"},"subdomain":"kyckr-0823abd6","siteName":"Kyckr Developer Portal","title":"Retrieve Ownership Tree - Kyckr Developer Portal","navMaps":{"firstHrefInVersion":{"Company V2":{"href":"/Introduction","matchLevel":4},"Company V1":{"href":"/api-reference/ubo-verify/retrieve-ownership-tree","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T12:22:50.616Z","originalFileLocation":"api-reference/ubo-verify/retrieve-ownership-tree.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Check and return the results for an asynchronous request for an ownership tree.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kyckr Developer Portal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve Ownership Tree - Kyckr Developer Portal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Check and return the results for an asynchronous request for an ownership tree.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kyckr Developer Portal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kyckr-0823abd6.mintlify.site/_mintlify/api/og/v2?division=UBO+Verify\u0026amp;title=Retrieve+Ownership+Tree\u0026amp;description=Check+and+return+the+results+for+an+asynchronous+request+for+an+ownership+tree.\u0026amp;theme=49b3d6ccc6497baec79937a6\u0026amp;signature=7631d252646ecf9f1a83a2762fbebb48891879d2c74ca769a84b738a2f101c2a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Retrieve Ownership Tree - Kyckr Developer Portal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Check and return the results for an asynchronous request for an ownership tree.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kyckr-0823abd6.mintlify.site/_mintlify/api/og/v2?division=UBO+Verify\u0026amp;title=Retrieve+Ownership+Tree\u0026amp;description=Check+and+return+the+results+for+an+asynchronous+request+for+an+ownership+tree.\u0026amp;theme=49b3d6ccc6497baec79937a6\u0026amp;signature=7631d252646ecf9f1a83a2762fbebb48891879d2c74ca769a84b738a2f101c2a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/kyckr-0823abd6/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kyckr Developer Portal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A955D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ubo-verify/retrieve-ownership-tree.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.kyckr.com/#organization\",\"name\":\"Kyckr Developer Portal\",\"url\":\"https://developer.kyckr.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kyckr-0823abd6/9HYzjBYpwF1KfywI/logo/kyckr-light.svg?fit=max\u0026auto=format\u0026n=9HYzjBYpwF1KfywI\u0026q=85\u0026s=20b2e45cb5a675284a993a6e1a528191\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.kyckr.com#website\",\"name\":\"Kyckr Developer Portal\",\"url\":\"https://developer.kyckr.com\",\"publisher\":{\"@id\":\"https://developer.kyckr.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree#webpage\",\"url\":\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree\",\"name\":\"Retrieve Ownership Tree\",\"description\":\"Check and return the results for an asynchronous request for an ownership tree.\",\"dateModified\":\"2026-11-09T12:22:50.616Z\",\"isPartOf\":{\"@id\":\"https://developer.kyckr.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Company V1 API\",\"item\":\"https://developer.kyckr.com/api-reference/company-search/search-by-name\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"UBO Verify\",\"item\":\"https://developer.kyckr.com/api-reference/ubo-verify/request-ownership-tree\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve Ownership Tree\",\"item\":\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree#apireference\",\"headline\":\"Retrieve Ownership Tree\",\"name\":\"Retrieve Ownership Tree\",\"description\":\"Check and return the results for an asynchronous request for an ownership tree.\",\"url\":\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree\",\"mainEntityOfPage\":{\"@id\":\"https://developer.kyckr.com/api-reference/ubo-verify/retrieve-ownership-tree#webpage\"},\"dateModified\":\"2026-11-09T12:22:50.616Z\",\"publisher\":{\"@id\":\"https://developer.kyckr.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.kyckr.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kyckr Developer Portal\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Kyckr Developer Portal\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/ubo-verify/retrieve-ownership-tree.md","siteName":"Kyckr Developer Portal","nav":{"global":null,"versions":[{"version":"Company V2","default":true,"pages":[{"title":"Company V2","href":"/Introduction"}]},{"version":"Company V1","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/Introduction"}]},{"tab":"API Reference","groups":[{"group":"About","pages":[{"title":"Overview","href":"/company-v1/api-reference/overview"},{"title":"Changelog","href":"/company-v1/api-reference/changelog"}]},{"group":"Company V1 API","pages":[{"group":"Company Search","pages":[{"title":"Search by Name","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/company/search/{countryISO}/{companyName}","href":"/api-reference/company-search/search-by-name"},{"title":"Search by Registration Number","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/company/number-search/{countryISO}/{companyNumber}","href":"/api-reference/company-search/search-by-registration-number"},{"title":"Cache Search","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/company/cache-search/{companyName}","href":"/api-reference/company-search/cache-search"}]},{"group":"Company Profile","pages":[{"title":"Enhanced Profile","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/company/profile/{countryISO}/{companyCode}","href":"/api-reference/company-profile/enhanced-profile"}]},{"group":"Registry Documents","pages":[{"title":"Filing Search","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/filing/search/{countryISO}/{companyCode}","href":"/api-reference/registry-documents/filing-search"},{"title":"Order Status","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/filing/order-status/{orderedWithin}","href":"/api-reference/registry-documents/order-status"},{"title":"Product Order","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml post /core/filing/order","href":"/api-reference/registry-documents/product-order"}]},{"group":"Account","pages":[{"title":"Account Info","deprecated":true,"version":null,"openapi":"/openapi/company_v1.yaml get /core/account/details","href":"/api-reference/account/account-info"}]},{"group":"Price","pages":[{"title":"Document Prices by Country","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/price/document/{countryISO}","href":"/api-reference/price/document-prices-by-country"},{"title":"Document Samples by Country","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/price/samples/{countryISO}","href":"/api-reference/price/document-samples-by-country"},{"title":"Price of a Specific Product","deprecated":true,"version":null,"openapi":"/openapi/company_v1.yaml get /core/price/product/{countryISO}/{productName}","href":"/api-reference/price/price-of-a-specific-product"},{"title":"List All Products and Prices for a Country","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/price/productlist/{countryISO}","href":"/api-reference/price/list-all-products-and-prices-for-a-country"}]},{"group":"UBO Verify","pages":[{"title":"Request Ownership Tree","description":"Make an asynchronous request for an ownership tree.","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/uboverify/create/{countryISO}/{companyCode}","href":"/api-reference/ubo-verify/request-ownership-tree"},{"title":"Retrieve Ownership Tree","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /core/uboverify/list/{orderId}","href":"/api-reference/ubo-verify/retrieve-ownership-tree"}]},{"group":"Lite","pages":[{"title":"Search by Name","description":"Searching for an entity by name in a chosen registry. You will need the company name and ISO country code of the registry. From this you will receive a list of companies from the chosen registry. You will also receive the code field which can be used as a parameter for other API calls.","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /lite/search/{countryISO}/{companyName}","href":"/api-reference/lite/search-by-name"},{"title":"Search by Registration Number","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /lite/number-search/{countryISO}/{companyNumber}","href":"/api-reference/lite/search-by-registration-number"},{"title":"Cache Search","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /lite/cache-search/{companyName}","href":"/api-reference/lite/cache-search"},{"title":"Lite Profile","deprecated":null,"version":null,"openapi":"/openapi/company_v1.yaml get /lite/profile/{countryISO}/{companyCode}","href":"/api-reference/lite/lite-profile"}]}]}]},{"tab":"Developer News","pages":[{"title":"Developer News","href":"/company-v1/developer-news"}]},{"tab":"Country Guides","pages":[{"title":"Country Guides","href":"/country-guides/austria"}]}]}]},"basePath":"","title":"Retrieve Ownership Tree - Kyckr Developer Portal","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}