Searching for a company
Guide API reference A search by company name or number must be performed in order to find a valid, registered legal entity using the API (GET /companies).
A KyckrId will be returned in the JSON response. Any additional API calls will use the KyckrId as the identifier for the company.
KyckrIds follow the format:
{jurisdiction}|{base64-encoded-reference}
For example:
GB|MTE2NTUyOTA
The kyckrId format may be subject to change in a future release and should not be used for persistent storage.
Retrieving company information
Once the correct entity is located, several options are available for retrieving company information:
The information is retrieved directly from the registry at the point of request — synchronously for most jurisdictions. (An async order pattern is in development [preview] for cases where upstream fulfilment exceeds the connection-hold window — see the developer news for rollout details.) The response is returned in a standard JSON format, allowing easy mapping into your platform regardless of the targeted registry.
Ordering original registry documents
If additional information is required, original registry documents are available:-
List available documents (
GET /companies/{kyckrId}/documents)- Shows document types, costs, and delivery times
- Indicates what information each document contains (company details, directors, shareholders, UBOs)
-
Track orders (
GET /orders)- Monitor the status of document orders
- Download documents when ready
- Access both structured data and original registry formats
correlationId, customerReference).