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 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 --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.
Status: Preview — POST V2 Enhanced Profile will be rolled out registry-by-registry. See the release note for the full rollout list and integration guidance.

​
Shareholders

In the example below, there are two individuals who have sharholding percentages in the company. 
"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"
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        ],
The Kyckr Enhanced Profile includes a download link for generating PDF file in the response. 
"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.