Company search

Most registries on Kyckr's network can be searched by either company name or company number.

To search for a company, a name or number and the ISO code of the jurisdiction are required. This performs a jurisdiction-specific search.

Below are examples of requests for search by name and search by number.

Search by company name

To search for a company in a jurisdiction by name, provide the company name and the ISO country code of the jurisdiction to be searched. ISO codes are two letter, capital case codes.

The search results contain a list of companies from the chosen registry. Additionally, the results will contain a codeField, which can be used as a parameter for other API calls.

[ Search by company name API reference ] [ Jurisdictions and regional codes ]

Search by registration number

To search for a company in the registry by registration number - provide the registration number and ISO country code of the jurisdiction to be searched.

A search result can help determine if company exists in the chosen registry and if the company number provided is valid. Again the codeField in the response can be used for further queries.

[ Search by registration number API reference]

Details provided in the response

Depending on the registry, different information is provided in the response for a search. For the purposes of verifying an entity the most important fields are:

{
    "companiesField": [
        {
            "addressesField": [
                {
                    "countryField": "United Kingdom",
                    "addressInOneLineField": "Kemp House, 160 City Road, London, United Kingdom, EC1V 2NX",
                    "addressLine1Field": "Kemp House",
                    "addressLine2Field": "160 City Road",
                    "cityTownField": "London",
                    "postcodeField": "EC1V 2NX"
                }
            ],
            "codeField": "11655290",
            "companyIDField": "11655290",
            "legalFormField": "ltd",
            "legalStatusField": "active",
            "nameField": "KYCKR UK LIMITED",
            "officialField": false,
            "registrationAuthorityField": "Companies House, United Kingdom",
            "incorporationDateField": "2018-11-01"
        }
    ],
    "transactionIdField": "1523472",
    "responseCodeField": 100

In the example response above:

• Kyckr is an active company by looking at the LegalStatusField.
• The codeField unique identifier in the response can be used for subsequent API calls.
• The full name of the company in the nameField is Kyckr UK Limited.

Video tutorial - Using search APIs

Registration authority

In Germany and Canada, earch will return additional fields for registration authority:
registrationAuthorityField and registrationAuthorityCodeField.

If these fields appear in search results, then to order a profile, the registrationAuthorityCodeField must be supplied to order a company profile. (Note - search by name and search by number APIs do not require the "registrationAuthorityCodeField".)

In the search response example below, there is a "registrationAuthorityField": and "registrationAuthorityCodeField" in the response (Lines 16 and 17).

 "companiesField": [
        {
            "addressesField": [
                {
                    "countryField": "DE",
                    "addressInOneLineField": "Gütersloh, Germany",
                    "cityTownField": "Gütersloh"
                }
            ],
            "codeField": "VR 1464",
            "companyIDField": "VR 1464",
            "legalFormField": "e. V.",
            "legalStatusField": "active",
            "nameField": "Audi-80-Scene e. V.",
            "officialField": false,
            "registrationAuthorityField": "Gütersloh district court",
            "registrationAuthorityCodeField": "Gütersloh"
        },

The registrationAuthorityCodeField, as it is present in the response, is required to order a company profile, lite profile and for a filing search.

If the registrationAuthorityCodeField is not present in a search response, it is not required in other APIs, as the codeField alone will be sufficient to specify the company.

curl --location 'https://rest.kyckr.com/core/company/profile/DE/VR 1464?RegAuth=Gütersloh' 
--header 'Authorization: {{apiKey}}' 

Video tutorial - Registration authority parameter