Insolvenz-Datenbank als REST-API

Gleichen Sie Ihren Kundenbestand gegen die Insolvenzbekanntmachungen ab — mit derselben Matching-Logik, die das Insolvenzmonitor-Monitoring nutzt. Sie senden eine Liste von Kunden (Name, optional PLZ, Handelsregisternummer, Aktenzeichen) und erhalten je Kunde die passenden Bekanntmachungen mit Trefferquote. Gedacht für die Anbindung an CRM- oder ERP-Systeme. Jeder Aufruf zählt als eine Anfrage, unabhängig von der Zahl der Kunden. Vollständige Referenz mit Matching-Verfahren →

• Erstabgleich eines neuen Kunden: since etwa ein Jahr zurück.
• Täglicher Abgleich: den aktiven Bestand in Paketen senden, since = heute − 5 Tage (die Überlappung fängt spät veröffentlichte Bekanntmachungen ab).

Request-Body (JSON)

Beispiel

curl -X POST "https://insolvenzmonitor.online/api/v1/match" \
  -H "Authorization: Bearer imk_ihre_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "since": "2026-01-01",
    "customers": [
      { "ref": "crm-1001", "name": "Muster Bau GmbH", "zip": "50667", "hr": "HRB 12345" },
      { "ref": "crm-1002", "name": "Beispiel Handel GmbH" }
    ]
  }'

Antwort

{
  "since": "2026-01-01",
  "results": [
    {
      "ref": "crm-1001",
      "status": "match",
      "matches": [
        {
          "confidence": 0.972,
          "match_basis": "fuzzy_name",
          "debtor_name": "Muster Bau GmbH",
          "location": "Köln",
          "court": "Amtsgericht Köln",
          "case_number": "71 IN 123/26",
          "category": "Eröffnungen",
          "publication_date": "2026-03-14",
          "notice_text": "Amtsgericht Köln, Aktenzeichen 71 IN 123/26 ...",
          "bundesland": "Nordrhein-Westfalen",
          "branche": "Baugewerbe & Handwerk (Inkl. Baunebengewerbe)",
          "insolvency_id": 1839201,
          "company_page_url": "https://insolvenzmonitor.online/insolvenz/muster-bau-gmbh-koeln-hrb-12345"
        }
      ]
    },
    { "ref": "crm-1002", "status": "no_match", "matches": [] }
  ]
}

results steht in derselben Reihenfolge wie customers, die Treffer je Kunde sind nach Sicherheit sortiert. since gibt das tatsächlich angewandte Datum zurück. Die Felder sind unter Antwortfelder beschrieben; bundesland und branche können null sein.

Trefferarten (match_basis)

Gut zu wissen

• Gesucht wird über den Namen. Kandidaten sind Bekanntmachungen, deren Schuldnername mit einem Wort Ihres Kundennamens beginnt. „Müller Bau GmbH“ findet „Müller Bau GmbH & Co. KG“, „Bau Müller“ (umgekehrte Reihenfolge) eventuell nicht.
• Kein Kategoriefilter: Es kommen Treffer aller Kategorien (Eröffnungen, Abweisungen, Sicherungsmaßnahmen, Verteilungsverzeichnisse …). Filtern Sie bei Bedarf über category.
• Firmen und Personen werden nie miteinander abgeglichen. Bei Personen müssen Nachname und Vornamen passen.
• company_page_url ist nur gesetzt, wenn es zur Firma eine öffentliche Firmenseite gibt (Firmen mit Handelsregistereintrag und Verfahren seit 2024). Für Privatpersonen, Einzelunternehmen ohne Registereintrag und ältere Fälle ist der Wert null.
• Datenschutz: notice_text enthält den vollständigen Bekanntmachungstext — bei Privatpersonen mit Name, Anschrift und oft Geburtsdatum. Bitte DSGVO-konform verarbeiten. Die übermittelten Kundendaten verwenden wir nur für den Abgleich und speichern sie nicht. Wenn Ihre Liste das Haus nicht verlassen soll, nutzen Sie stattdessen GET /api/v1/insolvencies und gleichen selbst ab.