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 id returned by a successful search. There are two ways to search, both served by the same endpoint.
Search modeWhen to useRequired parameters
Jurisdiction searchYou know the company’s country — 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. Provide either a company name or registration number alongside the two-letter ISO country code for the jurisdiction. The same endpoint handles 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://api.kyckr.com/v2/companies?isocode=GB&name=Kyckr' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Search by registration number

curl --request GET \
  --url 'https://api.kyckr.com/v2/companies?isocode=GB&companyNumber=11655290' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Example response

{
    "correlationId": "019cdd97-ac7b-719c-97e2-e7cff9c18769",
    "cost": {
        "type": "credit",
        "value": 0
    },
    "timeStamp": "2026-03-11T15:50:32.031275Z",
    "details": "Success",
    "data": [
        {
            "id": "GB|MTE2NTUyOTA",
            "companyName": "KYCKR UK LIMITED",
            "companyNumber": "11655290",
            "address": "Kemp House, 160 City Road, London, United Kingdom, EC1V 2NX",
            "status": "Active",
            "type": "Private limited company",
            "startDate": "2018-11-01",
            "registrationAuthority": "Companies House, United Kingdom"
        }
    ]
}
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://api.kyckr.com/v2/companies?name=Kyckr' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Example response

{
  "correlationId": "976a3da3b7fa4a229958ddd61c8f349f",
  "timeStamp": "2025-01-15T08:10:30.5431146Z",
  "details": "Success",
  "data": {
    "totalCount": 4,
    "totalPages": 1,
    "pageNumber": 1,
    "pageSize": 50,
    "companies": [
      {
        "id": "AU|NjA5MzIzMjU3",
        "companyName": "KYCKR PTY LIMITED",
        "companyNumber": "609323257",
        "address": "MASCOT, New South Wales, 2020",
        "status": "Registered",
        "type": "Australian Proprietary Company, Limited By Shares",
        "startDate": "2015-11-16"
      },
      {
        "id": "IE|NDM2MDI0",
        "companyName": "KYCKR IRELAND LIMITED",
        "companyNumber": "436024",
        "address": "ARC LABS RESEARCH CENTER, WIT WEST CAMPUS, CARRIGANORE WATERFORD, CO WATERFORD, WATERFORD, IRELAND",
        "status": "Normal",
        "type": "LTD - Private Company Limited by Shares",
        "startDate": "2007-03-08"
      },
      {
        "id": "GB|MTE2NTUyOTA",
        "companyName": "KYCKR UK LIMITED",
        "companyNumber": "11655290",
        "address": "Kemp House, 160 City Road, London, EC1V 2NX",
        "status": "Active",
        "type": "Private Limited Company",
        "startDate": "2018-11-01"
      },
      {
        "id": "US-OR|ODc4ODc3OTE",
        "companyName": "KYCKR, LLC",
        "companyNumber": "87887791",
        "status": "Inactive",
        "type": "DOMESTIC LIMITED LIABILITY COMPANY",
        "startDate": "2012-08-29"
      }
    ]
  }
}
The id field prefix identifies the jurisdiction — GB for United Kingdom, AU for Australia, US-OR for Oregon, and so on. Use this to run a jurisdiction search as your next step.

​
Key response fields

These fields are consistent across both search modes.
FieldDescription
idUnique Kyckr identifier for this company. Required for all subsequent API calls — Lite Profile, Enhanced Profile, Filing Search.
companyNameThe company’s registered legal name.
companyNumberThe registration number on the company register.
statusCurrent legal status as reported by the registry (e.g. active, inactive, Registered).
typeLegal form of the company (e.g. ltd, Private Limited Company).
startDateDate the company was registered.
addressRegistered address as held on the registry.
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 an id 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 /v2/companies — full parameter reference and response schema.