> ## 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.
# Perform a KYB Check
> What the API returns for directors, shareholders, and company structure — and when to use it over a Lite Profile.
An Enhanced Profile returns everything included in a Lite Profile — name, registration number, address, legal status, legal form, activity codes — plus the full set of associated persons and entities filed at the registry: directors, officers, shareholders, and capital structure.
Use an Enhanced Profile when your workflow requires ownership structure, representatives, or share capital information.
All Enhanced Profile data is sourced live from the registry at the time of the request. There is no cached layer — what you receive reflects the current state of the register.
***
## When to use an Enhanced Profile
Retrieve directors, officers, and shareholders as part of a full Know Your Business workflow.
Confirm shareholders, share counts, and ultimate holding companies where filed in structured form at the registry.
Identify company officials, their appointed roles, nationalities, and addresses as recorded at the register.
Retrieve share capital details including share class, quantity, currency, and total value where filed at the registry.
***
## How it works
Ordering an Enhanced Profile is a two-step process:
Use the [Company Search](/api-reference/company-search/search-by-name) endpoint to locate the company and confirm it exists in the registry. The search response returns a `codeField` — a unique identifier for that company on the register. If a `registrationAuthorityCodeField` is present in the search response, note this value — it will be required in the next step.
Pass the `codeField` and the two-digit ISO country code as path parameters in the Enhanced Profile request. If the search response included a `registrationAuthorityCodeField`, this must also be supplied as the `RegAuth` query parameter. Kyckr retrieves the current data from the registry and returns it in the response.
***
## Asynchronous fulfilment
For most jurisdictions, `GET /core/company/profile/{countryISO}/{companyCode}` returns the profile synchronously 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 V1 Enhanced Profile endpoint will return `202` with a numeric `orderId` and a `Location` header. Poll `GET /core/filing/order-status/{orderedWithin}` (for example `orderedWithin=1` for the last 24 hours) and match `productOrderIdField` in each returned item against the `orderId`. When the matching item's `statusField` is `2`, `21`, or `3`, retrieve the profile from `urlField` or `structuredDataUrlField`.
**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.
***
## Request
```bash theme={null}
GET /core/company/profile/{isocode}/{codeField}
```
| Parameter | Type | Required | Description |
| ----------- | ----- | ----------- | ------------------------------------------------------------------------------------------------------- |
| `isocode` | path | Yes | Two-digit ISO 3166-1 alpha-2 country code (e.g. `GB`, `AU`). |
| `codeField` | path | Yes | The unique company identifier returned by the search endpoint. |
| `RegAuth` | query | Conditional | Required for Germany and Canada if `registrationAuthorityCodeField` was present in the search response. |
### Authentication
All requests require an API key in the `Authorization` header.
### Example request
```bash theme={null}
curl --location 'https://rest.kyckr.com/core/company/profile/AU/ACN:%20609323257' \
--header 'Authorization: {{apiKey}}'
```
***
## Response
### Example response
```json theme={null}
{
"companyProfileField": {
"addressesField": [
{
"typeField": "Registered Office (from 18/11/2022)",
"addressInOneLineField": "UNIT 3, 1 COGGINS PLACE, MASCOT, NSW, 2020",
"addressLine1Field": "UNIT 3",
"addressLine2Field": "1 COGGINS PLACE",
"addressLine3Field": "MASCOT",
"addressLine4Field": "NSW",
"addressLine5Field": "2020",
"cityTownField": "MASCOT",
"regionStateField": "NSW",
"postcodeField": "2020"
}
],
"aliasesField": [
"ABN: 38609323257"
],
"capitalField": [
{
"ammountField": "45201839.11",
"currencyField": "AUD",
"typeField": "ORDINARY SHARES",
"typeCodeField": "ORD",
"shareQuantityField": 543721331,
"amountDueField": 0.0
}
],
"codeField": "ACN: 609323257",
"dateField": "2026-05-06T08:44:45.6329394Z",
"legalFormField": "Australian Proprietary Company Limited By Shares",
"legalStatusField": "Registered",
"normalizedLegalStatusField": "ACTIVE",
"nameField": "KYCKR PTY LIMITED",
"registrationAuthorityField": "Australian Securities and Investment Commission (ASIC)",
"registrationDateField": "16/11/2015",
"directorAndShareDetailsField": {
"directorsField": [
{
"titleField": "Director",
"nameField": "RICHARD JOHN WHITE",
"address1Field": "25 BOURKE ROAD",
"address2Field": "ALEXANDRIA",
"address3Field": "NSW",
"birthdateField": "22/12/1954",
"appointedOnField": "11/4/2022 12:00:00 AM"
},
{
"titleField": "Secretary",
"nameField": "RICHARD JOHN WHITE",
"address1Field": "25 BOURKE ROAD",
"address2Field": "ALEXANDRIA",
"address3Field": "NSW",
"birthdateField": "22/12/1954",
"appointedOnField": "5/5/2025 12:00:00 AM"
},
{
"directorNumberField": "ACN: 673619639",
"titleField": "Ultimate Holding Company",
"nameField": "REALWISE GROUP HOLDINGS DT PTY LIMITED",
"otherIdentifiersField": [
{
"typeField": "AU_ACN_CD",
"valueField": "673619639"
}
]
}
],
"shareHoldersField": [
{
"idField": "660041074",
"nameField": "REALWISE KYK AV PTY LTD",
"addressField": "UNIT 3, 1 COGGINS PLACE, MASCOT, NSW, 2020",
"percentageField": "100",
"currencyField": "AUD",
"shareClassField": "ORD",
"shareCountField": 543721331,
"shareTypeField": "ORDINARY SHARES",
"shareholderTypeField": "Company",
"totalShareCountField": 543721331,
"totalShareValueField": 45201839,
"beneficiallyHeldField": true,
"jointlyHeldField": false,
"otherIdentifiersField": [
{
"typeField": "AU_ACN_CD",
"valueField": "660041074"
}
]
}
]
}
},
"transactionIdField": "5668219",
"retrievalLocationField": "https://download.kyckr.com/file/1047239471-0",
"responseCodeField": "100"
}
```
***
### Registration fields
| Field | Description |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `companyProfileField.nameField` | The company's registered name as it appears on the registry. |
| `companyProfileField.codeField` | The company's registration number as issued by the registry. |
| `companyProfileField.registrationDateField` | The date the company was registered. |
| `companyProfileField.legalStatusField` | The company's current registration status in the registry's own terminology. Values vary by jurisdiction. |
| `companyProfileField.normalizedLegalStatusField` | A normalised representation of the legal status where available. |
| `companyProfileField.legalFormField` | The company's legal form as recorded at the registry. |
| `companyProfileField.addressesField` | The company's registered address. Multiple address types may be returned (e.g. Registered Office, Principal Place of Business). The `typeField` on each entry identifies the address type. |
| `companyProfileField.aliasesField` | An array of known aliases or alternative identifiers for the company, such as ABN. |
| `companyProfileField.registrationAuthorityField` | The name of the company register from which the data was sourced. |
### Capital fields
| Field | Description |
| ----------------------------------- | --------------------------------------------------------------------------------------------------- |
| `capitalField[].typeField` | The class or type of shares (e.g. `ORDINARY SHARES`). |
| `capitalField[].typeCodeField` | The short code for the share type (e.g. `ORD`). |
| `capitalField[].ammountField` | The total value of shares in this class. Note the field name uses the registry's original spelling. |
| `capitalField[].currencyField` | The currency in which the share value is denominated. |
| `capitalField[].shareQuantityField` | The total number of shares in this class. |
| `capitalField[].amountDueField` | The amount unpaid on shares in this class, where applicable. |
### Directors fields
| Field | Description |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `directorsField[].titleField` | The role or function of the individual or entity (e.g. `Director`, `Secretary`, `Ultimate Holding Company`). |
| `directorsField[].nameField` | The full name of the director or associated entity. |
| `directorsField[].directorNumberField` | A unique identifier for the director or associated entity as recorded at the registry, where available. |
| `directorsField[].address1Field` | First line of the director's registered address. |
| `directorsField[].address2Field` | Second line of the director's registered address. |
| `directorsField[].address3Field` | Third line of the director's registered address, where available. |
| `directorsField[].address4Field` | Fourth line of the director's registered address, where available. |
| `directorsField[].birthdateField` | Date of birth of the director, where filed at the registry. Format varies by jurisdiction. |
| `directorsField[].appointedOnField` | The date the director was appointed, where filed at the registry. |
| `directorsField[].otherIdentifiersField` | An array of additional identifiers for the entity (e.g. ACN, ABN), where available. |
### Shareholders fields
| Field | Description |
| ------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `shareHoldersField[].nameField` | The full name of the shareholder. |
| `shareHoldersField[].idField` | A unique identifier for the shareholder as recorded at the registry, where available. |
| `shareHoldersField[].addressField` | The registered address of the shareholder. |
| `shareHoldersField[].percentageField` | The percentage of shares held by this shareholder. |
| `shareHoldersField[].shareTypeField` | The type or class of shares held. |
| `shareHoldersField[].shareClassField` | The short code for the share class held. |
| `shareHoldersField[].shareCountField` | The number of shares held by this shareholder. |
| `shareHoldersField[].currencyField` | The currency in which the share value is denominated. |
| `shareHoldersField[].totalShareCountField` | The total number of shares in issue. |
| `shareHoldersField[].totalShareValueField` | The total value of shares in issue. |
| `shareHoldersField[].shareholderTypeField` | Indicates whether the shareholder is a company or an individual. Values vary by registry. |
| `shareHoldersField[].beneficiallyHeldField` | Indicates whether the shares are beneficially held, where filed. |
| `shareHoldersField[].jointlyHeldField` | Indicates whether the shares are jointly held, where filed. |
| `shareHoldersField[].otherIdentifiersField` | An array of additional identifiers for the shareholder (e.g. ACN, ABN), where available. |
Field availability varies by registry. Not all registries publish every field. Where a data point is absent from the source registry, the corresponding field will be omitted from the response rather than returned as null.
`legalStatusField` is always a raw string returned verbatim from the source registry. Kyckr does not normalise or standardise this value. The exact string varies by jurisdiction — do not rely on a fixed set of values when building conditional logic around company status.
The `directorsField` array may include individual directors, company secretaries, and corporate entities such as ultimate holding companies, depending on what the registry files in structured form. Always inspect `titleField` to determine the nature of each entry.
***
## Enhanced Profile vs. Lite Profile
| | Lite Profile | Enhanced Profile |
| ---------------------------- | --------------------------------------------- | -------------------------- |
| **Company name & number** | ✅ | ✅ |
| **Legal status** | ✅ | ✅ |
| **Registered address** | ✅ | ✅ |
| **Foundation date** | ✅ | ✅ |
| **Legal form** | ✅ | ✅ |
| **Activity codes** | ✅ | ✅ |
| **Directors & officers** | ❌ | ✅ |
| **Shareholders** | ❌ | ✅ |
| **Share capital structure** | ❌ | ✅ |
| **Ultimate holding company** | ❌ | ✅ |
| **Best for** | Fast status checks & onboarding pre-screening | Full KYB and due diligence |
## Next steps
Retrieve core company details without the overhead of a full Enhanced Profile.
Order official registry documents and historical filings.
Browse the full list of countries and registries covered by Kyckr.
Full endpoint specification with all parameters and response schemas.