🔌 REST API

Developer-First API für Insolvenz-Monitoring

Integrieren Sie Insolvenz-Alarm nahtlos in Ihre Anwendungen. Einfach, schnell, gut dokumentiert.

Quick Start

curl -X GET \
  "https://app.insolvenz-alarm.eu/api/v1/unternehmen" \
  -H "Authorization: Bearer YOUR_API_KEY"

🔑

Authentifizierung

API-Key im Header. Alle Anfragen erfordern einen API-Key, den Sie in Ihren Account-Einstellungen generieren können.

Bearer Token

Einfacher API-Key im Authorization-Header

Sicher

Alle Verbindungen über HTTPS verschlüsselt

Einfach zu generieren

API-Key mit einem Klick in Ihrem Account erstellen

Authentication Header

Authorization: Bearer YOUR_API_KEY

Base URL:

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

Request

curl -X GET \
  "https://app.insolvenz-alarm.eu/api/v1/unternehmen" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)

{
  "data": [
    {
      "id": "uuid-123",
      "name": "Mustermann GmbH",
      "registernummer": "HRB 12345",
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 247
}

Request

const response = await fetch(
  'https://app.insolvenz-alarm.eu/api/v1/unternehmen',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);

Request

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 
  'https://app.insolvenz-alarm.eu/api/v1/unternehmen');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Request

import requests

response = requests.get(
    'https://app.insolvenz-alarm.eu/api/v1/unternehmen',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(data)

GET

/unternehmen

Alle überwachten Unternehmen abrufen. Rufen Sie Ihre komplette Watchlist ab.

Query Parameters

?limit=100 - Max. Anzahl Ergebnisse (default: 50)
?offset=0 - Pagination offset

Response

200 OK - Array mit Unternehmen
401 Unauthorized - Ungültiger API-Key

POST

/unternehmen

Unternehmen zur Überwachung hinzufügen. Fügen Sie ein einzelnes Unternehmen oder mehrere auf einmal hinzu.

Request Body (JSON)

{
  "name": "Mustermann GmbH",
  "registernummer": "HRB 12345",
  "ort": "Hamburg"
}

Response

201 Created - Unternehmen erfolgreich hinzugefügt
400 Bad Request - Ungültige Daten
409 Conflict - Unternehmen bereits auf Watchlist

Request

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",
    "registernummer": "HRB 12345",
    "ort": "Hamburg"
  }'

Response (201 Created)

{
  "id": "uuid-456",
  "name": "Mustermann GmbH",
  "registernummer": "HRB 12345",
  "created_at": "2024-03-09T15:30:00Z"
}

Request

const response = await fetch(
  'https://app.insolvenz-alarm.eu/api/v1/unternehmen',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Mustermann GmbH',
      registernummer: 'HRB 12345',
      ort: 'Hamburg'
    })
  }
);

const data = await response.json();

🔗

Webhooks

Erhalten Sie automatische Benachrichtigungen bei neuen Insolvenzmeldungen direkt in Ihre Systeme.

Webhook konfigurieren

Konfigurieren Sie Webhook-Endpoints in Ihren Account-Einstellungen. Bei jedem Treffer wird ein POST-Request an Ihre URL gesendet.

Payload-Beispiel

{
  "event": "insolvenz_treffer",
  "timestamp": "2024-03-09T15:30:00Z",
  "data": {
    "unternehmen": {
      "name": "Mustermann GmbH",
      "registernummer": "HRB 12345"
    },
    "verfahren": {
      "art": "Eröffnung",
      "datum": "2024-03-08",
      "gericht": "AG Hamburg"
    }
  }
}

Use Cases

💬

Automatische Benachrichtigungen via WhatsApp Business

🏭

ERP-Integration

Automatische Sperrung von Kunden in Ihrem ERP-System

📧

Custom Workflows

Trigger eigene Prozesse (E-Mail, Ticketing, etc.)

Rate Limits & Preise

Faire Limits für jeden Anwendungsfall

Plan	Rate Limit	API-Zugang	Preis
Starter	—	Kein API-Zugang	Kostenlos
Basic	100 Requests/Stunde	✓ Voller Zugang	29€/Monat
Pro	500 Requests/Stunde	✓ Voller Zugang	69€/Monat
Business	2.000 Requests/Stunde	✓ Voller Zugang	149€/Monat

Alle Pläne vergleichen →

Bereit für die Integration?

Starten Sie mit dem Basic-Plan für vollen API-Zugang.

Jetzt kostenlos starten Pläne vergleichen