n8n
Company data in workflows, without code.
With the n8n node, you pull company data into your workflows without code. The node is verified by n8n and calls the same API as your own software.
Install the node
You install verified nodes straight from the editor. Only the owner or an admin of the n8n instance can do this; after that, all members can use the node.
- Open a workflow and click “+” to open the nodes panel.
- Search for “handelsregister.ai” and pick the node with the verified badge.
- Click “Install”.
- Create a “Handelsregister.ai API” credential and enter your API key. Alternatively, use a bearer token.
In a self-hosted instance, you can also install the node under Settings › Community Nodes with the package name @handelsregister/n8n-nodes-handelsregister-ai.
Operations
The node offers the API endpoints as operations. The credits are the same as in the API.
| Operation | What it does | Credits |
|---|---|---|
| Fetch Organization | Company profile with selectable features, AI Mode and Realtime. | 5 + features |
| Search Organizations | Search companies by name and filters. “Return All” pages through all results, “Maximum Results” caps the number. | 1 per page |
| Fetch Person | Person profile, from Plus. | 15 |
| Fetch Document | A document from the register. The file then sits in the binary property “data”. | 15 |
| List Signals | Signals by topic, company and period, page by page. | 20 per page |
| Get Signal | A single signal. | 20 |
| Get Signal Catalog | The Signals topics. | free |
For read requests, the node retries network errors, 408, 429 and server errors up to three times. With “Continue On Fail”, the workflow keeps running, and the result contains the status, the error code and meta.
Example workflow
This workflow builds a list of all active GmbHs in a postal code area, each with its management.
- Start with a trigger, for example “Manual Trigger” to try it out or “Schedule Trigger” for a fixed schedule.
- Add the handelsregister.ai node with the “Search Organizations” operation. In the filters, set the postal code, the legal form GmbH and the status active.
- Set “Output” to one item per company. Turn on “Return All” and cap the number with “Maximum Results”. That way you know in advance how many company profiles follow.
- Add a second handelsregister.ai node with “Fetch Organization”. Enter the expression
{{ $json.entity_id }}inqand select the Related Persons feature, the management. - Write the result to your destination, for example a spreadsheet or your CRM.