Zefix API und SHAB API
Der Bund stellt Firmendaten und Handelsregisterpublikationen über offizielle Schnittstellen bereit. Hier steht, welche es gibt, wie Sie Zugang erhalten und was sie liefern.
Was ist die Zefix API?
Die Zefix API, offiziell «Zefix PublicREST API», ist die Schnittstelle des Eidgenössischen Amtes für das Handelsregister (EHRA) zum zentralen Firmenindex. Sie liefert Firmendaten wie Name, UID, Rechtsform, Sitz, Zweck und Status sowie die Handelsregisterpublikationen im SHAB nach Datum oder Nummer. Der Zugang braucht Benutzername und Passwort, die Sie beim Bundesamt für Justiz per E-Mail an zefix@bj.admin.ch beantragen. Eine eigene, öffentlich dokumentierte SHAB API haben wir nicht gefunden. Die Nutzungsbedingungen des Amtsblattportals bestätigen aber, dass eine Schnittstelle für SHAB-Daten besteht.
Grundlage sind die OpenAPI-Dokumentation der Zefix PublicREST API (Version 2.7.2.4), der Eintrag im Schnittstellenkatalog I14Y, die Seite des Bundesamts für Justiz und die AGB des Amtsblattportals, alle abgerufen am 28. Oktober 2026. Die Quellen stehen am Ende der Seite.
Die offiziellen Zugänge
Je nach Frage reicht ein anderer Zugang. Für eine einzelne Firma genügt die Webapplikation, für ein CRM braucht es die API oder offene Daten.
| Zugang | Was Sie bekommen | Wie Sie Zugang erhalten | Grenzen |
|---|---|---|---|
| Zefix Webapplikation | Einzelabfragen zu allen Firmen im Handelsregister, mit Filtern | Frei unter zefix.admin.ch | Keine Abonnemente, kein Bezug der ganzen Datenbank |
| Zefix REST API | Firmendaten und SHAB-Publikationen maschinenlesbar als JSON | Antrag per E-Mail an zefix@bj.admin.ch, danach Benutzername und Passwort | Ohne Zugangsdaten antwortet die API mit Fehler 401 |
| SHAB-Schnittstelle | Daten der Publikationen im Amtsblattportal | Laut AGB vorhanden, Fragen über das Kontaktformular auf shab.ch | Keine öffentliche Dokumentation gefunden, Übertragung ohne Gewähr |
| opendata.swiss und LINDAS | Tagesaktuelle Kerndaten der aktiven Firmen wie Name, Sitz und Domiziladresse | Frei, per SPARQL-Abfrage über den Linked Data Service des Bundes | Nur Kerndaten und nur aktive Firmen |
| Offene Daten der Kantone | Zum Beispiel Neugründungen in Zürich, Firmenmutationen in Basel-Landschaft | Frei als CSV oder JSON über opendata.swiss | Nur einzelne Kantone, Aufbereitung je nach Kanton verschieden |
Wie sieht das für Ihren Betrieb aus?
Im Erstgespräch schauen wir Ihre Ausgangslage an und sagen offen, was wir sehen und ob wir helfen können. Über 120 Schweizer Unternehmen betreut seit 2023.
Endpunkte der Zefix API
Alle Pfade stammen aus der offiziellen OpenAPI-Dokumentation und beginnen mit der Server-Adresse www.zefix.admin.ch/ZefixPublicREST. Die Anmeldung erfolgt per HTTP Basic Authentication.
| Methode und Pfad | Zweck laut Dokumentation |
|---|---|
| POST /api/v1/company/search | Firmen nach Name suchen, optional gefiltert nach Rechtsform, Kanton, Registeramt oder Sitzgemeinde und nur aktive Firmen. |
| GET /api/v1/company/uid/{id} | Ausführliche Firmendaten zu einer UID, zum Beispiel CHE107721785. |
| GET /api/v1/company/ehraid/{id} | Ausführliche Firmendaten zur internen EHRA-ID. |
| GET /api/v1/company/chid/{id} | Firmendaten zur alten CH-Nummer, die öffentlich nicht mehr verwendet wird. |
| GET /api/v1/sogc/bydate/{date} | Alle Handelsregisterpublikationen im SHAB eines Tages, jeweils mit Kurzangaben zur Firma. |
| GET /api/v1/sogc/{id} | Eine Publikation im SHAB über ihre Publikationsnummer. |
| GET /api/v1/legalForm | Alle Rechtsformen mit ihren Codes. |
| GET /api/v1/registryOfCommerce | Die kantonalen Handelsregisterämter mit Adresse und Link-Muster für Registerauszüge. |
| GET /api/v1/community | Die politischen Gemeinden mit ihrer Nummer nach dem amtlichen Gemeindeverzeichnis. |
Was eine Firmenabfrage liefert
Die ausführliche Antwort zu einer Firma enthält laut Dokumentation diese Gruppen von Feldern. Wichtig ist auch, was fehlt.
- 1 Identität
- Firmenname mit Übersetzungen, UID, EHRA-ID, Rechtsform und Status. Der Status ist aktiv, in Liquidation oder gelöscht.
- 2 Sitz und Adresse
- Sitzgemeinde mit Gemeindenummer, Kanton, zuständiges Registeramt und die eingetragene Adresse.
- 3 Zweck und Kapital
- Der eingetragene Zweck als Text. Das nominelle Kapital mit Währung, laut Dokumentation nur bei Kapitalgesellschaften.
- 4 Publikationen
- Die SHAB-Publikationen zur Firma mit Datum, Nummer, Text und Art der Mutation, dazu das Datum der letzten Publikation.
- 5 Beziehungen
- Hauptsitz, Zweigniederlassungen, Übernahmen in beide Richtungen, Revisionsstelle und frühere Firmennamen.
- 6 Was fehlt
- Eine eigene Liste der eingetragenen Personen mit Funktion enthält das Schema nicht. Personen erscheinen nur im Text der Publikationen. Eine einheitliche Branchenangabe fehlt ebenfalls.
Ein Beispiel aus der Doku
Die Werte stammen aus den Beispielen der offiziellen Dokumentation. Sie zeigen den Ablauf, nicht echte Ergebnisse.
- 1. Firma suchen
- POST an /api/v1/company/search mit einem JSON-Körper, der das Pflichtfeld name enthält, im Beispiel der Doku «Qube AG».
- Der Name braucht mindestens drei Zeichen, ein Stern dient als Platzhalter. Die Suche verhält sich wie die exakte Suche in der Webapplikation.
- Optional activeOnly auf true setzen, um nur aktive Firmen zu erhalten. Kanton, Registeramt und Sitzgemeinde lassen sich nicht kombinieren.
- 2. Details abrufen
- Mit der UID aus der Trefferliste GET an /api/v1/company/uid/CHE107721785.
- Die Antwort enthält Zweck, Adresse, Publikationen und den Link zum kantonalen Registerauszug.
- 3. Tagespublikationen holen
- GET an /api/v1/sogc/bydate/2020-01-10 liefert alle Handelsregisterpublikationen dieses Tages.
- Jede Publikation enthält Text, Meldungsnummer, Kanton und die Art der Mutation, dazu Kurzangaben zur Firma.
- So sieht ein Aufruf aus
- Auf der Kommandozeile etwa
curl -u BENUTZER:PASSWORT https://www.zefix.admin.ch/ZefixPublicREST/api/v1/company/uid/CHE107721785. Benutzer und Passwort sind die Zugangsdaten, die Sie vom EHRA erhalten.
- Auf der Kommandozeile etwa
- 4. Fehler auswerten
- Die Dokumentation nennt unter anderem die Fehlertypen INVALID_QUERY_WORDS, INVALID_REQUEST_DATA, RESULTLIST_TO_LARGE und NOT_FOUND.
- Bei zu vielen Treffern die Suche weiter eingrenzen, etwa mit Kanton oder Rechtsform.
Was über die SHAB API feststeht
Die Nutzungsbedingungen des Amtsblattportals halten fest, dass zur Übertragung der Daten von Publikationen ein Application Programming Interface zur Verfügung steht. Sie halten auch fest, dass die vollständige und richtige Übertragung über die API nicht in jedem Fall gewährleistet werden kann.
Eine öffentliche technische Dokumentation haben wir am 28. Oktober 2026 nicht gefunden. Wir nennen darum hier keine Endpunkte. Für Fragen bietet der SHAB-Support das Thema «Frage zu Schnittstellen» im Kontaktformular an. Ohne Programmierung lassen sich Treffer auf shab.ch auch als XML exportieren.
Regeln für die Nutzung
Die Zefix-Dokumentation nennt als Lizenz «OGD Open use. Must provide the source», also freie Nutzung mit Quellenangabe. Die Daten aus Zefix entfalten laut Handelsregisterverordnung keine Rechtswirkungen (Art. 14 HRegV).
Für SHAB-Daten erlauben die AGB auch die kommerzielle Verwertung. Sie verlangen, das Datenschutzrecht einzuhalten, die Quelle zu nennen und nicht den Eindruck einer amtlichen Veröffentlichung zu erwecken. Unverändert übernommene Daten müssen optisch klar von eigenen Kommentaren getrennt sein.
Abgleich im CRM aufbauen
Wer Registerdaten laufend im CRM haben will, ruft nicht jede Nacht alle Firmen neu ab. Sinnvoller ist ein Abgleich in zwei Stufen. Einmalig ordnen Sie jedem Firmenkontakt die UID zu, über die Suche und eine manuelle Kontrolle bei ähnlichen Namen. Danach holen Sie täglich die Publikationen des Vortags über /sogc/bydate und prüfen, ob eine der Firmen in Ihrem CRM betroffen ist.
Speichern Sie die UID als festen Schlüssel, nicht den Namen. Firmennamen ändern sich, die UID bleibt. Wechselt der Status auf «in Liquidation» oder «gelöscht», sollte das CRM die Firma markieren, statt sie still weiterzuführen.
Das UID-Register als Ergänzung
Neben Zefix betreibt das Bundesamt für Statistik einen öffentlichen Webservice für das UID-Register. Er enthält auch Einheiten, die nicht im Handelsregister stehen, etwa Vereine oder Verwaltungen, und bietet laut Schnittstellenbeschreibung unter anderem Abfragen nach UID, eine Suche und die Prüfung einer Mehrwertsteuernummer.
Für die Prüfung, ob eine UID gültig ist oder eine Firma mehrwertsteuerpflichtig ist, reicht dieser Dienst oft schon. Für SHAB-Publikationen und Mutationen bleibt Zefix die Quelle.
Personendaten aus Publikationen
Die Texte im SHAB enthalten Namen, Wohnorte und Funktionen von Personen. Wer sie für den Vertrieb nutzt, bearbeitet Personendaten.
- Zweck festlegen
- Nur übernehmen, was Sie für Ihren Zweck brauchen, etwa Name und Funktion der Geschäftsführung, nicht Wohnort oder Heimatort.
- Informieren
- In Ihrer Datenschutzerklärung angeben, dass Sie Daten aus öffentlichen Registern beziehen. Die AGB des Amtsblattportals verlangen ausdrücklich, das Datenschutzrecht einzuhalten.
- Ansprache
- Für Werbe-E-Mails gilt zusätzlich das UWG. Ein Eintrag im Handelsregister ist keine Einwilligung. Mehr dazu unter Cold E-Mail in der Schweiz.
- Aktuell halten
- Wer aus dem Register gelöscht wurde, gehört nicht mehr als Ansprechperson ins CRM.
Wofür sich die API eignet
Die Schnittstellen lohnen sich dort, wo Firmendaten regelmässig gebraucht werden. Drei Einsätze sind im Vertrieb am häufigsten.
Stammdaten abgleichen
UID, Firmenname und Adresse im CRM gegen das Register prüfen und gelöschte Firmen erkennen. Mehr dazu unter CRM für KMU.
Änderungen erkennen
Tägliche Publikationen nach Ihren Wunschkunden filtern. Was die Einträge bedeuten, steht unter Handelsregister als Kaufsignal.
Firmen eindeutig zuordnen
Über die UID statt über den Namen, damit ähnlich heissende Firmen nicht verwechselt werden.
Grenzen der Schnittstellen
Vor einem Projekt mit Registerdaten sollten Sie diese Punkte kennen. Sie entscheiden oft darüber, ob die API reicht oder ob es zusätzliche Quellen braucht.
- Kein Bezug der ganzen Datenbank
Laut Bundesamt für Justiz beschränkt sich Zefix auf Einzelabfragen mit Filtern. Abonnemente oder der Bezug der gesamten Datenbank werden nicht angeboten.
- Zugang nur auf Antrag
Zugangsdaten gibt es nicht per Selbstregistrierung, sondern auf Anfrage beim EHRA. Konditionen nennt das BJ nicht öffentlich, sie werden beim Antrag geklärt.
- Keine Personenliste
Wer Geschäftsführer oder Zeichnungsberechtigte braucht, muss sie aus dem Text der Publikationen lesen und dabei den Datenschutz beachten.
- Keine Rechtswirkung
Für einen verbindlichen Nachweis zählen die Publikation im SHAB und der Auszug aus dem kantonalen Register, nicht die API-Antwort.
- Datenqualität prüfen
Auch amtliche Daten können fehlen oder falsch kodiert sein. Ein Kanton weist in seinem offenen Datensatz selbst auf Probleme mit der Zefix-Schnittstelle hin.
- Inoffizielle Bibliotheken
Projekte auf GitHub verpacken dieselbe API für einzelne Programmiersprachen. Sie brauchen trotzdem Ihre eigenen Zugangsdaten und werden nicht vom Bund gepflegt.
Wer diese Seite geschrieben hat
Konstantin Malt hat Malt Consulting 2023 gegründet, damals unter dem Namen Digitalwahl. Er begleitet inhabergeführte Schweizer Unternehmen bei Positionierung, Website und Kundengewinnung und setzt dabei auch Signal-based Outreach sowie CRM- und Lead-Prozesse um.
- AusbildungBachelor in Betriebswirtschaft, Universität St. Gallen (HSG)
- ErfahrungÜber 120 Schweizer Unternehmen betreut seit 2023
- Geprüft28. Oktober 2026, gegen die offizielle API-Dokumentation und die Quellen unten
Häufige Fragen zur Zefix API
Kurz beantwortet, mit dem Stand der Dokumentation vom Oktober 2026.
Wie bekomme ich Zugang zur Zefix API?
Laut Bundesamt für Justiz beantragen Sie den Zugang per E-Mail an zefix@bj.admin.ch. Danach erhalten Sie Zugangsdaten für die Anmeldung per HTTP Basic Authentication.
Ist die Zefix API kostenlos?
Die Handelsregisterverordnung erlaubt, die im Internet gebührenfrei zugänglichen Firmendaten über Zefix oder eine technische Schnittstelle abzurufen. Konkrete Bedingungen für den API-Zugang veröffentlicht das BJ nicht. Klären Sie diese beim Antrag.
Liefert die Zefix API Geschäftsführer und Verwaltungsräte?
Nicht als eigene Felder. Das Schema der Firmendaten enthält keine Personenliste. Personen stehen im Text der SHAB-Publikationen, die die API mitliefert.
Gibt es eine offizielle SHAB API?
Laut den AGB des Amtsblattportals steht eine Schnittstelle für die Daten der Publikationen zur Verfügung. Eine öffentliche technische Dokumentation haben wir nicht gefunden. Handelsregisterpublikationen erhalten Sie dokumentiert über die Zefix API, andere Rubriken wie Konkurse nur über das SHAB selbst.
Kann ich alle Schweizer Firmen herunterladen?
Nicht über Zefix, das bietet nur Einzelabfragen. Kerndaten aller aktiven Firmen stellt das EHRA aber als offene Daten über opendata.swiss und LINDAS bereit.
Wie prüfe ich eine UID oder MWST-Nummer ohne Zefix-Zugang?
Über den öffentlichen Webservice des UID-Registers beim Bundesamt für Statistik. Er bietet laut Schnittstellenbeschreibung eine Prüfung der UID und der Mehrwertsteuernummer. Für einzelne Prüfungen reicht auch die Suche auf uid.admin.ch.
Gibt es ein Testsystem?
Ein Open-Source-Projekt nennt ein Integrationssystem unter www.zefixintg.admin.ch, dessen API-Dokumentation am 28. Oktober 2026 erreichbar war. Ob und wie Sie es nutzen dürfen, klären Sie mit dem EHRA.
Weiterlesen
Ob sich eigene Registerdaten lohnen oder zugekaufte Adressen reichen, steht unter B2B-Adressen kaufen. Wie Sie Firmen danach ansprechen, lesen Sie unter Kaltakquise in der Schweiz.
Quellen
- EHRA, «Zefix PublicREST API», OpenAPI-Dokumentation Version 2.7.2.4, abgerufen am 28.10.2026. zefix.admin.ch/ZefixPublicREST/swagger-ui/index.html
- I14Y Interoperabilitätsplattform, Datenservice «Zefix REST API», abgerufen am 28.10.2026. i14y.admin.ch/de/catalog/dataservices/6ef8f5d2-3d6a-4d84-bf60-5e65fde98a87
- Bundesamt für Justiz, «Handelsregister, Zefix und Regix», veröffentlicht am 9.2.2026. bj.admin.ch/bj/de/home/wirtschaft/handelsregister.html
- EHRA, Datensatz «Zefix, Zentraler Firmenindex», opendata.swiss, aktualisiert am 18.3.2025. opendata.swiss/de/dataset/zefix-zentraler-firmenindex
- Handelsregisterverordnung (HRegV, SR 221.411), Art. 14, Fassung gültig ab 1.10.2026, abgerufen am 28.10.2026. fedlex.admin.ch/eli/cc/2007/686/de
- SECO, Allgemeine Geschäftsbedingungen für die Nutzung des Amtsblattportals, Ziff. 2 und 3, Stand 7.6.2024. amtsblattportal.ch/static/agb_de.pdf
- Schweizerisches Handelsamtsblatt, Datenschutzerklärung (Stand 23.12.2024) und Hilfetexte, abgerufen am 28.10.2026. shab.ch
- Kanton Basel-Landschaft, «Firmenmutationen nach Rechtsform und Gemeinde», Hinweis zur Zefix-Schnittstelle, opendata.swiss, aktualisiert am 28.10.2026. opendata.swiss/de/dataset/firmenmutationen-nach-rechtsform-und-gemeinde-seit-februar-2016
- Bundesamt für Statistik, UID-Register, öffentlicher Webservice «PublicServices», Schnittstellenbeschreibung mit den Operationen GetByUID, Search, ValidateUID und ValidateVatNumber, abgerufen am 29.10.2026. uid-wse.admin.ch/V5.0/PublicServices.svc
- validitylabs, «zefix», inoffizieller Wrapper für die Zefix REST API, abgerufen am 28.10.2026. github.com/validitylabs/zefix
Registerdaten sauber nutzen?
Im Erstgespräch klären wir, welche Registerdaten Sie für Vertrieb oder CRM wirklich brauchen und welcher Zugang dafür ausreicht.
Lieber direkt? +41 78 814 14 58 oder info@maltconsulting.ch