Eine neue Firma, ein Umzug, ein neuer Name oder frisches Kapital markieren oft den Moment, in dem ein Unternehmen einkauft. Die API überwacht die Konten Ihres CRM, meldet die Änderung aus Zefix (Schweiz) oder aus den GLEIF-Daten (Deutschland, nur Unternehmen mit LEI) und liefert die neu eingetragenen Firmen. Reine Unternehmensdaten: keine Organe, keine Personen.
Eine Firma, die entsteht oder sich verändert, entscheidet Anschaffungen und Verträge neu. Die API meldet solche Änderungen als Ereignisse (event_type), die Sie als Alarm erhalten oder im Länderfeed lesen.
| Änderung | event_type | Warum der Vertrieb hinschaut | Wo |
|---|---|---|---|
| Neue Firma im Register | new_incorporation | Eine neue Firma braucht Bank, Treuhänder oder Steuerberater, Versicherung, Software und Räume | Schweiz; Deutschland nur Unternehmen mit LEI |
| Neue Sitzadresse | address_change | Neue Räume: Umbau, Einrichtung, Dienstleister vor Ort | Schweiz und Deutschland |
| Neuer Firmenname | name_change | Ein Rebranding öffnet Verträge, Systeme und Drucksachen | Schweiz und Deutschland |
| Neue Rechtsform | legal_form_change | Etwa von der UG (haftungsbeschränkt) zur GmbH oder von der GmbH zur AG: Die Firma wächst und ordnet ihre Verträge neu | Schweiz und Deutschland |
| Kapitaländerung | capital_change | Eine Erhöhung ist Geld, das bald ausgegeben wird; previous_value und new_value zeigen die Höhe | nur Schweiz |
| Liquidation, Löschung, Reaktivierung | liquidation, dissolution, reactivation | Verkauf stoppen, Rechnung schützen, CRM bereinigen; oder die Firma ist wieder im Geschäft | Schweiz |
| Erlöschen, Verschmelzung | dissolution, merger | Ein Konto fällt weg, oder zwei Lieferantenlisten werden eine; den Nachfolger nennt registry_details.successor_lei, wo GLEIF ihn angibt | Deutschland |
Datiert wird auf den Tag, an dem die Änderung erstmals in den Registerdaten erscheint, nicht auf den Tag der Eintragung. Die Historie beginnt für die Schweiz am 30. September 2026 und für Deutschland mit dem ersten Laden im Oktober 2026; davor gibt es keine Ereignisse. Die Ereignisse tragen previous_value und new_value: Bei einem Umzug stehen dort die alte und die neue Adresse; bei einem Rechtsformwechsel stehen sie für deutsche Firmen als Kürzel (GmbH), für Schweizer als Registercode (0106 für die AG, 0107 für die GmbH). Vergleichen Sie beide Werte: Gelegentlich ändert sich nur die Schreibweise.
Ordnen Sie jedes Konto einmal seinem Datensatz zu, abonnieren Sie es und tragen Sie Ihre CRM-Id als label ein: Sie kommt in jedem Alarm zurück. Schweizer Firmen suchen Sie mit der UID, deutsche mit der LEI, die dort die company_number ist. Das Abonnieren kostet keine Credits.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
# Ihre Zielkunden, wie das CRM sie führt: Land, Kennung (CH: UID, DE: LEI) und CRM-Id
konten = [('CH', 'CHE103867266', 'crm-1001'), ('DE', 'W38RGI023J3WT1HWRP32', 'crm-1002')]
for land, kennung, crm_id in konten:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': land, 'company_number': kennung})
r.raise_for_status()
treffer = r.json()['data']
if treffer:
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': treffer[0]['id'],
'label': crm_id,
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://ihre-domain.ch/hooks/prometiam',
}).raise_for_status()
Jeder Alarm kommt signiert: Der Header X-Prometiam-Signature enthält sha256= und den HMAC-SHA256 des Bodys mit dem webhook_secret, das POST /monitor einmalig zurückgibt. Prüfen Sie die Signatur, bevor Sie die Aufgabe für die Kundenbetreuung anlegen.
import hashlib
import hmac
def signatur_stimmt(body: bytes, header: str, webhook_secret: str) -> bool:
erwartet = 'sha256=' + hmac.new(webhook_secret.encode(), body, hashlib.sha256).hexdigest()
return hmac.compare_digest(header, erwartet)
# Im Webhook-Handler: den Body unverändert lesen und den Header X-Prometiam-Signature prüfen.
# Erst danach die Aufgabe anlegen: alert['label'] ist Ihre CRM-Id, alert['alert_type'] die Art des Alarms;
# bei corporate_event nennt alert['detail'] den event_type sowie previous_value und new_value.
Der Webhook ist in jedem Tarif enthalten. Auf jedem Tarif listet GET /monitor Ihre Abos und die 50 jüngsten Alarme, ein nächtlicher Job genügt also auch. Überwachte Firmen werden täglich geprüft. Überwachen können Sie in der Testphase 3 Firmen, mit Starter 25, mit Professional 250 und mit Scale 2 500.
Vor dem ersten Gespräch sagt die Änderungshistorie mehr als die Firmenbeschreibung: GET /company-events/search?country=CH&company_number=CHE103867266&date_from=2026-09-30 listet die Ereignisse dieser Firma, das jüngste zuerst, zu 2 Credits pro Aufruf. Für eine deutsche Firma übergeben Sie die LEI als company_number. Eine leere Liste heisst nur, dass seit Beginn der Historie keine Änderung gesehen wurde.
Lassen Sie Firmenname und Nummer weg, ist derselbe Aufruf der Länderfeed: alle Änderungen eines Landes, das jüngste zuerst, filterbar nach event_type. Er reicht höchstens 31 Tage zurück (ohne date_from sieben Tage; ein älteres Datum weist die API mit 400 ab), liefert 100 Ereignisse pro Aufruf zu 2 Credits und blättert mit next_cursor. Ein täglicher oder wöchentlicher Job, der den Feed liest und die Firmen Ihres Segments behält, findet die Konten, die Sie noch nicht beobachten.
# Schweiz: alle Kapitaländerungen der letzten 7 Tage (100 Ereignisse pro Aufruf) curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=CH&event_type=capital_change&limit=100' \ -H 'Authorization: Bearer rk_live_...' # Deutschland: alle Verschmelzungen von Unternehmen mit LEI der letzten 7 Tage curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=DE&event_type=merger&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Bei einem Umzug enthält new_value die neue Adresse mit Postleitzahl und Ort; danach filtern Sie nach Region. Die company_id jedes Ereignisses können Sie direkt an POST /monitor übergeben und die Firma so ab sofort beobachten.
Die Gründung ist das erste Signal. Wie Sie neue Firmen finden, hängt vom Land ab, weil die Daten verschieden viel über das Gründungsdatum sagen.
event_type=new_incorporation im Länderfeed. founded_after liefert hier nichts, denn die Schweizer Datensätze tragen kein Gründungsdatum (founding_date ist leer); neu eingetragene Firmen haben das Eintragungsdatum in registration_date. Das Ereignis trägt das Datum, an dem die Firma erstmals in den Daten erschien; das Eintragungsdatum steht in seinem Text («founded 2026-10-13») und kann einige Tage davor liegen.founded_after funktioniert, aber nur für Unternehmen mit LEI. Das Gründungsdatum stammt aus dem LEI-Datensatz, soweit dieser eines nennt. Eine Firma erscheint erst, wenn sie eine LEI hat, oft Wochen nach der Gründung; eine Firma ohne LEI sehen Sie nie.# Deutschland: Unternehmen mit LEI, die seit dem 1. Oktober gegründet wurden (100 pro Aufruf) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=DE&founded_after=2026-10-01&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Die Firmensuche kostet 1 Credit pro Aufruf (der Länderfeed 2); blättern Sie mit next_cursor weiter.
Die Überwachung kostet keine Credits: Der Tarif legt fest, wie viele Firmen Sie beobachten. Eine Firmensuche kostet 1 Credit, eine Ereignisabfrage und der Länderfeed je 2; Fehler kosten nichts. Starter kostet 9,99 EUR pro Monat mit 1 000 Credits und 25 überwachten Firmen, Professional 29,99 EUR mit 10 000 Credits und 250 Firmen, Scale 99,99 EUR mit 50 000 Credits und 2 500 Firmen; Webhooks sind in jedem Tarif enthalten. Die Testphase dauert 14 Tage mit 500 Credits: Eine Karte ist erforderlich, während der Testphase wird nichts belastet; danach läuft das Starter-Abo, sofern Sie nicht kündigen. Alle Preise: Preise.
Quelle der Schweizer Daten: Zefix, Federal Office of Justice, Federal Commercial Registry Office (open use, source required); restructured by Prometiam, not a certified register extract
Contains LEI data from the Global Legal Entity Identifier Foundation (GLEIF), available under CC0 1.0. Not an extract of the German commercial register (Handelsregister). Marktstammdatenregister-Datensätze: Quelle: Bundesnetzagentur, Marktstammdatenregister (https://www.marktstammdatenregister.de/MaStR/Datendownload), Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0, https://www.govdata.de/dl-de/by-2-0). Daten geändert: von Prometiam ausgewählt, verknüpft und normalisiert. Von den Marktakteuren angegeben und nicht mit dem Handelsregister abgeglichen; kein Auszug aus dem Handelsregister.
Rechtsquellen: § 7 UWG (gesetze-im-internet.de) und Art. 3 UWG, SR 241 (fedlex.admin.ch).
14 Tage kostenlos testen · API-Dokumentation
Die Testphase dauert 14 Tage und umfasst 500 Credits. Eine Karte ist erforderlich, während der Testphase wird nichts belastet; danach läuft das Starter-Abo (9,99 EUR pro Monat), sofern Sie nicht kündigen.