handelsregister.ai

Interact with handelsregister.ai API to query German business registry data

Actions3

Overview

This node interacts with the handelsregister.ai API to fetch detailed information about German companies. It supports operations such as fetching comprehensive organization details, searching organizations with filters, and downloading official PDF documents from the German business registry. It is useful for users needing detailed business registry data, financial KPIs, balance sheets, related persons, news, and official publications about German companies.

Use Case Examples

  1. Fetch detailed company information by providing a company name or registration number, optionally including additional data features like financial KPIs or news articles.
  2. Search for German companies using a query string with optional filters like postal code and pagination controls.
  3. Download official PDF documents such as shareholders lists or data extracts for a specific company using its unique ID.

Properties

Name Meaning
Query Company name, registration number, or search query used to fetch or search organizations.
Features Additional data features to include in the fetch organization operation, such as financial KPIs, balance sheet accounts, related persons, news, and publications.
AI Mode Enable AI-powered search for better results in the fetch organization operation.

Output

Binary

PDF documents downloaded from the German business registry, such as shareholders lists or data extracts.

JSON

  • company_id - Unique company entity ID from search results or fetch operations.
  • document_type - Type of document downloaded (e.g., shareholders list, current extract).
  • _meta
    • total - Total number of search results returned.
    • request_credit_cost - Credit cost of the API request.
    • credits_remaining - Remaining credits available in the API account.

Dependencies

  • handelsregister.ai API key credential

Troubleshooting

  • Common issues include invalid or missing API key credentials, resulting in authentication errors.
  • Incorrect or incomplete query parameters may cause empty or no results to be returned.
  • Requests for documents require a valid company ID and document type; missing or incorrect values will cause errors.
  • API credit limits may restrict access to certain features or data; users should monitor their credit usage.

Links

Discussion