Search and Setup a Company Check

Created by Jonathan Mugridge, Modified on Wed, 27 May at 3:20 PM by Jonathan Mugridge

Search and Setup a Company Check

Step 1

Once you have a valid Location code, you can use the company search API to find a company on Companies House.

POST /api/v2/ci/companies/search

Request Payload

The request body must include a location value. In addition, at least one of the optional company search fields must be provided. The pageNumber field is optional and can be used to support pagination in external integrations.

{
  "location": "string",
  "companyNumber": "string",
  "companyName": "string",
  "companyPostcode": "string",
  "pageNumber": 0
}

Example Request

{
  "location": "GB",
  "companyName": "credas technologies ltd"
}

Payload Response

The API returns a result object containing a list of matching companies in the results array:

{
  "totalPages": 1,
  "totalResults": 1,
  "pageNumber": 0,
  "pageSize": 50,
  "results": [
    {
      "vatNumber": "GB264025132",
      "resultId": "GB-0-10429398",
      "companyName": "CREDAS TECHNOLOGIES LTD.",
      "companyNumber": "10429398",
      "addressLine1": "EAST TYNDALL STREET",
      "addressLine2": "CARDIFF",
      "country": "GB",
      "status": 1,
      "type": 1,
      "saved": true
    }
  ]
}

IMPORTANT:
Make a note of the resultId from the response, as this is required to perform subsequent Business and Company Checks.

Step 2

Once you have obtained a resultId from the company search response, you can create a company record in Connect and automatically retrieve a Company Check report.

POST /api/v2/ci/companies

Request Payload

The request must include a resultId. You can also optionally include a userGroupId to assign the company to a specific user group, as well as a companyNumber.

{
  "resultId": "string",
  "userGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "companyNumber": "string"
}

Example Request

If you only need to create the company without assigning it to a group, you can simply provide the resultId:

{
  "resultId": "GB-0-10429398"
}

Example Payload Response

{
  "id": 6510,
  "clientId": "24b9b010-9524-4858-8d44-0819e5468649",
  "companyName": "CREDAS TECHNOLOGIES LTD.",
  "companyNumber": "10429398",
  "addressLine1": "THE MALTINGS EAST TYNDALL STREET",
  "addressLine2": "CARDIFF",
  "postcode": "CF24 5EA",
  "locality": "SOUTH GLAMORGAN",
  "country": "GB",
  "companyStatus": 1,
  "dateAdded": "2025-09-23T08:54:20.5698444+00:00",
  "dateOfRegistration": "2016-10-14T00:00:00Z",
  "officerEntityLinks": [],
  "fullReport": {
    ...
  }
}

IMPORTANT:
Once created, the company is stored in Connect and can be referenced using the id value returned in the response.
Once a company has been added, it is not possible to run a subsequent check.

For further information on how to retrieve the company details, please click below:

Got any questions?

If you have any questions please reach out to the Credas support team by contacting us here

We are committed to continually improving our support resources for you. We would greatly appreciate your feedback on this article to help us enhance your experience.

Join our live training sessions

Whether you're new to Credas or simply looking for a refresher, we’ve got you covered! We now offer regular training sessions designed to help you get the most out of the Credas platform. These sessions are tailored to different product areas, including:

- AML / ID verification
- Right to Work
- Our brand-new Credas Lettings solution
- Admin / advanced training

In each session we will walk you through how platform works and answer any questions you may have.

See our full training schedule

Search and Setup a Company Check

Search and Setup a Company Check

Step 1

Request Payload

Example Request

Payload Response

Step 2

IMPORTANT: Once created, the company is stored in Connect and can be referenced using the id value returned in the response. Once a company has been added, it is not possible to run a subsequent check.

Got any questions?

Join our live training sessions