Zefix API: Schweizer Firmendaten und UID per REST abfragen

Zefix ist der zentrale Firmenindex der Schweiz. Hier lesen Sie, was Sie von Zefix direkt bekommen, was eine einheitliche REST-API mit UID-Prüfung, SHAB-Meldungen und Webhook-Monitoring zusätzlich bietet und wo ihre Grenzen liegen.

Was Zefix ist und was es selbst bietet

Zefix (Zentraler Firmenindex) wird vom Eidgenössischen Amt für das Handelsregister im Bundesamt für Justiz geführt und fasst die Einträge der kantonalen Handelsregister zusammen. Jede juristische Person trägt eine UID, die Unternehmens-Identifikationsnummer, zum Beispiel CHE-103.867.266 für die Novartis AG. Eine Einführung bietet der Ratgeber Was ist Zefix?.

Der Bund bietet nach unserem Kenntnisstand eine kostenlose öffentliche Schnittstelle zu Zefix an. Sie ist für einzelne Abfragen und kleine Anwendungen eine gute Wahl, und Sie sollten sie prüfen, bevor Sie etwas anderes bezahlen. Zugangsbedingungen und Funktionsumfang richten sich nach dem Bundesamt für Justiz und können sich ändern; massgeblich sind dessen Angaben. Wir behaupten nicht, dass sie schlechter wäre als unsere. Sie ist einfach eine andere Lösung für eine andere Aufgabe.

Wann eine einheitliche API sinnvoller ist

• Ein Format für viele Länder: Dieselbe Antwortstruktur und derselbe Schlüssel gelten für die Schweiz und alle übrigen Länder der API. Wer neben Schweizer auch deutsche oder französische Kunden prüft, schreibt den Code einmal.
• Prüfziffer vorab: Die UID hat eine Modulo-11-Prüfziffer. Ein Tippfehler wird mit dem Fehler 400 validation_error abgewiesen, bevor er Ihr Onboarding verfälscht.
• MWST-Nummer durchsuchbar: Die UID mit dem Zusatz MWST, TVA oder IVA finden Sie mit vat=. Sie ist aus der UID gebildet; ob ein Unternehmen mehrwertsteuerpflichtig ist, bestätigt das Register nicht.
• SHAB-Meldungen verknüpft: Insolvenzmeldungen aus dem Schweizerischen Handelsamtsblatt hängen an der UID, sofern die Meldung die UID des Schuldners nennt.
• Registeränderungen und Webhooks: Änderungen von Firma, Status, Rechtsform und Sitzadresse erscheinen als Ereignisse (seit dem 30. September 2026), und POST /monitor meldet sie per Webhook.
• Planbare Kosten: Preise in Credits, öffentlich einsehbar, ohne Verkaufsgespräch.

Ein Aufruf mit UID

Alle Aufrufe tragen den Header Authorization: Bearer rk_live_.... Die UID dürfen Sie mit oder ohne Punkte und Bindestriche übergeben.

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CH&company_number=CHE103867266' \
  -H 'Authorization: Bearer rk_live_...'

Die Antwort liegt unter data (gekürzt, das vollständige Objekt hat in jedem Land dieselben Schlüssel):

{
  "data": [
    {
      "country": "CH",
      "company_number": "CHE103867266",
      "company_name": "Novartis AG",
      "legal_form": "AG",
      "status": "active"
    }
  ]
}

Mit name=novartis suchen Sie nach dem Firmennamen, mit vat= nach der MWST-Nummer. Die id aus der Suche verwenden Sie für GET /companies/{id}, die Insolvenzmeldungen holen Sie mit GET /insolvency/search?country=CH&company_number=CHE103867266. Wer nur eine einzelne UID prüfen will, nutzt die kostenlose UID-Suche.

Was Sie erhalten

Feld	Bedeutung
company_name, company_number	Firma und UID
legal_form, local_legal_form	Rechtsform standardisiert und im Wortlaut des Registers
status, local_status	aktiv, in Liquidation oder aufgelöst
Adressfelder	Sitzadresse mit Kanton
vat_number	UID mit dem Zusatz MWST, TVA oder IVA, nach der Regel gebildet

Was nicht enthalten ist

• Keine Organe und Zeichnungsberechtigten, kein Registerkonformitäts-Signal und kein Branchencode: Das Register veröffentlicht keinen NOGA-Code.
• Nur juristische Personen und Zweigniederlassungen. Einzelunternehmen und andere natürliche Personen werden nie ausgeliefert.
• Kein eigener Konkursstatus: Eine Liquidation vermerkt das Register nur in der Firma, ein gelöschtes Unternehmen erscheint als aufgelöst. Konkurse sehen Sie in den SHAB-Meldungen.
• Kein beglaubigter Handelsregisterauszug. Dafür wenden Sie sich an das zuständige Handelsregisteramt.

Welcher Tarif passt

Für Entwicklung und kleine Bestände genügt Starter (9,99 EUR pro Monat, 1 000 Credits). Eine Firmensuche kostet einen Credit. Webhooks gehören zu Professional (29,99 EUR, 10 000 Credits). Die Testphase dauert 14 Tage mit 500 Credits; eine Karte ist erforderlich, in dieser Zeit wird nichts belastet. Alle Preise: Preise.

Quelle: Zefix, Federal Office of Justice, Federal Commercial Registry Office (open use, source required); restructured by Prometiam, not a certified register extract

Weiterführende Seiten

• Was ist Zefix?
• UID-Suche (Werkzeug)
• KYB-Prüfung per API
• Insolvenzüberwachung für DE, AT und CH
• Schweizer Firmendaten per API (Englisch)
• Startseite Deutsch

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.