Liefert Skael eine fertige Liste aller Neugründungen?

Nein, heute nicht. Es gibt keinen Neugründungs-Feed und keinen Datumsfilter in der Firmensuche. Was geht: Firmen über Rechtsform, Bundesland und Ort suchen und einzelne, bekannte Firmen mit einem Monitor beobachten.

Kann ich nach Eintragungsdatum suchen?

Nein. In v1 gibt es keinen Filter nach Gründungs- oder Eintragungsdatum und kein Antwortfeld mit einem Eintragungsdatum. Du kannst nach dem Namen suchen oder über Registerart, Rechtsform, Bundesland und Ort eingrenzen.

Was meldet ein Monitor?

Das Ereignis registry.company.changed an deine callback_url, sobald sich der Registerbestand der Firma ändert. Im Inhalt stehen der aktuelle Stand der Firma mit Name, Rechtsform, Status, Anschrift, Vertretern und Kapital, die Veröffentlichungen, der Gesellschafter-Stand und der Zeitpunkt.

Wie sichere ich den Webhook ab?

Jede Zustellung trägt die Kopfzeilen svix-id, svix-timestamp und svix-signature, eine HMAC-SHA256-Signatur über die Nachricht. Das signing_secret dazu bekommst du nur einmal bei der Anlage; bewahre es sofort auf.

Neugründungen und Handelsregister: Firmen finden und Änderungen per Webhook beobachten

Q: Was passiert, wenn mein Server nicht erreichbar ist?

Die Zustellung wird wiederholt: nach 10 Sekunden, 30 Sekunden, 2 Minuten, 5 Minuten, 30 Minuten, 2 Stunden, 6 Stunden und 24 Stunden. Ist sie dann noch nicht angekommen, wird sie als dead_letter markiert.

Q: Muss die Funktion freigeschaltet werden?

Ja. Registry-Monitore und die Handelsregister-Endpunkte laufen als Pilot und werden je Organisation freigeschaltet. Ohne Freischaltung antwortet die API mit 403. Schreib uns oder buch eine Demo.

Mit einem Registry-Monitor beobachtest du einzelne, bekannte Firmen: ändert sich etwas am Registerbestand, bekommst du einen signierten Webhook an deine callback_url. Die Firmensuche findet Firmen nach Name oder nur über Filter wie Registerart, Rechtsform, Bundesland und Ort; einen Filter nach Gründungs- oder Eintragungsdatum gibt es in v1 nicht. Melde dich gratis an und starte mit dem API-Leitfaden in der Doku.

Gratis anmelden1,000 Credits Zur Doku

Stand: 2. November 2026

Beispiel: Monitor auf eine Firma anlegen

Mit der company_id aus einer Firmensuche legst du einen Monitor an. Die Antwort zeigt das signing_secret genau einmal; bewahre es sofort auf.

Anfrage

POST /api/registry/monitors
Authorization: Bearer eak_...
Content-Type: application/json

{
  "subject_type": "company",
  "company_id": "DE-HRB-F1103-267645",
  "callback_url": "https://your-app.example/webhooks/registry"
}

Antwort

{
  "data": {
    "id": 123,
    "company_id": "DE-HRB-F1103-267645",
    "callback_url": "https://your-app.example/webhooks/registry",
    "callback_resolved_ip": "93.184.216.34",
    "callback_resolved_host": "your-app.example",
    "callback_resolved_port": 443,
    "status": "active",
    "signing_secret_redacted": "whsec_********",
    "signing_secret": "whsec_..."
  }
}

Endpunkt in der Doku

Felder und Quellen

Feld	Bedeutung	Quelle
`id`	Kennung des Monitors, zum Auflisten und Löschen.	Registry-Monitor
`company_id`	Kanonische Firmenkennung der beobachteten Firma im Format DE-HRB-F1103-267645.	Registry-Monitor
`callback_url`	Deine Webhook-Adresse. Sie wird mit SSRF-Schutz geprüft, und Host, Port und aufgelöste IP werden gespeichert und bei der Zustellung festgehalten.	Registry-Monitor
`status`	Status des Monitors, bei Anlage active.	Registry-Monitor
`signing_secret`	Geheimnis für die Signaturprüfung. Es wird nur bei der Anlage gezeigt und liegt verschlüsselt.	Registry-Monitor
`event`	Das Webhook-Ereignis registry.company.changed, sobald sich etwas am Registerbestand der Firma ändert.	Webhook
`company`	Aktueller Stand der Firma: Name, Rechtsform, Status, Ort, Anschrift, Vertreter und Kapital.	Handelsregister (SI-Daten)
`publications`	Die Veröffentlichungen der Firma im Registerbestand.	Webhook
`owners_snapshot`	Der aktuelle Gesellschafter-Stand der Firma.	Webhook
`occurred_at`	Zeitpunkt, zu dem die Änderung festgestellt wurde.	Webhook

Was eine Abfrage kostet

Abfrage	Credits	Einheit
Monitor anlegen	50	je Monitor
Firma suchen	10	je Anfrage mit Treffer
Firmenprofil abrufen	10	je Firma

Alle Tarife und Abrechnungsregeln stehen auf der Preisseite.

Was heute geht

Du kannst heute zwei Dinge tun: Firmen im Handelsregister finden und einzelne, bekannte Firmen laufend beobachten. Die Suche läuft über search_company mit einem Namen oder nur über Filter: Registerart (HRB, HRA, PR, GnR, VR), Rechtsform, Bundesland und Ort grenzen das Ergebnis ein. Das Profil einer Firma mit Vertretern und Kapital liefert get_company.

Für die laufende Beobachtung legst du einen Registry-Monitor auf eine company_id an. POST /api/registry/monitors legt ihn an, GET /api/registry/monitors listet deine Monitore, DELETE /api/registry/monitors/{monitor_id} löscht einen mit Status 204. Nur Firmen-Monitore sind möglich; ein Monitor auf eine Person antwortet mit 422. Anlegen kostet Credits, Auflisten und Löschen kosten nichts.

So läuft ein Monitor

Deine callback_url wird mit SSRF-Schutz geprüft; die geprüfte Adresse mit Host, Port und aufgelöster IP wird gespeichert und bei jeder Zustellung festgehalten. Das signing_secret bekommst du genau einmal bei der Anlage, es liegt verschlüsselt.

Der Abgleich läuft alle 10 Minuten über den Registerbestand von Skael. Ändert sich etwas, geht das Ereignis registry.company.changed an deine Adresse, mit Svix-kompatiblen Kopfzeilen svix-id, svix-timestamp und svix-signature (HMAC-SHA256). Im Inhalt stehen der aktuelle Stand der Firma, die Veröffentlichungen, der Gesellschafter-Stand und der Zeitpunkt.

Ist dein Server nicht erreichbar, wiederholt Skael die Zustellung nach 10 Sekunden, 30 Sekunden, 2 Minuten, 5 Minuten, 30 Minuten, 2 Stunden, 6 Stunden und 24 Stunden. Danach landet die Zustellung als dead_letter.

Was es nicht gibt

Eine fertige Liste aller Neugründungen liefert Skael heute nicht. Es gibt keinen Feed neuer Firmen, und search_company hat in v1 keinen Filter nach Gründungs- oder Eintragungsdatum; kein Antwortfeld trägt ein Eintragungsdatum.

Die Suche läuft nur im Registerbestand von Skael, nicht live auf handelsregister.de, und Monitore beobachten nur einzelne, bekannte Firmen.

Registry-Monitore und die Handelsregister-Endpunkte laufen als Pilot und werden je Organisation freigeschaltet; ohne Freischaltung antwortet die API mit 403.

FAQ