Companies House

Overview

This node integrates with the UK Companies House API to retrieve various types of company information. Specifically, the "Get Officers" operation fetches a list of officers (directors and secretaries) associated with a given company by its name or registration number. It optionally allows filtering to return only currently active officers.

Common scenarios where this node is useful include:

• Verifying the current leadership of a company for due diligence.
• Extracting officer data for compliance or reporting purposes.
• Monitoring changes in company officers over time.

For example, you could input a company's registration number and retrieve all active directors to ensure your records are up to date.

Properties

Output

The output is a JSON object representing the response from the Companies House API for the officers endpoint. It typically includes an array of officer objects with details such as names, roles, appointment dates, and status.

If the "Filter Active Officers Only" property is enabled, the output will contain only officers currently active.

No binary data is produced by this operation.

Example output structure snippet:

{
  "items": [
    {
      "name": "John Doe",
      "officer_role": "director",
      "appointed_on": "2015-06-01",
      "resigned_on": null,
      "date_of_birth": { "month": 1, "year": 1970 },
      "address": { ... },
      "nationality": "British",
      "occupation": "Director"
    }
    // more officers...
  ],
  "etag": "...",
  "kind": "officers#list"
}

Dependencies

• Requires an API key credential for the UK Companies House API.
• The node uses HTTP GET requests authenticated via this credential.
• No additional environment variables are needed beyond the configured API authentication.

Troubleshooting

• Invalid Company Number or Name: If the input company identifier is incorrect or does not exist, the API may return a 404 error. Verify the company number or name is accurate.
• API Rate Limits: The Companies House API enforces rate limits. Excessive requests may result in throttling errors. Implement retries or delays if necessary.
• Authentication Errors: Ensure the API key credential is valid and has appropriate permissions.
• Empty Officer List: If no officers are returned, confirm the company has registered officers or try disabling the "Filter Active Officers Only" option to see all officers.
• Unknown Operation Error: This occurs if an unsupported operation value is set. Use only the documented operations.

Links and References

• UK Companies House API Documentation
• Companies House Officers Endpoint