Workflow

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 ] [ Guide ]	Enhanced Profile [ API reference ] [ Guide ]
GET /companies/{kyckrId}/lite	GET /companies/{kyckrId}/enhanced
Company name and registration number	Company name and registration number
Registered address or locality	Registered address or locality
Legal form and status	Legal form and status
Foundation date	Foundation date
Primary business activity	Primary business activity
	Corporate structure
	Legal form and status
	Company officials
	Shareholding information (where available)

The information is retrieved directly from the registry in real time and 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).