API · REST · JSON

REST API für Entwickler.

Integrieren Sie Invareo in Ihr ERP, CRM oder Buchhaltungssystem. Vollständig dokumentierte REST API mit flexiblem Zugriff — ab Basic-Tarif.

Einfache Integration

Standard REST API, JSON-Requests. Keine speziellen SDKs nötig.

Bearer Token Auth

Sichere Authentifizierung mit API-Keys pro Umgebung.

Webhook-Support

Push-Benachrichtigungen mit HMAC-SHA256-Signatur + Retry.

OpenAPI-Spec

Maschinenlesbare Spezifikation und interaktiver Playground.

Base-URL

https://app.insolvenz-alarm.eu/api/v1/

Alle Endpunkte sind unter dieser Basis erreichbar. Die vollständige OpenAPI-3.1-Spezifikation finden Sie im Dashboard unter Einstellungen → API.

Endpoints · Watchlist

Überwachte Unternehmen verwalten.

Unternehmen zur Watchlist hinzufügen, abfragen und deren Status steuern.

GET /api/v1/unternehmen

Alle überwachten Unternehmen abrufen. Paginiert, mit Filter nach Status und Qualitäts-Score.

{
  "data": [
    {
      "id": "cmp_a1b2c3d4",
      "name": "Mustermann GmbH",
      "hrb": "HRB 12345",
      "court": "Amtsgericht München",
      "quality_score": 92,
      "status": "monitored"
    }
  ],
  "meta": { "total": 247, "page": 1, "per_page": 50 }
}

POST /api/v1/unternehmen

Ein Unternehmen zur Watchlist hinzufügen. Duplikate werden via HRB + Gericht erkannt.

curl -X POST https://app.insolvenz-alarm.eu/api/v1/unternehmen \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mustermann GmbH",
    "hrb": "HRB 12345",
    "court": "Amtsgericht München",
    "vat_id": "DE123456789"
  }'

Endpoints · Treffer & Fristen

Insolvenz-Treffer abrufen.

Erkannte Insolvenzen inklusive Konfidenz-Level, Verwalter-Information und Fristen.

GET /api/v1/treffer

Liste aller Insolvenz-Treffer, chronologisch absteigend. Inklusive Konfidenz-Level (sicher / sehr wahrscheinlich / möglich / unsicher).

{
  "data": [
    {
      "id": "alt_x9y8z7",
      "company_id": "cmp_a1b2c3d4",
      "company_name": "Mustermann GmbH",
      "confidence": "sicher",
      "filing_date": "2026-03-11",
      "court": "Amtsgericht München",
      "case_number": "1234 IN 45/26",
      "verwalter": "Dr. Max Schneider",
      "detected_at": "2026-03-12T06:15:00Z"
    }
  ]
}

GET /api/v1/treffer/export

Treffer als CSV oder JSON exportieren (bis zu 10.000 Datensätze pro Export).

PATCH /api/v1/treffer/bulk

Bis zu 100 Treffer in einer Anfrage aktualisieren (Status, Kommentare, Zuweisungen).

GET /api/v1/fristen

Bevorstehende Anmelde- und Prüfungs-Fristen aller aktiven Treffer.

Endpoints · Forderungsanmeldung

Forderungen direkt aus der API anmelden.

CRUD, PDF-Generator und Status-Tracking — ab Pro-Tarif.

GET /api/v1/forderungen

Alle Forderungsanmeldungen der Organisation, gefiltert nach Status (Entwurf, versendet, angenommen, bestritten).

POST /api/v1/forderungen

Neue Forderungsanmeldung anlegen. Schuldner- und Verwalterdaten werden aus dem Treffer vorausgefüllt.

POST /api/v1/forderungen/{id}/pdf

PDF generieren. Rückgabe: signierter Download-Link, 24h gültig.

GET /api/v1/forderungen/statistik

Aggregierte Statistik: Anzahl offener Forderungen, Gesamtsumme, durchschnittliche Quote.

Endpoints · Benachrichtigungen & Konto

Konfiguration per API.

PATCH /api/v1/benachrichtigungen/einstellungen

E-Mail-Empfänger, Digest-Zeitpunkt und Webhook-Konfiguration aus Ihrem eigenen System steuern.

GET /api/v1/konto/audit

Audit-Log aller Konto-Aktivitäten, paginiert, mit Zeitraum- und Aktions-Filter.

GET /api/v1/ping

Health-Check — liefert aktuelle API-Version und Rate-Limit-Status.

Webhooks · Push-Events

Echtzeit-Benachrichtigungen direkt in Ihr System.

HMAC-SHA256-signiert, mit Auto-Retry (bis 8 Versuche) und Auto-Pause nach wiederholten Fehlern. Verfügbar ab Basic (1 Webhook), Pro (3), Business (10).

Ereignistypen

treffer_neu
treffer_bestaetigt
frist_warnung
verfahren_aktualisiert
forderung_status_geaendert

Beispiel-Payload

{
  "event": "treffer_neu",
  "treffer": {
    "id": "alt_x9y8z7",
    "company_name": "Mustermann GmbH",
    "confidence": "sicher",
    "filing_date": "2026-03-11"
  },
  "timestamp": "2026-03-12T06:15:00Z"
}

Auth · Rate Limits

Authentifizierung.

Bearer Token

Alle Requests erfordern einen API-Key im Authorization-Header. Keys werden im Dashboard unter Einstellungen → API generiert und können jederzeit rotiert werden.

Authorization: Bearer sk_live_a1b2c3d4e5f6...

Rate Limits

Basic 100 Calls / Stunde

Pro 500 Calls / Stunde

Business 2.000 Calls / Stunde

Gemessen per API-Key. Bei Überschreitung: HTTP 429 mit Retry-After-Header.

Jetzt starten

API-Key anfordern.

Ab dem Basic-Tarif ist REST-API-Zugriff inklusive. Vollständige OpenAPI-Spezifikation und interaktiver Playground im Dashboard.

Zum Dashboard Preise ansehen

DSGVO-konform Keine Vertragsbindung Jederzeit kündbar