> ## Documentation Index > Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Ownership Tree > Check and return the results for an asynchronous request for an ownership tree. ## OpenAPI ````yaml /openapi/company_v1.yaml get /core/uboverify/list/{orderId} openapi: 3.0.1 info: title: Kyckr Companies V1 API description: | Kyckr Companies V1 API version: '1.0' contact: name: Kyckr APIs email: support@kyckr.com servers: - url: https://rest.kyckr.com description: Production - url: https://rest.kyckr.com/test description: Test security: - apiKey: [] tags: - name: Account - name: Company Profile - name: Company Search - name: Price - name: Registry Documents - name: UBO Verify - name: Lite paths: /core/uboverify/list/{orderId}: parameters: - schema: type: string name: orderId in: path required: true description: ID retrieved from create UBO order response get: tags: - UBO Verify summary: Retrieve Ownership Tree description: >- Check and return the results for an asynchronous request for an ownership tree. operationId: UboVerify_Get responses: '200': $ref: '#/components/responses/OwnershipTree' '401': description: Unauthorized '403': description: Forbidden content: application/json: schema: type: object properties: responseCodeField: type: string responseDetailsField: type: string examples: Forbidden: value: responseCodeField: '403' responseDetailsField: You have insufficient permissions to access UBO Verify '404': description: Not Found content: application/json: schema: type: object properties: statusCode: type: integer message: type: string examples: example-1: value: statusCode: 404 message: Resource not found components: responses: OwnershipTree: 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' nameField: type: string description: Name of the root company of this UBO request. example: EXAMPLE COMPANY PTE. LTD. addressField: type: string description: Registered address of the root company. example: 123 Business Street, Financial District, 123456 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 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 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 nameField: type: string description: >- Legal name of the entity in its original language/script. example: EXAMPLE SUBSIDIARY CO. LTD. nameInEnglishField: type: string description: English transliteration of the entity name. countryISOField: type: string description: >- Two-letter ISO country code where the entity is registered or domiciled. example: SG companyCodeField: type: string description: >- Official registration number or code for the entity in its jurisdiction. example: 123456789A addressField: type: string description: Registered address of the entity. 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. example: >- https://download.kyckr.com/file/json/1231231234-0 registrationAuthorityField: type: string description: >- Name of the registration authority where the entity is registered. example: Companies House, United Kingdom registrationAuthorityCodeField: type: string description: Code identifier for the registration authority. reasonForNonContinuationField: type: object description: > Information explaining why the ownership analysis did not proceed for this entity. Reasons fall into three categories: **Requires user confirmation (candidatesField populated — review and select via continuation key):** - `LOW_CONFIDENCE_MATCH`: A single matching company was found, but confidence is insufficient to continue automatically. - `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. **Hard failures (cannot proceed):** - `REGISTRY_NOT_AVAILABLE`: Registry data unavailable - `NO_SHAREHOLDERS`: No shareholder data exists - `UNSUPPORTED_JURISDICTION`: Jurisdiction not supported - `INVALID_REGAUTH`: Invalid registration authority - `POSSIBLE_PLC`: Public company (shareholders not tracked) - `SERVER_ERROR`: System error during resolution - `DESERIALIZATION_ERROR_ENHANCED_PROFILE`: Data parsing error **Resource limits:** - `INSUFFICIENT_MAX_CREDIT_COST`: Would exceed credit budget - `INSUFFICIENT_MAX_LAYERS`: Maximum depth reached - `INSUFFICIENT_CREDITS`: Account credits exhausted - `SHAREHOLDING_TOO_LOW`: Ownership below threshold properties: detailsField: type: string description: > Human-readable explanation of why continuation stopped. Provides context for audit and support workflows. Examples: example: >- Multiple matches with the same name in the same jurisdiction typeField: type: string description: > Type of continuation barrier encountered. See object description for categorization of each type. 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 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. companyIdField: type: string description: Registration ID of the candidate entity. companyNameField: type: string description: Name of the candidate entity. countryIsoField: type: string description: Country code of the candidate entity. registrationAuthorityField: type: string description: >- Registration authority of the candidate entity. continuationKeyField: type: string format: uuid description: >- Continuation key to use for selecting this candidate in a subsequent request. example: ba26a0bb-f632-4421-8092-58ed3a76d3be 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 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 typeField: type: string description: Type of relationship to the target entity. enum: - SHAREHOLDER - REPRESENTATIVE percentageField: type: number description: >- Percentage ownership or control that this entity has over the target entity. Only applicable for SHAREHOLDER relationships. minimum: 0 maximum: 100 isCircularField: type: boolean description: >- Indicates whether this relationship creates a circular ownership structure. roleField: type: string description: >- Specific role or position held by this entity. Only applicable for REPRESENTATIVE relationships. nameField: type: string description: > Shareholder name as recorded by the parent company. Compare with the resolved entity's nameField (node.entity.nameField) to see name variations and normalization effects. Particularly useful in multi-parent scenarios where the same entity may appear under different names. addressField: type: string description: > Shareholder address as recorded by the parent company. May differ from the resolved entity's addressField when the parent has older or different records. Compare with node.entity.addressField for the canonical address. 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. 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 percentageField: type: number description: >- Precise percentage of ownership for this specific shareholding. minimum: 0 maximum: 100 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. minimum: 0 maximum: 100 entitySelectionMetadataField: 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. properties: sourceField: type: string enum: - ALGORITHM - USER_SELECTED description: > How this entity was selected: - `ALGORITHM`: Entity automatically resolved by the system's matching algorithm - `USER_SELECTED`: Entity manually selected via continuation key 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 the continuation selection was made. Only present when sourceField is USER_SELECTED. example: '2026-01-14T07:51:31.0470409Z' 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. 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 nameField: type: string description: Legal name of the Ultimate Beneficial Owner. nameInEnglishField: type: string description: English transliteration of the UBO's name. percentageField: type: string description: >- Total percentage of beneficial ownership this person has in the root company. entityTypeField: type: string description: Type of the beneficial owner entity. enum: - PERSON - COMPANY addressField: type: string description: Known address of the Ultimate Beneficial Owner. 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 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 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). minimum: 1 maximum: 100 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 maxLayersField: type: integer description: >- Maximum number of layers (levels) in the ownership hierarchy that will be analyzed. Deeper layers require more credits. minimum: 3 dateCreatedField: type: string format: date-time description: ISO 8601 timestamp when the UBO request was processed. regAuthField: type: string description: >- Name of the registration authority for the root company node. example: Companies House, United Kingdom retrievalLocationField: type: string format: uri description: >- URL link to download a PDF report of the complete UBO analysis results. example: https://download.kyckr.com/file/1231231234 totalCreditsSpentField: type: integer description: >- Total number of credits consumed during this UBO request. This may be less than or equal to maxCreditCostField. minimum: 0 unwrapFeeField: type: integer description: >- Fee charged for unwrapping the ownership structure, separate from the credit cost for data retrieval. countryISOField: type: string description: >- Two-letter ISO country code of the root company's jurisdiction. companyCodeField: type: string description: Company registration code of the root entity. 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 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 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 companyIdField: type: string description: >- Kyckr's internal company identifier for the selected candidate. example: '01329311' companyNameField: type: string description: Name of the selected candidate company. example: WOLTERS KLUWER HOLDINGS (UK) LIMITED countryIsoField: type: string description: ISO country code for the selected candidate. example: GB registrationAuthorityField: type: string description: >- Registration authority for the selected candidate (optional). example: Companies House continuationKeyField: type: string format: uuid description: >- The continuation key that was used to select this candidate. example: 15ce9621-87f9-49b5-bac2-6497b2c38cd9 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 dateSelectedField: type: string format: date-time description: Timestamp when this candidate was selected. example: '2026-01-14T07:49:43.2377905Z' orderIdField: type: string description: >- The order ID when this selection was made, linking to the specific UBO request version. example: '332003' 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 example: - '332003' - '331999' 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. **Complete statuses:** - `COMPLETE_UBO_IDENTIFIED`: Discovery is complete - found one or more UBOs above threshold - `COMPLETE_BELOW_THRESHOLD`: Discovery is complete - all shareholders below threshold **Incomplete statuses** (missing data prevents completion): - `INCOMPLETE_REQUIRED_PROFILES`: Additional company profiles needed - see requiredProfilesField for recommendations - `INCOMPLETE_NO_SHAREHOLDERS`: No shareholder data available for root company - `INCOMPLETE_BLOCKING_RFNC`: Required profiles purchased but have blocking errors - `INCOMPLETE_CIRCULAR_OWNERSHIP`: Circular ownership structure detected **Indeterminate statuses** (data quality issues prevent analysis): - `INDETERMINATE_CORRUPT_DATA`: Shareholder data corrupt (total ownership = 0%) - `INDETERMINATE_INSUFFICIENT_DATA`: Shareholding covering insufficient to comprehensively determine UBOs (i.e. total percent is less than 100% - threshold) **Special cases:** - `PLC_NO_SHAREHOLDERS_EXPECTED`: Public company with expected lack of shareholder data - `UNKNOWN`: Fallback value (scenario not covered by this enum) example: INCOMPLETE_REQUIRED_PROFILES blockingReasonField: type: string description: > When status indicates an incomplete analysis, provides a summary of the primary blocking reason with jurisdiction context. Format: "REASON_CODE (JURISDICTION)" or just "REASON_CODE" example: NO_SHAREHOLDERS (FR) 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). Higher values indicate more complete beneficial ownership identification. Use for risk scoring thresholds (e.g., require ≥80% for approval). minimum: 0 maximum: 100 example: 46.14 shareholdingCoverageField: type: number format: float description: > Percentage of root company ownership successfully analyzed through the tree (0-100). Indicates how much of the ownership structure was explored. Use for data completeness assessment. 100% with low uboCoverage means more profiles need to be purchased. minimum: 0 maximum: 100 example: 100 unpurchasedTotalField: type: number format: float description: > Percentage of ownership held in entities without enhanced profiles (0-100). Represents the ownership gap that could be filled by purchasing additional profiles. Use for gap analysis and continuation strategy planning. High values indicate clear opportunities to improve coverage. minimum: 0 maximum: 100 example: 24.06 enhancedProfilesPurchasedField: type: integer description: >- Number of enhanced company profiles retrieved during this analysis. minimum: 0 example: 5 requiredProfilesField: type: array description: > Prioritized list of companies that should be purchased to improve UBO coverage. Ranked by potential impact - purchasing profiles at the top of the list will likely increase uboCoverageField the most. items: type: object properties: entityIdField: type: string format: uuid description: UUID referencing the entity in the nodesField array. example: 5ac26d8e-0ade-4c28-9a3d-f490a07adfad entityNameField: type: string description: Name of the company requiring enhanced profile data. example: INDEX VENTURES IX (JERSEY) L.P. companyCodeField: type: string description: Registration number of the entity. example: REG123 potentialBeneficialOwnersField: type: array description: >- Potentially beneficial owners - potential to exceed threshold with additional profile purchases, 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 totalOwnershipField: type: number format: float description: >- Combined beneficial ownership percentage of all members in this group. May exceed UBO threshold even if individual holdings do not. minimum: 0 maximum: 100 example: 29.62 isFuzzyGroupField: type: boolean description: > True if members were grouped through fuzzy name matching. Matching uses first name + last name similarity. Conservative matching - verify through additional due diligence before concluding same identity. False indicates exact name match or single-member group. example: true reasonField: type: string description: > Reason why this entry is classified as a potential beneficial owner rather than a confirmed UBO. Observed values: - NON_UBO_MAY_REACH_THRESHOLD_WITH_FURTHER_PURCHASE: additional profile purchases could reveal ownership that exceeds the UBO threshold. - MULTIPLE_NON_UBOS_COMBINED_TO_UBO: the combined ownership of name-matched members exceeds the threshold even though no single holding does. example: NON_UBO_MAY_REACH_THRESHOLD_WITH_FURTHER_PURCHASE 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 ownershipField: type: number format: float description: >- Beneficial ownership percentage for this specific name variation. minimum: 0 maximum: 100 example: 5.56 responseCodeField: type: string description: >- Response code for the retrieval request. "200" indicates a successful retrieval, covering both in-progress and completed states. example: '200' examples: 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 entitySelectionMetadataField: sourceField: ALGORITHM - 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: value: ownershipTreeField: idField: '110588' nodesField: [] ultimateBeneficialOwnersField: [] statusField: IN_PROGRESS uboThresholdField: 25 maxCreditCostField: 100 dateCreatedField: '2023-10-17T11:02:23.3314325Z' 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: value: ownershipTreeField: idField: '110588' nodesField: [] ultimateBeneficialOwnersField: [] statusField: NO_SHAREHOLDERS uboThresholdField: 25 maxCreditCostField: 100 dateCreatedField: '2023-10-17T11:02:23.3314325Z' 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: 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: 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 entitySelectionMetadataField: sourceField: ALGORITHM 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: 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 entitySelectionMetadataField: sourceField: ALGORITHM - 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: 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 entitySelectionMetadataField: sourceField: ALGORITHM - 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 totalOwnershipField: 97.67 isFuzzyGroupField: false reasonField: NON_UBO_MAY_REACH_THRESHOLD_WITH_FURTHER_PURCHASE membersField: - nameField: DAVID JOHN HICKS ownershipField: 2.33 responseCodeField: '200' securitySchemes: apiKey: type: apiKey name: Authorization in: header ````