---
title: "Searches for a company based on its Company Number and returns its details."
method: POST
path: "/api/companies"
tags: ["Companies"]
---

# Searches for a company based on its Company Number and returns its details.

`POST /api/companies`

If a company appears multiple times within the structure, it will only be detailed in full (i.e. with significant ownership details) in its first instance. Subsequent instances will be 
            marked as duplicates.
            Whilst duplicate instances of companies can and will be identified, it is not possible to categorically identify duplicated people.

## Query parameters

- `companyNumber` string

## Headers

- `apikey` string, required

## Response `200`

Success

- CredasApiModelsCompaniesCompanyDetail
  - `id` string, uuid
  - `companyName` string
  - `companyNumber` string
  - `addressLine1` string
  - `locality` string
  - `region` string
  - `postCode` string
  - `dateOfRegistration` string, date-time
  - `duplicate` boolean
  - `significantParentCompanies` CredasApiModelsCompaniesCompanyDetail[]
  - `significantPeople` CredasApiModelsCompaniesSignificantPerson[]
    - `id` string, uuid
    - `forename` string
    - `surname` string
    - `regEntryId` string, uuid

## Other responses

- `400` — If the service was supplied invalid data.
- `401` — If credentials supplied were invalid.
- `402` — If the consumer doesn't have the required permission to use the endpoint.
- `500` — If an unexpected exception occurred whilst processing the request.

---

[API](https://skmtc.dev/credas/apis/credas-api.md) · [All operations](https://skmtc.dev/credas/apis/credas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/credas/credas-api/revisions/a8dd82736563/schema)