Skip to main content
A company profile, including information about directors and shareholders, is retrieved using the Enhanced Profile API. This profile contains all information from the Lite Profile and adds details of associated persons or entities filed at the company registry. 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.
To order an Enhanced Profile, first search the registry to find the entity. The search response confirms the entity is active and provides a codeField identifier, which is required to order the Enhanced Profile. The search response may also include a registrationAuthorityField. The Registration Authority Code is a unique identifier provided by some registries to specify the registration authority responsible for maintaining the company’s records. This code is often required in API requests, such as when ordering an Enhanced Profile, to ensure the request is directed to the correct registry or authority. If registrationAuthorityField is present in the search response, it must be included in subsequent API calls. Search guide

​
Order an Enhanced Profile

To order an Enhanced Profile from from a registry, the following variables are needed:
  • codeField
  • 2 digit ISO code
  • Registration Authority Code (if present in search response)
Below are examples of director and shareholder information contained in the Enhanced Profile for Kyckr. The Enhanced Profile was retrieved using the following URL GET request: 
curl --location 'https://rest.kyckr.com/core/company/profile/GB/11655290' \
--header 'Authorization: {{apiKey}}'
Enhanced Profile API reference

​
Asynchronous fulfilment

For most jurisdictions, GET /core/company/profile/{countryISO}/{companyCode} returns the profile within ~40s. Where upstream fulfilment exceeds that window, the response today times out without delivery (primarily observed for Luxembourg, with Hong Kong also in scope for the rollout). Once the async order pattern is live, the endpoint will return 202 with a numeric orderId and a Location header pointing at the order-status endpoint. To complete the fulfilment:
  1. Persist the numeric orderId from the 202 response (it equals productOrderIdField in the order-status list).
  2. Poll GET /core/filing/order-status/{orderedWithin} — for example orderedWithin=1 for the last 24 hours.
  3. Scan the returned array for the item whose productOrderIdField matches your orderId.
  4. When the matching item’s statusField is 2, 21, or 3, retrieve the profile from urlField or structuredDataUrlField.
Status values: 1 = pending; 2/21/3 = ready; 5 = failed; 9 = cancelled.
Status: Preview — the 202 fallback is part of an initial preview rollout (GB, IE, LU, EE, LV, CN, JP, HK) alongside V2’s POST Enhanced Profile. See the release note for the full rollout list and integration guidance.

​
Shareholders

In the example below, the percentageField shows that Kyckr UK Limited is 100% owned by Kyckr Limited. The field ShareholderTypeField shows that the shareholder is a company “C”, If the shareholder was a person the UK registry would denote this as “P”. 
"shareHoldersField": [
                {
                    "nameField": "KYCKR LIMITED",
                    "percentageField": "100",
                    "allInfoField": "1.00 ORDINARY  GBP 1.00",
                    "currencyField": "GBP",
                    "nominalValueField": "1",
                    "shareCountField": 1,
                    "shareTypeField": "ORDINARY",
                    "shareholderTypeField": "C",
                    "totalShareCountField": 1,
                    "totalShareValueField": 1,
                    "totalSharesField": 1
                }

​
Video tutorial - Retrieve an Enhanced Profile

Watch: Retrieve an Enhanced Profile