What is the Companies House - Lookup Former Names action?
The integration looks up company information in the UK Government Companies House database. The lookup uses a Companies House API to search by company number.
Please note that this is a premium feature which needs to be enabled by your dedicated Customer Success Manager. For further information, please reach out to your BRYTER Customer Success Manager or firstname.lastname@example.org. Additional pricing may apply.
Why would you use the Companies House - Lookup Former Names action?
Law firms review large numbers of contracts or leases in transactions and produce reports that summarize key terms and flag risks. Lawyers will create a calendar event to set aside a dedicated time and remind them to review these reports and documentation. Automating this flow removes the burden of switching applications
How do you use the Companies House - Lookup Former Names action?
This integration node requires the Company Number as input values for each Company that should be looked up. Reference the value from a URL parameter, text block value or a text input node. Consider applying Regular Expressions to ensure the correct formatting of the Company Number.
To ensure that the output values are well presented, we suggest configuring the result either with conditional blocks in input nodes or transitions. The boolean output of the output valie 'EmptyResult' can be used to set up the conditions correctly.
Existing former names for existing company
If the company can be found, the integration returns 'Empty Result = false'. In this case, you need to verify whether the any former names exist based on what the integration returns in Previous Names. This requires a so-called regex condition:
To see if the field 'Previous company names' in Companies House actually contains names, the condition has to return any value from the integration. With the regex condition, you can check if the Companies House field is not empty. An easier way would be to set a condition Previous Names = blank.
No existing former names for existing company
If the company can be found, the integration returns 'Empty Result = false' but the company does not have any recorded former names. Consider informing your end-user with a conditional block that the company exists but 'No former names have been found'.
Your condition thus need to check if the company exists and if the field in Companies House does not exist or is left blank.
Company could not be found
If the company number cannot be found, the integration returns 'Empty Result = true'. Set up a conditional block or a transition with the condition EmptyResult = true and inform the end-user that the company cannot be found:
Input and output parameters
|company_number||Text||A Company Number such as 12068669|
|Empty Result||Boolean||Whether or not a result has been found, true or false|
|Previous Names||Text||The result of the search, e.g. PREVIOUS NAME, ANOTHER PREVIOUS NAME|