Skip to main content

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:
Lite Profile API reference GuideEnhanced Profile API reference Guide
GET /companies/{kyckrId}/liteGET /companies/{kyckrId}/enhanced
Company name and registration numberCompany name and registration number
Registered address or localityRegistered address or locality
Legal form and statusLegal form and status
Foundation dateFoundation date
Primary business activityPrimary business activity
Corporate structure
Legal form and status
Company officials
Shareholding information (where available)
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:
  1. 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)
  2. Track orders (GET /orders)
    • Monitor the status of document orders
    • Download documents when ready
    • Access both structured data and original registry formats
All responses include standardized fields for tracking (correlationId, customerReference).