# Search companies

The ability to search for a company by company name or company number.

Results can be filtered by status (Active, In distress, Closed).

Results are ordered by matching relevance.

Endpoint: GET /company/search
Version: 2.0.0
Security: ApiKeyAuth

## Query parameters:

  - `searchText` (string)
    Company name or number. Not case-sensitive.
You can provide either a company name or a company number here.

  - `status` (string)
    company status one of Active, In distress, Closed.
    Enum: "Active", "In distress", "Closed"

## Response 200 fields (application/json):

  - `idCompany` (integer, required)

  - `profileLink` (string, required)

  - `name` (string, required)

  - `number` (string, required)

  - `incorporatedDate` (string,null)

  - `companyStatus` (string, required)

  - `registerStatus` (string, required)

  - `registeredAddress` (object)

  - `registeredAddress.line1` (string,null)

  - `registeredAddress.line2` (string,null)

  - `registeredAddress.line3` (string,null)

  - `registeredAddress.line4` (string,null)

  - `registeredAddress.town` (string,null)

  - `registeredAddress.postcode` (string,null)

  - `historicalNames` (array)

  - `historicalNames.fromDate` (string, required)

  - `historicalNames.toDate` (string, required)

  - `score` (number, required)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)