> ## 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.

# Enhanced Profile

> Retrieve company profiles with representatives, directors, and shareholders information.

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](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.

### Search

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](search)

### Order an Enhanced Profile

To order an Enhanced Profile from from a registry, the following variables are needed:

* codeField
* 2 digit [ISO code](https://www.iso.org/iso-3166-country-codes.html)
* 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 theme={null}
curl --location 'https://rest.kyckr.com/core/company/profile/GB/11655290' \
--header 'Authorization: {{apiKey}}'
```

[Enhanced Profile API reference](/api-reference/company-profile/enhanced-profile)

### 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.

<Info>**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](/company-v1/developer-news/2026-06-async-order-pattern) for the full rollout list and integration guidance.</Info>

#### 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".

```json theme={null}
"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](https://www.youtube.com/watch?v=z8Mjvj1XnAQ)