Configuring Companies House
Companies House is a data provider you can use to run these checks:
Company data check
Company filing retrieval
Company data check
How it works
This is the default behavior for a variant of the Company data check with Companies House as the data provider.
The check is performed by sending the company's name, country of incorporation, and company number to Companies House and requesting a report.
The check passes when all of the following are true:
The company name is found in the registry.
The company status in the registry is active.
The company number and country of incorporation from the profile match the data in the registry.
At least one Person of Significant Control (PSC) is found.
When the check passes, the basic company information is imported into the check results. The information is displayed differently for the Identify officers task, the Identify shareholders task, and the Verify company details task. See the description of the Company data check for more information.
Note
Only PSCs are imported into the Identify shareholders task.
If a PSC has more than one nationality listed in Companies House, only the first nationality is imported to the profile.
The check returns a partial match when the company name is found in the registry but one of the following is true:
Any of the required profile data is missing.
Any of the profile data does not match.
The company status is inactive.
The company status is unknown.
No PSCs are found.
See Profile fields to learn which profile fields are required.
If the company name cannot be found, the check fails.
An error is returned if either of the following is true:
Companies House discovers more than one company that matches the profile details.
The company's country of incorporation is outside the UK.
When you search for a company during the profile creation process, the search results are retrieved using the Company data check, if you have one set up. If you don't have a Company data check set up, the Company registry check can be used instead.
Configuration options
You can use the following optional configuration:
Ignore resigned directors: When this option is selected, any officers who are resigned are not imported into the check results.
This check is used on the Identify officers task, which includes configuration options to control how the officers returned by Companies House are verified. Learn more about Task configuration options.
What we'll need
Let us know that you’d like to run this check with Companies House and which configuration options you'd like to use. We’ll set it up for you.
Testing your configuration
Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.
Is company information returned from Companies House?
Create any company profile and run the check variant. If the check passes and data for Passfort Ltd is displayed in the check results, the check variant is working as expected.
Is a partial match returned when the company name is found in the Companies House registry, but the profile data does not match?
Create a company profile with "partial" in the name and run the check variant. If the check returns a partial match and, on the Verify company details task, an incorrect company name for Passfort Ltd is displayed in the results, the check variant is working as expected.
Test words are not case-sensitive.
Profile fields
These are the profile details searched in the Companies House registry:
Name | Description |
Country of incorporation ( *Required | The country in which the company is incorporated. |
Company name ( *Required If not included, a partial match is returned | The legal name of the company. |
Company number ( Required | The company’s registration number. |
Company filings retrieval
How it works
This is the default behavior for a variant of the Company filings retrieval check with Companies House as the data provider.
The check is performed by searching the company’s country of incorporation and registration number in the Companies House registry.
The check passes when any documents are found in the registry.
When the check passes:
The names of the documents are displayed in the check results.
If the following information is available, it’s also displayed in the check results: filing date, filing type, description, and source.
The documents are imported so you can see them.
If the company’s country of incorporation is anything other than the UK, an error is displayed.
The maximum number of documents that can be returned in the check results is 100. If there are more, only the 100 most recent documents are returned.
Configuration options
There are no additional configuration options for the Company filings retrieval check variant with Companies House.
What we’ll need
Let us know that you’d like to add a variant of the Company filings retrieval check with Companies House and we’ll set it up.
Testing your configuration
Once the check variant is configured, follow these steps in your demo environment to test whether it's working as expected.
Are company filings returned from Companies House?
Create a profile for a company incorporated in the UK and run the check variant. If the check passes and real filings from Companies House are displayed in the check results, the check variant is working as expected.
In the live environment, an error is displayed when the check variant is run on a profile with a country of address that isn't the UK. This error is not displayed in the demo environment. The data displayed in the check results is real data from Companies House, even in the demo environment.
Profile fields
These are the company’s profile details searched in Companies House:
Name | Description |
Country of incorporation ( *Required | The country in which the company is incorporated. |
Company number ( *Required | The company’s registration number. |