--- title: "Enhanced Profile" method: GET path: "/companies/{kyckrId}/enhanced" tags: ["Companies"] --- # Enhanced Profile `GET /companies/{kyckrId}/enhanced` Convenience pattern: retrieve an enhanced company profile with a synchronous-feel interface. The server holds the connection for up to approximately 40 seconds. If the profile is ready within that time, it is returned with HTTP 200. If not, HTTP 202 is returned with an orderId and Location header — poll GET /orders/{orderId} to retrieve the profile when complete. For production and high-volume integrations, POST is preferred: it returns an orderId immediately with no server-side connection hold, avoiding infrastructure cost at scale. The profile includes (where filed in structured form at the registry): - Registration Information (Lite Profile + expanded details where available) - Share capital structure - Company Officials (incl. Directors) – including function, date of birth and address. - Shareholders (Beneficial owners) – including share count, share percentage and ID information. - Ultimate Beneficial Owners – where filed in structured form. ## Query parameters - `showDirectorships` boolean - `customerReference` string - `extend` string ## Response `200` OK - object - `orderId` number — The related orderId. - `correlationId` string — The related correlationId to this request, for support purposes. - `customerReference` string — A customer provided reference, which appears in the order list. - `timeStamp` string, date-time — The UTC time at which the request occurred. - `details` string — The response status details for the current request. - `cost` Cost — Cost of an item - `type` 'credit' | 'lite' - `value` number - `links` object - `self` string, uri-reference - `data` EnhancedProfile — Basic company information - `activities` Activity[] — Industry classifications for the company - `code` string — Activity code - `description` string — Description of activity - `classificationScheme` 'NACE' | 'SIC' | 'SIC07' | 'NAICS' — Classification scheme, for example NAICS or NACErev2 - `type` 'Primary' | 'Secondary' — Primary or secondary activity - `activityDeclarations` ActivityDeclaration[] — Full text declarations of the company's business purpose as stated in the registry - `declaration` string — The full text of the activity declaration from the registry (e.g., the company's stated business purpose from articles of incorporation) - `declarationDescription` string — The section heading or label from the registry document indicating where this declaration appears (e.g., "Objet social", "Business Purpose") - `language` string — Language code of the declaration text (e.g., 'fr', 'en') - `addresses` Address[] — Addresses for the company - `identifier` string, nullable — Stable identifier for this address instance within the profile. Use to cross-reference into the additionalInformation.addressInformation array. - `type` string — Type of address, for example "Head Office" or "Registered Address" - `fullAddress` string — The full address as a single string - `rawAddressLines` string[] — An array of address lines as retrieved from the registry - `buildingName` string — Name of building, e.g. "The Chrysler Building" - `streetNumber` string — Number portion of street address, e.g. "18", "21A" - `streetName` string — Street name - `city` string — City or town - `postcode` string — Primary postal code - `municipality` string — Administrative sub-region, for example a French commune or US county - `region` string — Administrative region for example a US state or UK county - `country` string — Country - `isoCode` string — Jurisdiction code in ISO 3166 alpha-2 - `secondaryPostalCode` string — A secondary postal code, for example a CEDEX - `totalCapital` object — Total share capital summary as reported by the registry. This value represents what the registry provides and may be authorized capital, issued capital, or nominal capital - the specific type is often not explicitly stated by registries. This summary is commonly available even when detailed share class breakdowns in the `capital` array are not provided. When the `capital` array is populated with share classes, the sum of `capital[].totalNominalValue` may represent the issued capital. The sum of shareholdings across all capital classes can also represent the issued capital, though this may not always equal `totalCapital.totalValue` if the registry reports authorized capital instead. - `totalValue` number — Total share capital amount as reported by the registry. This may represent authorized capital, issued capital, or nominal capital depending on what the registry provides. The specific type is typically not distinguished in registry data. - `quantity` number — Total number of shares as reported by the registry. This represents the aggregate number of shares across all share classes when available from the registry. - `currency` string — Currency of the capital amount. If multiple currencies exist in the `capital` array, this represents the primary currency or the currency used for the total calculation as reported by the registry. - `type` 'Fixed' | 'Variable' | 'Registered' — Capital structure type. `Fixed` and `Variable` indicate whether share capital can vary. `Registered` indicates the registry reports registered-capital amount (rather than authorized or paid-in), used primarily for CN / JP / VN entities. See [Normalised values](/documentation/useful-information/normalised-values) for definitions. - `capital` Capital[] — Array of share capital classes for the company. Each class represents a different type of share with its own details including state, code, title, number of shares, and amounts. - `type` string — Deprecated. Use classCode instead. - `description` string — Deprecated. Use classDescription instead. - `classCode` string — Class code of capital instrument - `classDescription` string — Description of capital class - `quantity` number — Number of shares in class/category (when available) - `unitNominalValue` number — Nominal value of each unit (i.e. each share) - `totalNominalValue` number — Total nominal value of shares in class/category - `currency` string — Currency of recorded capital - `votingRights` string — A text description of voting rights from the registry - `shareholdings` Shareholding[] — Array of shareholdings for the class - `percentage` string, nullable — Percentage of class/category that this shareholding represents. Null when ownership is expressed as a range (use percentageIsRange, percentageRange, percentageLowerLimit, percentageUpperLimit instead). - `percentageIsRange` boolean — When true, the holding is expressed as a range and percentage is null. Use percentageRange, percentageLowerLimit and percentageUpperLimit for the range. - `percentageRange` string, nullable — Human-readable percentage range when the registry provides a range rather than a single value (e.g. "0-100%"). Present when percentageIsRange is true. - `percentageLowerLimit` string, nullable — Lower bound of the percentage range as a numeric string (e.g. "0"). Present when percentageIsRange is true. - `percentageUpperLimit` string, nullable — Upper bound of the percentage range as a numeric string (e.g. "100"). Present when percentageIsRange is true. - `count` number — Number of shares held in class/category (when available) - `totalNominalValue` number — Total nominal value of shares in class/category - `currency` string - `beneficiallyHeld` boolean — In some jurisdictions a share holding may not be beneficially held for the indicated shareholders and needs to be investigated. - `shareholders` object — If multiple entries, the indicated shareholders have a joint holding of this shareholding with an unknown split. - `corporations` union[] — Array of shareholders that are corporations, or unknown legal entities depending on available data from the registry. - union - … - `individuals` union[] — Array of shareholders that are individuals, or unknown legal entities depending on available data from the registry. - union - … - `representatives` object - `corporations` union[] — Array of representatives that are corporations, or unknown legal entities depending on available data from the registry. - union - CorporationRepresentative — Any type of incorporated entity - `type` 'Corporation', required — Corporation type representative - `idNumber` string — Identification number assigned to representative - `name` string — Full Name - `address` Address — Standardised shared model for addresses - … - `registrationNumber` string — Company registration number in home registry - `registrationDate` NormalizedDate - … - `registrationAuthority` string — Registration Authority - `registeredAddress` Address — Standardised shared model for addresses - … - `otherIdentifiers` Identifier[] — Additional identifiers with their standardized type codes for this corporate entity - … - `natureOfControl` string[] — Nature of control of representative - `startDate` object — The date when the corporation became a beneficial owner. May not be available in all jurisdictions as some only record notification dates. - … - `notifiedDate` object — The date when the beneficial ownership was officially notified to the registry. This is often the only date available in beneficial ownership registers, representing when the ownership was declared rather than when it began. - … - `endDate` object — The date when the corporation ceased to be a beneficial owner. Only present for historical records. - … - `role` object - … - `isActive` boolean — True if officer is currently in post - `directorships` Directorship[] — List of directors roles at other companies - … - `powers` string[] — List of descriptions of officer's powers as described at source - OtherRepresentative — Description of a single representative of a company that cannot be definitively mapped to Individual or Corporation - `type` 'Other', required — Type of representative - `idNumber` string — Identification number assigned to representative - `name` string — Full Name - `address` Address — Standardised shared model for addresses - … - `role` object - … - `startDate` NormalizedDate - … - `endDate` NormalizedDate - … - `isActive` boolean — True if officer is currently in post - `directorships` Directorship[] — List of directors roles at other companies - … - `powers` string[] — List of descriptions of officer's powers as described at source - `individuals` union[] — Array of representatives that are individuals, or unknown legal entities depending on available data from the registry. - union - IndividualRepresentative — A natural person as opposed to a legal person/corporation - `type` 'Person', required — Person type representative - `idNumber` string — Identification number assigned to representative - `name` string — Full Name - `address` Address — Standardised shared model for addresses - … - `birthdate` object — Director's date of birth. The precision of this field matches what is available at the registry source. For UK companies, dates are normalized to ISO 8601 format (YYYY-MM) when only month and year are available. The normalized field will reflect the precision available at the registry and will not introduce additional precision. - … - `nationality` string — Nationality - `placeOfBirth` Address — Standardised shared model for addresses - … - `placeOfResidence` Address — Standardised shared model for addresses - … - `role` object - … - `startDate` NormalizedDate - … - `endDate` NormalizedDate - … - `isActive` boolean — True if officer is currently in post - `directorships` Directorship[] — List of directors roles at other companies - … - `powers` string[] — List of descriptions of officer's powers as described at source - OtherRepresentative — Description of a single representative of a company that cannot be definitively mapped to Individual or Corporation - `type` 'Other', required — Type of representative - `idNumber` string — Identification number assigned to representative - `name` string — Full Name - `address` Address — Standardised shared model for addresses - … - `role` object - … - `startDate` NormalizedDate - … - `endDate` NormalizedDate - … - `isActive` boolean — True if officer is currently in post - `directorships` Directorship[] — List of directors roles at other companies - … - `powers` string[] — List of descriptions of officer's powers as described at source - `ultimateBeneficialOwners` object — Information about Ultimate Beneficial Owners (UBOs) sourced from official beneficial ownership registers when integrated into company registers where available (e.g., UK's Persons of Significant Control register). - `individuals` union[] — Array of individuals identified as Ultimate Beneficial Owners - union - IndividualUBO — Details of an individual identified as an Ultimate Beneficial Owner from official beneficial ownership registers - `type` 'Person', required — Person type UBO - `idNumber` string — Identification number assigned to representative - `name` string — Full Name - `address` Address — Standardised shared model for addresses - … - `birthdate` object — Director's date of birth. The precision of this field matches what is available at the registry source. For UK companies, dates are normalized to ISO 8601 format (YYYY-MM) when only month and year are available. The normalized field will reflect the precision available at the registry and will not introduce additional precision. - … - `nationality` string — Nationality - `placeOfBirth` Address — Standardised shared model for addresses - … - `placeOfResidence` Address — Standardised shared model for addresses - … - `natureOfControl` string[] — List of nature of control of UBO - `startDate` object — The date when the individual became a beneficial owner. May not be available in all jurisdictions as some only record notification dates. - … - `notifiedDate` object — The date when the beneficial ownership was officially notified to the registry. This is often the only date available in beneficial ownership registers, representing when the ownership was declared rather than when it began. - … - `endDate` object — The date when the individual ceased to be a beneficial owner. - … - `kind` string — [FUTURE] The kind of individual UBO - OtherUBO — Details of an individual identified as an Ultimate Beneficial Owner from official beneficial ownership registers - `type` 'Other', required — Type of UBO - `idNumber` string — Identification number assigned to representative - `name` string — Full Name - `address` Address — Standardised shared model for addresses - … - `natureOfControl` string[] — List of nature of control of UBO - `startDate` object — The date when the individual became a beneficial owner. May not be available in all jurisdictions as some only record notification dates. - … - `notifiedDate` object — The date when the beneficial ownership was officially notified to the registry. This is often the only date available in beneficial ownership registers, representing when the ownership was declared rather than when it began. - … - `endDate` object — The date when the individual ceased to be a beneficial owner. - … - `corporations` union[] — Array of corporations identified as Ultimate Beneficial Owners - union - CorporationUBO — Details of a corporate entity identified as an Ultimate Beneficial Owner from official beneficial ownership registers - `type` 'Corporation', required — Corporation type - `idNumber` string — Identification number assigned to representative - `name` string — Full Name - `address` Address — Standardised shared model for addresses - … - `registrationNumber` string — Company registration number in home registry - `registrationDate` NormalizedDate - … - `registrationAuthority` string — Registration Authority - `registeredAddress` Address — Standardised shared model for addresses - … - `otherIdentifiers` Identifier[] — Additional identifiers with their standardized type codes for this corporate entity - … - `natureOfControl` string[] — Nature of control - `startDate` object — The date when the corporation became a beneficial owner. May not be available in all jurisdictions as some only record notification dates. - … - `notifiedDate` object — The date when the beneficial ownership was officially notified to the registry. This is often the only date available in beneficial ownership registers, representing when the ownership was declared rather than when it began. - … - `endDate` object — The date when the corporation ceased to be a beneficial owner. Only present for historical records. - … - `kind` string — [FUTURE] The kind of corporation UBO - OtherUBO — Details of an individual identified as an Ultimate Beneficial Owner from official beneficial ownership registers - `type` 'Other', required — Type of UBO - `idNumber` string — Identification number assigned to representative - `name` string — Full Name - `address` Address — Standardised shared model for addresses - … - `natureOfControl` string[] — List of nature of control of UBO - `startDate` object — The date when the individual became a beneficial owner. May not be available in all jurisdictions as some only record notification dates. - … - `notifiedDate` object — The date when the beneficial ownership was officially notified to the registry. This is often the only date available in beneficial ownership registers, representing when the ownership was declared rather than when it began. - … - `endDate` object — The date when the individual ceased to be a beneficial owner. - … - `contactDetails` ContactDetails - `email` string — Primary email address for company - `fax` string — Primary fax number for company - `telNumber` string — Primary phone number for company - `website` string — Primary website address for company - `companyRelationships` CompanyRelationship[] — Array of relationships between this company and other companies - `relationship` 'Subsidiary' | 'Merged' | 'Demerged' | 'Acquired' | 'Other' — Type of relationship (subsidiaries; or evolution history – merged, demerged, acquired) - `company` object — Details of the related company - `kyckrId` string — Kyckr ID of the related company - `companyName` string — Name of the related company - `companyNumber` string — Registration number of the related company - `effectiveDate` string, date — Date when the relationship became effective - `description` string — Additional description or details about the relationship - `links` object - `document` string, uri-reference - `data` string, uri - `registrationType` string — If present, indicates that the original foundational legal entity registration is at another register (the source register). - `registrationTypeDetails` object — Additional details in relation to the registration type, if registrationType is set. - `originalCode` string — Non standard code for the source registry. - `originalDescription` string — Description text for the source registry. - `normalizedCode` string — ISO code for the country, province or state of the source registry. - `normalizedDescription` string — Country and state description of the foreign registry. - `additionalInformation` AdditionalInformation — Additional enriched information for the profile. Only populated when an extension type is requested via the `extend` query parameter. - `addressInformation` AddressAdditionalInformation — Parsed and geocoded address variants for all addresses in the profile. Populated when the `geocoding` extension type is requested via the `extend` query parameter. - `addresses` AddressGroup[] — Array of address groups, one per unique source address. Each group contains parsed and/or geocoded variants and references to the entities in the profile that use this address. - `identifier` string — Matches the `identifier` on the source Address object. Use to correlate address groups with their corresponding addresses in the profile. - `variants` Address[] — Address representations derived from this source address. May include parsed variants (structured decomposition of the raw address) and geocoded variants (resolved via Google Maps, indicated by "Geocoded (Exact Match)" or "Geocoded (Partial Match)" type). Multiple parsed variants may exist where different parsers produce different results. Parsed and geocoded variants indicated by the 'Type' property - `identifier` string, nullable — Stable identifier for this address instance within the profile. Use to cross-reference into the additionalInformation.addressInformation array. - `type` string — Type of address, for example "Head Office" or "Registered Address" - `fullAddress` string — The full address as a single string - `rawAddressLines` string[] — An array of address lines as retrieved from the registry - `buildingName` string — Name of building, e.g. "The Chrysler Building" - `streetNumber` string — Number portion of street address, e.g. "18", "21A" - `streetName` string — Street name - `city` string — City or town - `postcode` string — Primary postal code - `municipality` string — Administrative sub-region, for example a French commune or US county - `region` string — Administrative region for example a US state or UK county - `country` string — Country - `isoCode` string — Jurisdiction code in ISO 3166 alpha-2 - `secondaryPostalCode` string — A secondary postal code, for example a CEDEX - `sources` InformationSource[] — References to the entities in the profile that use this address. - `entityName` string — Display name of the entity (company name or person name). - `entityType` string — Type of entity (e.g. "Company", "Individual Representative"). - `context` string — The address type context (e.g. "Registered Address", "Service Address"). - `path` string — JSON path to the source address within the profile response. - `identifiers` object - `primaryRegistrationNumber` string — Primary corporate registration number - `taxNumber` string — Deprecated, use otherIdentifiers instead - `secondaryRegistrationNumber` string — Deprecated, use otherIdentifiers instead - `otherIdentifiers` Identifier[] — Additional identifiers with their standardized type codes - `value` string — The identifier value - `type` string — The standardized type code for this identifier - `companyName` string — Company name in original language - `tradingName` string — Deprecated. Use aliases instead. - `englishName` string — Company name in English, if available - `aliases` AlternativeNames[] — Alternative company names - `name` string — Alternative company names - `type` string — Type of name, e.g. Trading Name, Business Name - `previousNames` PreviousNames[] — Previous company names - `name` string — Previous company name - `startDate` NormalizedDate - `original` string — Date as formatted at registry source - `normalized` string, date — Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available. - `endDate` NormalizedDate - `original` string — Date as formatted at registry source - `normalized` string, date — Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available. - `registrationAuthority` string — Name of authority where the company is registered, e.g. KVK, Companies House - `lastUpdated` string, date-time — Date that the information in the profile was last updated - `lastAnnualAccountDate` NormalizedDate - `original` string — Date as formatted at registry source - `normalized` string, date — Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available. - `foundationDate` NormalizedDate - `original` string — Date as formatted at registry source - `normalized` string, date — Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available. - `registrationDate` NormalizedDate - `original` string — Date as formatted at registry source - `normalized` string, date — Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available. - `incorporationDate` NormalizedDate - `original` string — Date as formatted at registry source - `normalized` string, date — Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available. - `dissolutionDate` NormalizedDate - `original` string — Date as formatted at registry source - `normalized` string, date — Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available. - `status` NormalizedStatus - `original` string — Legal status as described at source - `normalized` 'Active' | 'Inactive' | 'Distressed' | 'Other' — Legal status mapped to a standard Kyckr value (see Normalised values guide) - `legalForm` NormalizedLegalForm - `original` string — Legal form as described at source - `normalized` 'Private Limited Company' | 'Public Limited Company' | 'Limited Partnership' | 'Limited Liability Partnership' | 'General Partnership' | 'Cooperative' | 'Collective Investment Vehicle' | 'Association' | 'Sole Proprietor' | 'Branch' | 'Foreign Registered Body' | 'Government or Public Body' | 'Foundation' | 'Trust' | 'Other' — Standard value mapped from the registry's legal form. See [Normalised values](/documentation/useful-information/normalised-values) for the 15 possible values and what they mean. **Beta** — first populated for HK, CN, and JP in an upcoming release; other jurisdictions will follow. Where populated, `Other` is used when no specific value fits; the original registry label remains in `original`. - `incorporationJurisdiction` object - `original` string — Jurisdiction of incorporation - `registeredAgentName` string — Name of registered agent - `registeredAgentAddress` string — Address of registered agent ## Other responses - `202` — Accepted — enhanced profile order created; server held connection up to ~40s but profile is not yet ready - `400` — Bad request - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found - `429` — Too many requests --- [API](https://skmtc.net/kyckr/apis/kyckr-companies-v2-api.md) · [All operations](https://skmtc.net/kyckr/apis/kyckr-companies-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyckr/kyckr-companies-v2-api/revisions/ed17e149d3c8/schema)