🇩🇪 German Corporate Insolvency Monitor (insolvenzbekanntmachungen.de)

A high-speed, lightweight data extraction engine and daily monitoring actor for official German insolvency proceedings from the centralized portal neu.insolvenzbekanntmachungen.de.

Designed specifically for B2B Credit Risk Teams, Distressed M&A Investors, Restructuring Consultants, and Commercial Law Firms who require real-time alerts on insolvency filings, preliminary proceedings, and court orders without the cost and instability of heavy headless browser scraping.

---

🚀 Key Advantages & Architecture

• Zero-Browser Architecture: Bypasses heavy Chromium/Playwright browsers. Directly handles stateful Jakarta Server Faces (JSESSIONID and jakarta.faces.ViewState) over asynchronous HTTP. Runs up to 20x faster and consumes 90% fewer Apify compute units (CUs).
• Instant Full-Text XML Retrieval: Queries the complete court ruling via lightweight JSF AJAX calls (<partial-response> ~1.5 KB). No clicking around or PDF rendering required.
• Smart B2B Company Filter (onlyCompanies): Automatically detects registered businesses by cross-referencing commercial register numbers (HRB, HRA, GnR, PR, VR) and corporate forms (GmbH, UG (haftungsbeschränkt), AG, GmbH & Co. KG, e.K.). Easily separates corporate distress from private consumer insolvencies.
• Intelligent Administrator & Sector Extraction: Parses the appointed preliminary insolvency administrator (insolvenzverwalter) including law firm address and business description (geschaeftszweig) directly from the ruling.
• Automated 1,000-Hit Limit Bypass: The official federal portal blocks all queries exceeding 1,000 results. This actor automatically detects the cap and partitions the search into granular daily and procedural slices so no filing is lost.

---

🎯 Use Cases / Anwendungsbereiche

Industry / Role	Use Case
Credit Risk & Procurement	Real-time monitoring of customer and supplier portfolios to prevent bad debt and supply chain disruptions.
Distressed M&A & Private Equity	Sourcing off-market acquisition opportunities (asset deals, restructuring, carve-outs) within hours of filing.
Law Firms & Creditor Representation	Immediate alerts when clients or business partners enter restructuring or insolvency proceedings.
Factoring & Debt Collection	Timely claim filing (§ 174 InsO) and verification of security interests (§ 28 Abs. 2 InsO).

---

⚙️ Input Parameters

Parameter	Type	Default	Description
bundeslaender	Array[String]	["NW"]	Federal state codes to monitor (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH, or ALL).
gegenstand	String	"ALL"	Procedural subject filter: ALL, EROEFF (Eröffnungen), SICHMASS (Sicherungsmaßnahmen / vorläufige Verfahren), ABWMASS (Abweisung mangels Masse), INSO_PLAN (Insolvenzpläne), ENT_VERF (Entscheidungen im Verfahren).
companyNameSearch	String	""	Live-KYC / Credit Check: Direct search by company or debtor name (e.g. "Capricorn" or "Bau"). Automatically wrapped in wildcards (*name*).
citySearch	String	""	Filter by registered city / seat (e.g. "Düsseldorf", "München").
registerNumberSearch	String	""	Direct filter by commercial register number (e.g. "63109" for HRB 63109).
daysBack	Integer	3	Lookback window in days starting from today. Automatically partitioned day-by-day if result volume is large.
onlyCompanies	Boolean	false	When set to true, filters only corporate entities (GmbH, UG, AG, KG, etc.) and ignores consumer/private cases.
includeFullText	Boolean	true	Fetches the complete official court publication text via instant AJAX requests.
maxItems	Integer	20	Maximum number of structured insolvency records to output.

Example Input

{
  "bundeslaender": ["NW", "BY"],
  "gegenstand": "SICHMASS",
  "daysBack": 7,
  "onlyCompanies": true,
  "includeFullText": true,
  "maxItems": 50
}

---

📦 Output Dataset Example

Each record is pushed individually to the default dataset:

{
  "veroeffentlichungsdatum": "04.11.2026",
  "aktenzeichen": "164 IN 184/26",
  "gericht": "Essen",
  "bundesland": "NW",
  "schuldner_name": "BM Fischer Verkehrstechnik UG (haftungsbeschränkt)",
  "sitz": "Essen",
  "register_raw": "Essen, HRB 28285",
  "register_art": "HRB",
  "register_nummer": "28285",
  "ist_unternehmen": true,
  "gegenstand": "SICHMASS",
  "geschaeftszweig": "Die Durchführung von Markierungs- und Beschilderungsarbeiten",
  "insolvenzverwalter": "Rechtsanwalt Markus van Marwyk, Alfredstr. 45, 45130 Essen",
  "volltext": "Amtsgericht Essen, Aktenzeichen: 164 IN 184/26 \n\nIn dem Insolvenzeröffnungsverfahren über das Vermögen \n\nder im Register des Amtsgerichts Essen unter HRB 28285 eingetragenen BM Fischer Verkehrstechnik UG (haftungsbeschränkt), Hüttmannstr. 11, 45143 Essen, derzeit führungslos und nicht gesetzlich vertreten,\n\nGeschäftszweig: Die Durchführung von Markierungs- und Beschilderungsarbeiten\n\nist am 04.11.2026, um 13:05 Uhr angeordnet worden (§§ 21, 22 InsO): \nZum vorläufigen Insolvenzverwalter wird Rechtsanwalt Markus van Marwyk, Alfredstr. 45, 45130 Essen bestellt. \nVerfügungen der Schuldnerin über Gegenstände ihres Vermögens sind nur noch mit Zustimmung des vorläufigen Insolvenzverwalters wirksam (§ 21 Abs. 2 Nr. 2 2. Alt. InsO). \nDen Schuldnern der Schuldnerin (Drittschuldnern) wird verboten, an die Schuldnerin zu zahlen..."
}

---

🔄 Automated Workflows & Integrations

1. Daily Insolvency Alerts via Webhooks (n8n / Make / Zapier)

Configure a scheduled daily run on Apify (e.g. 0 7 * * * with daysBack: 1 and onlyCompanies: true). Attach an Apify Webhook targeting your automation endpoint:

• n8n / Make: Filter filings by keyword, postal code, or registered industry.
• Slack / MS Teams: Send high-priority notifications to risk analysts when a critical debtor enters preliminary insolvency (SICHMASS).
• HubSpot / Salesforce / ERP: Automatically flag accounts in your CRM or ERP system as high credit risk.

2. Python SDK Integration

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")

run = client.actor("german-insolvency-monitor").call(
    run_input={
        "bundeslaender": ["NW", "BY"],
        "gegenstand": "SICHMASS",
        "daysBack": 3,
        "onlyCompanies": True,
        "maxItems": 100,
    }
)

dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items
for item in dataset_items:
    print(f"[{item['aktenzeichen']}] {item['schuldner_name']} -> Verwalter: {item['insolvenzverwalter']}")

---

🇩🇪 Deutsche Kurzbeschreibung

Der German Corporate Insolvency Monitor aggregiert tagesaktuell alle amtlichen Insolvenzbekanntmachungen aus dem Bundesportal neu.insolvenzbekanntmachungen.de. Durch die direkte Anbindung über standardkonforme HTTPX-Requests entfällt der rechenintensive Browser-Overhead.

• B2B-Fokus: Mit onlyCompanies: true filtern Sie Privatinsolvenzen sofort heraus und erhalten ausschließlich meldepflichtige Unternehmen (GmbH, UG, AG, KG, e.K.).
• Volltext & Verwalter: Liest in Millisekunden die amtlichen Beschlüsse aus und extrahiert den vorläufigen Insolvenzverwalter samt Kanzleisitz und den Geschäftszweig.
• 100% Zuverlässig: Keine 1.000-Treffer-Abbrüche dank automatischer Tagessplittung.