🏛️ German Company KYB, Handelsregister & Insolvency Deep-Scraper

An automated, ultra-fast B2B KYB (Know Your Business) & Compliance Scraper for the German market. Supports both single-company deep verification and high-volume bulk batch processing.

In a single autonomous run, this Actor queries:

1. The Official German Commercial Register (handelsregister.de): Extracts company legal form, registration number (HRB / HRA / GnR / PR / VR), competent district court (Amtsgericht), status (aktuell / gelöscht), registered business address, subscribed share capital (Stammkapital / Grundkapital), business purpose (Unternehmensgegenstand), and the current Managing Directors (Geschäftsführer), Board Members (Vorstand), and Signatories (Prokuristen) directly from structured register XML (SI - Strukturierter Registerinhalt).
2. The Official German Insolvency Registry (insolvenzbekanntmachungen.de): Checks whether any active or historical bankruptcy/insolvency proceedings exist for the company or debtor, retrieving court file numbers (Aktenzeichen) and court decree texts.
3. Automated Risk Assessment: Computes an instant risk signal (CLEAR, WARNING_INSOLVENCY_FOUND, or NOT_FOUND_IN_REGISTER).

---

🎥 48-Second Live Video Showcase (1080p HD)

Part of the official German B2B Data Suite: Automate B2B lead generation, GDPR-compliant impressum enrichment (§ 5 DDG), real-time Handelsregister (XJustiz) & insolvency KYB audits, ZVG foreclosures, and public tenders via Apify, n8n, Make.com, or AI Agents (MCP).

---

⚡ Why Use This Actor?

• Zero-Browser Sub-Second Execution: Built with an advanced async JSF & Jakarta Faces protocol engine (httpx + lxml). No heavy Chromium/Playwright container overhead—starts in < 1 second and consumes minimal RAM.
• Bulk / Batch Processing: Verify 10s or 100s of German companies in a single run with built-in rate-limiting protection (request_delay_seconds).
• Deep Officer & Signatory Intelligence: Retrieves not just names, but full names, birth dates, residential locations, exact corporate roles (Geschäftsführer, Vorstand, Prokurist), and specific representation authorities (Einzelvertretung, Gesamtprokura).
• Official XJustiz 3.5.1 XML Extraction: Automatically requests and decodes the structured register content (Strukturierter Registerinhalt - SI) provided by German judicial authorities.
• Built-in Insolvency Screening: Cross-references insolvency publications in real time to catch financially distressed or bankrupt counterparties early.
• Fair Pay-Per-Event Pricing: You only pay when a company check successfully delivers data ($0.025 per verified company). Failed searches or invalid inputs are never billed.

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
company_name	String	No*	"BioNTech SE"	Legal or trade name of a single German entity (*provide either company_name or companies).
companies	Array	No*	null	Batch list of German companies to check in bulk (supports strings, pipe-separated values, or JSON objects).
city	String	No	null	Corporate seat / city to filter results (e.g. "Mainz", "München").
register_number	String	No	null	Commercial registration number (e.g. "HRB 48720" or "48720").
register_type	String	No	"ALL"	Register type: "ALL", "HRB", "HRA", "GnR", "PR", "VR".
include_insolvency_check	Boolean	No	true	Queries insolvenzbekanntmachungen.de for debtor notices.
include_financial_details	Boolean	No	true	Downloads and parses official XJustiz SI/UT data for capital and officers.
request_delay_seconds	Integer	No	1	Polite delay between sequential company checks in seconds (0 to 10).
proxyConfiguration	Object	No	null	Apify proxy settings (recommended for large batch runs).

---

Single Company Check Example

{
  "company_name": "BioNTech SE",
  "city": "Mainz",
  "include_insolvency_check": true,
  "include_financial_details": true
}

---

Bulk / Batch Processing (Verify 100s of Companies per Run)

You can pass a list of companies to verify in batch using the companies parameter:

1. Pipe-separated syntax (Name | City | Optional Register Number):

{
  "companies": [
    "BioNTech SE | Mainz | HRB 48720",
    "Siemens AG | München",
    "SAP SE | Walldorf"
  ],
  "include_financial_details": true,
  "include_insolvency_check": true,
  "request_delay_seconds": 1
}

2. Structured JSON Object syntax:

{
  "companies": [
    { "company_name": "BioNTech SE", "city": "Mainz" },
    { "company_name": "Siemens AG", "city": "München" }
  ],
  "include_financial_details": true,
  "include_insolvency_check": true
}

---

📤 Output Format

The Actor pushes structured verification records to the Apify Dataset and persists raw XJustiz XML and the overall summary in the Key-Value Store:

{
  "company_name": "BioNTech SE",
  "kyb_risk_status": "CLEAR",
  "register_court": "Amtsgericht Mainz",
  "register_type": "HRB",
  "register_number": "48720",
  "legal_form": "Europäische Aktiengesellschaft (SE)",
  "status": "aktuell",
  "seat": "Mainz",
  "address": "An der Goldgrube 12, 55131 Mainz",
  "share_capital": 259027487.0,
  "currency": "EUR",
  "business_purpose": "Die Erforschung und Entwicklung, die Herstellung und die Vermarktung von immunologischen und von RNA-basierten Arzneimitteln...",
  "officers_count": 11,
  "officers": [
    {
      "first_name": "Ugur",
      "last_name": "Sahin",
      "full_name": "Ugur Sahin",
      "role": "Vorstand",
      "city": "Mainz",
      "birth_date": "1965-09-19",
      "representation_authority": "Ist nur ein Vorstandsmitglied bestellt, so vertritt dieses alleine die Gesellschaft..."
    },
    {
      "first_name": "Özlem",
      "last_name": "Türeci",
      "full_name": "Özlem Türeci",
      "role": "Vorstand",
      "city": "Mainz",
      "birth_date": "1967-03-06",
      "representation_authority": "Ist nur ein Vorstandsmitglied bestellt, so vertritt dieses alleine die Gesellschaft..."
    }
  ],
  "has_insolvency_record": false,
  "insolvency_cases_count": 0,
  "scraped_at": "2026-10-27T12:30:00Z"
}

---

🔄 Integrations & Workflows

1. Make.com / n8n Automation

Trigger this Actor during new customer onboarding (CRM, ERP, Stripe, or billing system) to verify VAT eligibility, signatory powers, and bankruptcy risk before signing contracts.

2. AI Agents & Model Context Protocol (MCP)

Equip your autonomous agents with official German legal entity grounding:

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("agrunert/german-company-kyb-insolvency-scraper").call(run_input={
    "companies": [
        "BioNTech SE | Mainz",
        "Siemens AG | München"
    ]
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Company: {item['company_name']}, Risk: {item['kyb_risk_status']}, Capital: {item.get('share_capital')}")

---

🤖 Plug-and-Play: AI Agents (MCP), n8n & Make.com

Our actors are built natively for the next generation of automation: seamless integration into Claude Desktop, Cursor AI, AI Agent Frameworks (LangChain, AutoGen, CrewAI), and visual workflow builders like n8n and Make.com.

1. AI Agents & Model Context Protocol (MCP)

Give your AI coding assistant or desktop agent real-time access to this actor using the official Apify MCP server.

Option A: Single-Actor MCP Setup (claude_desktop_config.json / Cursor)

Add this to your %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "apify-kyb": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--actors", "AGrunert/german-company-kyb-insolvency-scraper"],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

💡 Pro Tip – Equip your AI Agent with our Complete German B2B & Compliance Suite:
Pass all 6 specialized DACH actors in a single command so your agent can discover B2B leads, extract Impressum data, verify commercial register & insolvency records, search tenders, monitor real estate foreclosures, and issue tax-compliant e-invoices autonomously:

$npx -y @apify/actors-mcp-server --actors AGrunert/german-b2b-leads-directory-scraper,AGrunert/german-impressum-b2b-lead-enricher,AGrunert/german-company-kyb-insolvency-scraper,AGrunert/german-public-tenders-vergabe-scraper,AGrunert/german-real-estate-foreclosure-zvg-scraper,AGrunert/german-e-invoice-zugferd-xrechnung-suite

Hosted SSE Endpoint (for Cursor / remote agents):
https://mcp.apify.com?actors=AGrunert/german-company-kyb-insolvency-scraper&token=YOUR_APIFY_TOKEN

---

2. 1-Click Synchronous API (cURL, n8n, Make.com)

No async job polling required! Call our synchronous endpoint directly in a single HTTP request node to run the actor and receive clean parsed dataset items immediately:

curl -X POST "https://api.apify.com/v2/acts/AGrunert~german-company-kyb-insolvency-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"company_name":"BioNTech SE","city":"Mainz","register_number":"HRB 48720","include_insolvency_check":true,"include_financial_details":true}'

---

3. Schlüsselfertige Workflow-Vorlagen im Repository (integrations/)

In our GitHub repository and Actor build package, you will find pre-built, production-tested templates in the integrations/ folder:

• integrations/n8n_workflow.json: Ready-to-import n8n workflow for automated commercial register verification, managing director extraction, and instant insolvency screening. Just copy-paste the JSON into your n8n canvas.
• integrations/make_com_blueprint.json: Official Make.com scenario blueprint with pre-configured HTTP request & data mapping.
• integrations/mcp_claude_cursor_config.json: Pre-configured MCP server manifest for Claude Desktop, Cursor AI, and Windsurf.

---

🔗 Complete German B2B, Compliance & PropTech Suite by AGrunert

Combine our specialized German business actors to build end-to-end automated pipelines for B2B lead generation, corporate due diligence, public procurement, real estate intelligence, and tax-compliant e-invoicing:

Actor	Category & Pricing	Key Capabilities	Preconfigured Public Tasks
German B2B Leads, Crafts & Business Directory Scraper	Lead Generation $0.008 / lead ($8.00 / 1k)	Multi-query round-robin extraction across German business directories (11880, Gelbe Seiten), verified E.164 phone numbers (97.5% coverage), and domain verification (require_website: true).	• German Crafts, Solar & Construction Lead Finder • German B2B Company & Domain Finder
German & DACH B2B Impressum, Contact & Legal Enricher (§ 5 DDG)	Data Enrichment $0.005 / domain ($5.00 / 1k)	Automatic legal notice discovery (§ 5 DDG / § 25 MedienG), de-obfuscation of executive emails, management board/CEOs, court & registration number (HRB), VAT ID (DE...), and social profiles.	• German B2B Impressum, CEO & Contact Extractor • DACH Website to Handelsregister & VAT ID Enricher
German Company KYB, Handelsregister & Insolvency Scraper (Current Actor)	Risk & Compliance $0.025 / check ($25.00 / 1k)	Official XJustiz 3.5.1 extraction (directors, share capital, business purpose, court) + live insolvency check (insolvenzbekanntmachungen.de) with bulk company list support.	• Complete German KYB Audit • Fast German Insolvency Screener • Bulk German Company KYB Batch Check
German Public Tenders & Procurement Scraper (service.bund.de)	B2B Tenders & Contracts $0.010 / tender ($10.00 / 1k)	Daily procurement monitoring across Bund, Länder & Kommunen; zero false positives (filters AI Bietercockpit boilerplates); direct /unterlagen/ download URLs and submission deadlines (date + time).	• German IT, Software & AI Public Tenders Monitor • German Construction & Facility Management Tenders
German Real Estate Foreclosure & ZVG-Portal Scraper	PropTech & Real Estate $0.010 / property ($10.00 / 1k)	Bulk extraction of foreclosure auctions (zvg-portal.de) across all 16 states, multi-parcel market value parser (float), and direct PDF appraisal links (Verkehrswertgutachten).	• German Foreclosure Real Estate Finder • High-Value German Foreclosures (> 250k EUR)
German E-Invoice (ZUGFeRD / Factur-X / XRechnung 3.0) Suite	Finance & Invoicing $0.035 / invoice ($35.00 / 1k)	Generate DIN-5008 compliant PDF/A-3 invoices from JSON, embed CII XML, and validate with official KoSIT Schematron & EN 16931 rules.	Standalone API & Batch Suite

💡 Multi-Actor Chain Workflows & Synergy Pipelines

• Pipeline 1 (Top-of-Funnel Lead-to-Audit Engine):
  Discover companies & crafts via German B2B Directory Scraper $\rightarrow$ Enrich managing directors, direct emails, and HRB numbers via German Impressum Enricher $\rightarrow$ Verify solvency, officers, and share capital via German KYB Scraper.
• Pipeline 2 (Public Tender Win to Compliant Billing):
  Monitor federal procurement opportunities via German Public Tenders Scraper $\rightarrow$ Win bid $\rightarrow$ Bill public authorities with compliant EN 16931 XRechnung 3.0 via German E-Invoice Suite.
• Pipeline 3 (Real Estate Foreclosure Due Diligence):
  Scrape upcoming foreclosures via German Real Estate Foreclosure Scraper $\rightarrow$ Check creditor/owner companies via German KYB Scraper.

---

⚖️ Compliance & Data Quality

• Data is sourced live and directly from official federal and state portals of the Federal Republic of Germany.
• Adheres to the German Handelsregister API conventions and rate-limiting recommendations.