Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt

Use this file to discover all available pages before exploring further.

Company search is the entry point to Kyckr. Every subsequent API call — Lite Profile, Enhanced Profile, Filing Search — requires the codeField returned by a successful search. There are two ways to search, either by name or registration number.
Search modeWhen to useRequired parameters
Jurisdiction name searchYou know the company’s country and name — use this by defaultisocode + name or companyNumber
Jurisdiction number searchYou know the company’s country and registration number — use this by defaultisocode + name or companyNumber
Global searchYou don’t know the country and cannot determine itname only
Use global search only when the jurisdiction is genuinely unknown. It queries a stored company index rather than live registries, so results may not reflect the current state of the register. Once global search has helped you identify the correct country, always follow up with a jurisdiction search to confirm the company’s current status before proceeding.
A jurisdiction search queries the official company register for a specific jurisdiction, returning live data at the point of request. You can search using either company name or registration number, along with the two-letter ISO country code for the jurisdiction. There are separate endpoints for both search modes.
ISO country codes are two-letter and uppercase — for example, GB for the United Kingdom, DE for Germany, AU for Australia. See the full list of supported jurisdictions.

​
Search by name

curl --request GET \
  --url 'https://rest.kyckr.com/core/company/search/GB/Kyckr' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Example response

{
    "companiesField": [
        {
            "addressesField": [
                {
                    "countryField": "England",
                    "addressInOneLineField": "78 York Street, London, England, W1H 1DP",
                    "addressLine1Field": "78 York Street",
                    "cityTownField": "London",
                    "postcodeField": "W1H 1DP"
                }
            ],
            "codeField": "11655290",
            "companyIDField": "11655290",
            "dateField": "2026-05-05T14:00:27.8778928Z",
            "legalFormField": "Private limited company",
            "legalStatusField": "Active",
            "nameField": "KYCKR UK LIMITED",
            "officialField": false,
            "registrationAuthorityField": "Companies House, United Kingdom",
            "registrationDateField": "2018-11-01"
        }
    ],
    "responseCodeField": 100
}

​
Search by registration number

curl --request GET \
  --url 'https://rest.kyckr.com/core/company/number-search/GB/11655290' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Example response

{
    "companiesField": [
        {
            "addressesField": [
                {
                    "countryField": "England",
                    "addressInOneLineField": "78 York Street, London, England, W1H 1DP",
                    "addressLine1Field": "78 York Street",
                    "cityTownField": "London",
                    "postcodeField": "W1H 1DP"
                }
            ],
            "codeField": "11655290",
            "companyIDField": "11655290",
            "dateField": "2026-05-05T14:31:54.8012905Z",
            "legalFormField": "Private limited company",
            "legalStatusField": "Active",
            "nameField": "KYCKR UK LIMITED",
            "officialField": false,
            "registrationAuthorityField": "Companies House, United Kingdom",
            "registrationDateField": "2018-11-01"
        }
    ],
    "responseCodeField": 100
}

​
Key response fields

Depending on the registry, different information is provided in the search response. For the purposes of verifying an entity the most important fields are:
FieldPurpose
codeFieldUnique code for an entity — used for ordering a company profile or retrieving registry documents.
legalStatusFieldConfirms if the company is active or inactive.
nameFieldThe full name of the company on the register.
Use global search only when you cannot determine the company’s jurisdiction by other means — for example, when a counterparty hasn’t provided their country of registration. It queries a search index across 100+ countries and returns matching entities alongside their jurisdiction, which you can then use to run a jurisdiction search. Global search is a discovery tool, not a substitute for jurisdiction search. Use it to identify the country, then immediately follow up with a jurisdiction search to retrieve live, authoritative data from the official register. Search by name only — no isocode is required. 
curl --request GET \
  --url 'https://rest.kyckr.com/core/company/cache-search/kyckr' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Example response

{
  "totalRecordsField": 3,
  "totalPagesField": 0,
  "currentPageNumberField": 1,
  "companiesField": [
    {
      "addressesField": [
        {
          "addressInOneLineField": "78 YORK STREET, LONDON, WESTMINSTER, W1H 1DP",
          "addressLine1Field": "YORK STREET",
          "cityTownField": "LONDON",
          "postcodeField": "W1H 1DP"
        }
      ],
      "codeField": "11655290",
      "companyIDField": "11655290",
      "legalFormField": "Ltd",
      "legalStatusField": "Active",
      "nameField": "KYCKR UK LIMITED",
      "officialField": false,
      "countryISOField": "GB",
      "lastUpdatedField": "2026-05-05T17:55:12.000Z"
    },
    {
      "addressesField": [
        {
          "addressInOneLineField": "1 COGGINS PLACE, 2020, MASCOT",
          "addressLine1Field": "1 COGGINS PLACE",
          "cityTownField": "MASCOT",
          "postcodeField": "2020"
        }
      ],
      "codeField": "609323257_KYCKR PTY LIMITED",
      "companyIDField": "609323257",
      "legalFormField": "Ltd",
      "legalStatusField": "Active",
      "nameField": "KYCKR PTY LIMITED",
      "officialField": false,
      "countryISOField": "AU",
      "lastUpdatedField": "2026-01-30T08:29:29.674Z"
    },
    {
      "addressesField": [
        {
          "addressInOneLineField": "ARC LABS RESEARCH CENTER, WIT WEST CAMPUS, CARRIGANORE WATERFORD, CO WATERFORD WATERFORD IRELAND, 999940",
          "postcodeField": "999940"
        }
      ],
      "codeField": "436024",
      "companyIDField": "436024",
      "legalFormField": "Ltd",
      "legalStatusField": "active",
      "nameField": "KYCKR IRELAND LIMITED",
      "officialField": false,
      "countryISOField": "IE",
      "lastUpdatedField": "2025-07-30T23:28:53.5353Z"
    },
}

​
Registration Authority

In Germany and Canada, search will return additional fields for registration authority: registrationAuthorityField and registrationAuthorityCodeField. If these fields appear in search results, the registrationAuthorityCodeField must be supplied to order a company profile.
Search by name and search by number APIs do not require the registrationAuthorityCodeField
In the example below, registrationAuthorityField and registrationAuthorityCodeField are returned in the search response: 
"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, when present in a search response, is required when ordering a company profile, Lite profile, or performing a filing search. If the registrationAuthorityCodeField is not present in a search response, it is not required — the codeField alone is sufficient to identify the company.

​
Example profile request with RegAuth

curl --location 'https://rest.kyckr.com/core/company/profile/DE/VR 1464?RegAuth=Gütersloh' \
--header 'Authorization: {{apiKey}}'
Kyckr passes search queries directly through to the underlying company register and returns the results as-is. There is no additional matching layer applied on top. As a result, the quality and flexibility of search results depends entirely on the technical capability of each registry — some support partial and fuzzy matching, while others are more rudimentary. This means search behaviour will vary across jurisdictions. A query that returns strong results in one country may return nothing in another, not because the company doesn’t exist, but because the registry enforces stricter matching rules. To maximise the likelihood of a successful result:
  • Search by registration number when possible. Number-based searches are exact lookups and are not affected by registry matching quality. They are always the most reliable approach when you have the number available.
  • Retry without legal suffixes, if a name search fails. Terms such as “Limited”, “Ltd”, “GmbH”, “Inc”, or “Pty” are handled inconsistently across registries. Searching for the core trading name tends to produce broader results.

​
Next steps

Once you have a codeField from a search result, you’re ready to retrieve company data.

Lite Profile

Fast company verification — status, registered address, and legal form.

Enhanced Profile

Full company profile including directors, shareholders, and filing history.

Filing Search

Order official registry documents and extracts.

Supported Jurisdictions

Full list of supported countries and ISO codes.

​
API reference

Search for Companies

GET core/company/search — full parameter reference and response schema.