All Lite 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 a Lite Profile
KYB onboarding
Confirm a company’s name, registration number, and legal status before proceeding with a full due diligence workflow.
Address verification
Retrieve the company’s registered address for identity confirmation or document delivery.
Status checks
Quickly confirm whether a company is active, dissolved, or otherwise no longer trading.
Pre-screening
Validate a company’s existence and basic details before committing to a more detailed — and more expensive — Enhanced Profile order.
How it works
Ordering a Lite 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 an
id field — a unique identifier for that company in Kyckr’s network.2
Order the Lite Profile
Pass the
id from the search response as the resource identifier in the Lite Profile request. Kyckr retrieves the current data from the registry and returns it in the response.Request
{id} with the company identifier returned by the search endpoint.
Optional Parameters
You can include a customer reference for the transaction using the parameterkey
customerreference
Authentication
All requests require a Bearer token in theAuthorization header.
Example request
id format encodes the jurisdiction and a registry-specific identifier. In the example above, GB|MTE2NTUyOTA identifies Kyckr UK Limited on the UK Companies House register.
Response
Example response
Response fields
Lite Profile vs. Enhanced Profile
Use the Lite Profile when you need to confirm existence and status. Use the Enhanced Profile when your workflow requires ownership structure, representatives, or filings.
Best practices
Always run a search first
Always run a search first
The Lite Profile endpoint requires a valid
id from the search response. Attempting to construct an id manually is not supported and will produce unreliable results. Always derive the id from a prior search call.Check legalStatus before downstream processing
Check legalStatus before downstream processing
Before passing a company’s details into any downstream workflow, inspect
data.legalStatus.original. Because this value is sourced verbatim from the registry and varies by jurisdiction, do not hardcode checks against a specific string like "active". Instead, build your logic to handle the range of values your target jurisdictions may return, and consider flagging unrecognised values for manual review.Handle missing fields gracefully
Handle missing fields gracefully
Because field availability varies by registry, your integration should treat all
data fields as optional and handle their absence without throwing errors. Do not assume that a field present in one jurisdiction will be present in another.Use correlationId for support
Use correlationId for support
If you encounter unexpected results or need to raise a support query, include the
correlationId from the response. This allows Kyckr’s support team to trace the exact registry interaction.Next steps
Enhanced Profile
Retrieve directors, shareholders, and full ownership structure for a company.
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.