> ## 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 unique id, which is required to order the Enhanced Profile.

### Order an Enhanced Profile

To order a Enhanced Profile, simply use the `id` field from the search as the resource identifier.

Below is an example of an Enhanced Profile for a company pulled live from the registry. The Enhanced Profile was retrieved using the following URL GET request:

```curl theme={null}
curl --location 'https://api.kyckr.com/v2/companies/NZ|OTQyOTAzMjk4MjU3Mg/enhanced' \
--header 'Authorization: {{apiKey}}'
```

### Asynchronous fulfilment

For most jurisdictions, `GET /v2/companies/{kyckrId}/enhanced` returns the profile within \~40s. Two async patterns are available:

* **`POST /v2/companies/{kyckrId}/enhanced`** — recommended for production. Returns an `orderId` immediately with no server-side connection hold. Poll `GET /v2/orders/{orderId}` until `data.status` is `Success`, then retrieve the profile from the order result. **Initial preview rollout: GB, IE, LU, EE, LV, CN, JP, HK.**
* **`GET /v2/companies/{kyckrId}/enhanced`** with `202` fallback — will fire when upstream fulfilment exceeds the \~40s connection-hold window. Server holds up to \~40s; returns `200` with the profile if ready, or `202` with `orderId` and a `Location` header if not.

`405` will be removed from `GET /enhanced` — clients will no longer need to detect sync-vs-async jurisdictions.

<Info>**Status: Preview** — POST V2 Enhanced Profile will be rolled out registry-by-registry. See the [release note](/company-v2/developer-news/2026-06-async-order-pattern) for the full rollout list and integration guidance.</Info>

#### Shareholders

In the example below, there are two individuals who have sharholding percentages in the company.

```json theme={null}
"capital": [
            {
                "quantity": 100.0
            },
            {
                "quantity": 100.0,
                "shareholdings": [
                    {
                        "percentage": "99.00",
                        "shareholders": {
                            "individuals": [
                                {
                                    "type": "Person",
                                    "name": "KIELER, Mette",
                                    "address": {
                                        "fullAddress": "1 Cornford Street, Karori, Wellington, , 6012, NZ",
                                        "postcode": "6012",
                                        "isoCode": "NZ"
                                    }
                                }
                            ]
                        }
                    },
                    {
                        "percentage": "1.00",
                        "shareholders": {
                            "individuals": [
                                {
                                    "type": "Person",
                                    "name": "JOYCE, Darryl",
                                    "address": {
                                        "fullAddress": "1 Cornford Street, Karori, Wellington, , 6012, NZ",
                                        "postcode": "6012",
                                        "isoCode": "NZ"
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        ],
```

### Enhanced Profile PDF download link

The Kyckr Enhanced Profile includes a download link for generating PDF file in the response.

```json theme={null}
"links": {
    "document": "/orders/10002/download"
}
```

If an Enhanced Profile contains a large amount of shareholder or director information, the PDF may take a few seconds to generate as it is being processed on demand.

Kyckr recommends customers wait a few seconds between receiving the Enhanced Profile and using the PDF download link.