> ## 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.
# Search for a Company
> Find a company and retrieve the identifier needed for profiles, filings, and ownership discovery.
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 mode | When to use | Required parameters |
| ------------------------------ | ---------------------------------------------------------------------------- | ------------------------------------- |
| **Jurisdiction name search** | You know the company's country and name — use this by default | `isocode` + `name` or `companyNumber` |
| **Jurisdiction number search** | You know the company's country and registration number — use this by default | `isocode` + `name` or `companyNumber` |
| **Global search** | You don't know the country and cannot determine it | `name` 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.
***
## Jurisdiction search
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](/company-v1/guides/jurisdictions).
## Search by name
```bash theme={null}
curl --request GET \
--url 'https://rest.kyckr.com/core/company/search/GB/Kyckr' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
### Example response
```json theme={null}
{
"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
```bash theme={null}
curl --request GET \
--url 'https://rest.kyckr.com/core/company/number-search/GB/11655290' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
### Example response
```json theme={null}
{
"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:
| Field | Purpose |
| ------------------ | ------------------------------------------------------------------------------------------------- |
| `codeField` | Unique code for an entity — used for ordering a company profile or retrieving registry documents. |
| `legalStatusField` | Confirms if the company is active or inactive. |
| `nameField` | The full name of the company on the register. |
## Global search
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.
```bash theme={null}
curl --request GET \
--url 'https://rest.kyckr.com/core/company/cache-search/kyckr' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
### Example response
```json theme={null}
{
"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:
```json theme={null}
"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 theme={null}
curl --location 'https://rest.kyckr.com/core/company/profile/DE/VR 1464?RegAuth=Gütersloh' \
--header 'Authorization: {{apiKey}}'
```
## Search matching and fuzzy search
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.
Fast company verification — status, registered address, and legal form.
Full company profile including directors, shareholders, and filing history.
Order official registry documents and extracts.
Full list of supported countries and ISO codes.
***
## API reference
`GET core/company/search` — full parameter reference and response schema.
***