Anwendungsfälle · 29.09.2026
Ein Schweizer Unternehmen anhand der UID prüfen
Kunden-Onboarding, Lieferantenprüfung, Rechnungsstellung: Firmenname, Rechtsform und Adresse eines Schweizer Unternehmens mit einer einzigen Abfrage aus dem Handelsregister.
Wenn sich ein neuer B2B-Kunde anmeldet, stellen sich drei Fragen: Gibt es das Unternehmen? Wie lautet die genaue Firma? Ist die Adresse aktuell? Die amtliche Antwort steht im Handelsregister (Zefix). Wir synchronisieren es jede Nacht: rund 800 000 Unternehmen mit UID, Rechtsform, Sitz und Zweck.
Der Anwendungsfall
Nehmen wir ein Treuhandbüro mit Dutzenden neuer Mandate pro Woche. Ohne API kopiert eine Mitarbeiterin jede UID in Zefix und überträgt die Felder von Hand. Mit der API ruft die Software bei der Eingabe der UID unsere API auf und füllt das Kundendossier vor.
Suche nach UID
Die UID wird CHE-138.647.564 geschrieben; die API erwartet sie ohne Striche und Punkte:
curl -H "Authorization: Token IHR_SCHLUESSEL" \
"https://opendata.altius-group.ch/economics/swissenterprise/api/v1/companies/?uid=CHE138647564"
Die Antwort enthält legal_name, uid_formatted, full_address, canton_code und die Rechtsform auf Deutsch, Französisch und Italienisch. count gleich 0 bedeutet, dass kein aktives Unternehmen diese UID trägt – das Signal für eine manuelle Prüfung.
Suche nach Namen
Tippt der Benutzer einen Namen statt einer UID, sortiert der Parameter search die Treffer nach Relevanz (exakter Name, dann Namensanfang, dann Inhalt):
curl -H "Authorization: Token IHR_SCHLUESSEL" \
"https://opendata.altius-group.ch/economics/swissenterprise/api/v1/companies/?search=altius group"
Kundendaten aktuell halten
Unternehmen ändern ihren Namen und ziehen um. Unsere Datenbank übernimmt diese Änderungen jede Nacht, gelöschte Unternehmen verschwinden. Eine monatliche Prüfung Ihrer Kundendaten per UID genügt, um Änderungen zu erkennen.
Gut zu wissen
- Die Suche nach UID ist exakt und schnell: Die UID ist der beste Identifikator.
- Die Daten stammen vom Bundesamt für Justiz; sie ersetzen keinen beglaubigten Handelsregisterauszug.
- Der Gratisplan (100 Abfragen pro Tag) reicht zum Testen; die kommerzielle Nutzung erfordert einen kostenpflichtigen Plan.