Skip to main content
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

KYB due diligence

Retrieve directors, officers, and shareholders as part of a full Know Your Business workflow.

Ownership verification

Confirm shareholders, share counts, and ultimate holding companies where filed in structured form at the registry.

Representative checks

Identify company officials, their appointed roles, nationalities, and addresses as recorded at the register.

Capital structure

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:
1

Search for the company

Use the Company Search 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.
2

Order the Enhanced Profile

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 for the full rollout list and integration guidance.

Request

Authentication

All requests require an API key in the Authorization header.

Example request


Response

Example response


Registration fields

Capital fields

Directors fields

Shareholders fields

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

Next steps

Lite Profile

Retrieve core company details without the overhead of a full Enhanced Profile.

Filing Search

Order official registry documents and historical filings.

Supported Jurisdictions

Browse the full list of countries and registries covered by Kyckr.

API Reference

Full endpoint specification with all parameters and response schemas.