Actions6
Overview
This node integrates with the UK Companies House API to retrieve various types of company information. It supports multiple operations such as searching companies by name, fetching detailed company profiles, retrieving filing histories, listing officers, getting persons with significant control, and obtaining registered office addresses.
Common scenarios where this node is beneficial include:
- Verifying company details during due diligence.
- Monitoring company filings and changes for compliance or competitive intelligence.
- Extracting officer or control information for risk assessment.
- Searching for companies based on partial or full names.
For example, a user can search for companies matching "Acme" and then fetch detailed profiles or filing histories for selected companies.
Properties
| Name | Meaning |
|---|---|
| Company Name or Number | Company name (for search) or registration number (for other operations). |
The node also supports an Operation property (fixed to "Search Companies" here) that defines the action performed.
Output
The output is a JSON object containing the response from the Companies House API corresponding to the search query. Specifically for the "Search Companies" operation, the output includes:
- A list of companies matching the search term, typically including company names, numbers, status, and other metadata as returned by the API.
The output structure directly reflects the API's search results JSON schema.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for the UK Companies House API.
- The node uses HTTP GET requests authenticated via this API key.
- No additional external dependencies are needed beyond the configured API authentication.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication errors.
- Providing an empty or invalid company name string may return no results or API errors.
- Network connectivity problems can cause request failures.
Error messages:
"Unknown operation": This indicates an unsupported operation was requested; ensure the operation parameter is set to "search".- HTTP error codes from the API (e.g., 401 Unauthorized, 404 Not Found) indicate authentication or resource issues.
Resolutions:
- Verify the API key credential is correctly configured and active.
- Ensure the company input string is valid and non-empty.
- Check network access to the Companies House API endpoint.