Developer API

Insolvenz-Datenbank als REST-API

Direkter Zugriff auf 2+ Millionen Insolvenzbekanntmachungen aus Deutschland. Einfache Integration in Ihre eigenen Anwendungen — kein Scraping, keine Wartung.

Preis

API Standard — €49 / Monat
  • Vollzugriff auf alle 2+ Millionen Insolvenzeinträge
  • Bis zu 1.000 Ergebnisse pro Anfrage
  • 30 Anfragen/Minute (Soft-Limit)
  • JSON-Antworten, jede Programmiersprache
  • Nutzungsstatistiken im Dashboard (Anfragen & Zeilen)

Authentifizierung

Jede Anfrage muss einen API-Schlüssel im Authorization-Header enthalten. Schlüssel werden im Dashboard unter API-Zugang generiert.

Authorization: Bearer imk_<ihr-api-schlüssel>

Endpunkte

GET/api/v1/insolvencies

Durchsuchen Sie die Insolvenz-Datenbank mit optionalen Filtern. Gibt bis zu 1.000 Ergebnisse pro Anfrage zurück.

Query-Parameter

ParameterTypBeschreibung
qstringVolltextsuche im Schuldnernamen und Bekanntmachungstext
registration_numberstringExakte Übereinstimmung mit dem Handelsregistereintrag
courtstringGericht (Teilübereinstimmung)
case_numberstringExaktes Aktenzeichen
categorystringKategorie (z.B. Eröffnungen, Sicherungsmaßnahmen)
fromYYYY-MM-DDUntergrenze für Bekanntmachungsdatum
toYYYY-MM-DDObergrenze für Bekanntmachungsdatum
limitintegerErgebnisse pro Seite, max 1.000 (Standard: 100)
offsetintegerSeitennummerierung (Standard: 0)

Beispiel

curl -X GET "https://insolvenzmonitor.de/api/v1/insolvencies?from=2026-03-16&to=2026-03-16&limit=1000" \
  -H "Authorization: Bearer imk_ihre_api_key"

Antwort

{
  "data": [
    {
      "id": 1234567,
      "debtor_name": "Beispiel GmbH",
      "location": "München",
      "court": "Amtsgericht München",
      "case_number": "1501 IN 1234/24",
      "publication_date": "2026-03-16",
      "category": "Eröffnungen",
      "notice_text": "Über das Vermögen der Schuldnerin...",
      "hr_entry": "HRB 12345"
    }
  ],
  "pagination": {
    "total": 4832,
    "limit": 1000,
    "offset": 0,
    "has_more": true
  }
}
GET/api/v1/insolvencies/:id

Ruft eine einzelne Insolvenzbekanntmachung anhand ihrer numerischen ID ab.

curl "https://insolvenzmonitor.de/api/v1/insolvencies/1234567" \
  -H "Authorization: Bearer imk_ihre_api_key"

Paginierung

Die API gibt maximal 1.000 Ergebnisse pro Anfrage zurück. Für größere Ergebnismengen nutzen Sie offset zur Seitennavigation. Das Feld has_more zeigt an, ob weitere Seiten folgen.

# Seite 1 (Zeilen 1–1000)
GET /api/v1/insolvencies?from=2026-03-16&limit=1000&offset=0

# Seite 2 (Zeilen 1001–2000)
GET /api/v1/insolvencies?from=2026-03-16&limit=1000&offset=1000

Antwortfelder

FeldTypBeschreibung
idintegerEindeutige numerische ID des Eintrags
debtor_namestringName des Schuldners (Person oder Unternehmen)
locationstringWohnsitz oder Geschäftsadresse
courtstringZuständiges Insolvenzgericht
case_numberstringAktenzeichen des Verfahrens
publication_datestringDatum der Bekanntmachung (ISO 8601)
categorystringVerfahrenskategorie (z.B. Eröffnungen)
notice_textstringVolltext der Bekanntmachung
hr_entrystring | nullHandelsregistereintrag (falls vorhanden)

Ratenlimits

Das Minutenlimit von 30 Anfragen ist ein Soft-Limit — Anfragen werden nicht blockiert, aber der Response-Header X-RateLimit-Burst: limited wird gesetzt. Es gibt kein monatliches Kontingent.

Fehlercodes

HTTPCodeBedeutung
401MISSING_KEYKein API-Schlüssel angegeben
401INVALID_KEYUngültiger oder widerrufener Schlüssel
400INVALID_IDUngültige ID (nur Integer erlaubt)
404NOT_FOUNDKein Eintrag mit dieser ID gefunden
500INTERNAL_ERRORDatenbankfehler