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.

Pläne

API Trial — kostenlos, 30 Tage

Schlüssel sofort im Dashboard erzeugen, keine Kreditkarte. Ein Trial je Konto.

  • 30 Tage kostenlos testen
  • Schlüssel sofort im Dashboard erzeugen
  • 1.000 Anfragen insgesamt
  • 10 Anfragen/Minute
  • Bis zu 100 Ergebnisse pro Anfrage
  • Historie der letzten 24 Monate
API Standard — €149 / Monat
  • Vollzugriff auf 2+ Millionen Insolvenzeinträge
  • Unbegrenzte Anfragen
  • Bis zu 1.000 Ergebnisse pro Anfrage
  • 30 Anfragen/Minute (Soft-Limit)
  • JSON · jede Programmiersprache
  • Nutzungsstatistiken im Dashboard

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.online/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.online/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

Auf API Standard ist das Minutenlimit von 30 Anfragen ein Soft-Limit — Anfragen werden nicht blockiert, aber der Response-Header X-RateLimit-Burst: limited wird gesetzt. Es gibt kein Anfragekontingent.

Auf API Trial werden die Limits durchgesetzt: 1.000 Anfragen insgesamt und 10 Anfragen/Minute. Wird eines überschritten, antwortet die API mit 429 und dem Fehlercode QUOTA_EXCEEDED bzw. RATE_LIMITED. Außerdem sind Antworten auf 100 Zeilen und die Historie auf die letzten 24 Monate begrenzt.

Fehlercodes

HTTPCodeBedeutung
401MISSING_KEYKein API-Schlüssel angegeben
401INVALID_KEYUngültiger oder widerrufener Schlüssel
403PLAN_EXPIREDKein aktiver Plan — Trial abgelaufen oder Abo beendet
429QUOTA_EXCEEDEDAnfragekontingent aufgebraucht (nur Trial)
429RATE_LIMITEDMinutenlimit überschritten (nur Trial)
400INVALID_IDUngültige ID (nur Integer erlaubt)
404NOT_FOUNDKein Eintrag mit dieser ID gefunden
500INTERNAL_ERRORDatenbankfehler