---
title: "Search for companies"
method: GET
path: "/companies"
tags: ["Companies"]
---

# Search for companies

`GET /companies`

Search companies using company name or registration number. You must provide one of `name` or `companyNumber`.

With an `isoCode`, a search will be performed directly at the registry for that jurisdiction.

Without an `isoCode`, Kyckr will perform a global search across all jurisdictions. It is important to remember that the Global Search uses stored data. Once you have found the correct jurisdiction, you should then use Kyckr's search by Name or Number API with the specific jurisdiction to confirm that the entity is still active on the register.

## Query parameters

- `isoCode` string
- `name` string
- `companyNumber` string

## Response `200`

OK

- object
  - `orderId` number — The related orderId.
  - `correlationId` string — The related correlationId to this request, for support purposes.
  - `customerReference` string — A customer provided reference, which appears in the order list.
  - `timeStamp` string, date-time — The UTC time at which the request occurred.
  - `details` string — The response status details for the current request.
  - `cost` Cost — Cost of an item
    - `type` 'credit' | 'lite'
    - `value` number
  - `links` object
    - `self` string, uri-reference
  - `data` SearchResult[]
    - `id` string — The KyckrId of the company representing a unique identifier for ordering profiles and documents.
    - `companyName` string — The name of the company.
    - `englishName` string — In some jurisdictions, an englishName is additionally provided for the company name.
    - `companyNumber` string — An identifier representing the company.
    - `address` string — The address of the company
    - `status` string — The status of the company, for example whether or not the company is currently active.
    - `type` string — The type of company, e.g. "LTD". Allowed values will vary by jurisdiction.
    - `startDate` string, date — The start date of the company.
    - `links` object
      - `self` string, uri-reference
    - `registrationAuthority` string — The Registration Authority Code is a unique identifier provided by some registries to specify the registration authority responsible for maintaining the company's records.
    - `otherIdentifiers` Identifier[] — Additional identifiers with their standardized type codes
      - `value` string — The identifier value
      - `type` string — The standardized type code for this identifier
    - `registrationType` string — If present, indicates that the original foundational legal entity registration is at another register (the source register).
    - `registrationTypeDetails` object — Additional details in relation to the registration type, if registrationType is set.
      - `originalCode` string — Non standard code for the source registry.
      - `originalDescription` string — Description text for the source registry.
      - `normalizedCode` string — ISO code for the country, province or state of the source registry.
      - `normalizedDescription` string — Country and state description of the foreign registry.
    - `isPreviousName` boolean — Returns whether the search result corresponds to a previous name of the company. Only relevant for name searches.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too many requests

---

[API](https://skmtc.net/kyckr/apis/kyckr-companies-v2-api.md) · [All operations](https://skmtc.net/kyckr/apis/kyckr-companies-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyckr/kyckr-companies-v2-api/revisions/ed17e149d3c8/schema)