Skip to main content

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.

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}}'

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