> ## 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 `id` returned by a successful search. There are two ways to search, both served by the same endpoint.
| Search mode | When to use | Required parameters |
| ----------------------- | ---------------------------------------------------- | ------------------------------------- |
| **Jurisdiction search** | You know the company's country — 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.
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](/company-v2/guides/jurisdictions).
### Search by name
```bash theme={null}
curl --request GET \
--url 'https://api.kyckr.com/v2/companies?isocode=GB&name=Kyckr' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
### Search by registration number
```bash theme={null}
curl --request GET \
--url 'https://api.kyckr.com/v2/companies?isocode=GB&companyNumber=11655290' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
### Example response
```json theme={null}
{
"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"
}
]
}
```
***
## 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://api.kyckr.com/v2/companies?name=Kyckr' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
### Example response
```json theme={null}
{
"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.
| Field | Description |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `id` | Unique Kyckr identifier for this company. Required for all subsequent API calls — Lite Profile, Enhanced Profile, Filing Search. |
| `companyName` | The company's registered legal name. |
| `companyNumber` | The registration number on the company register. |
| `status` | Current legal status as reported by the registry (e.g. `active`, `inactive`, `Registered`). |
| `type` | Legal form of the company (e.g. `ltd`, `Private Limited Company`). |
| `startDate` | Date the company was registered. |
| `address` | Registered address as held on the registry. |
***
## 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 an `id` 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 /v2/companies` — full parameter reference and response schema.