Swiss Company Registry

Search and validate Swiss companies through the two official registries, behind one facade and interchangeable providers:

• Zefix (Central Business Name Index, REST): every entity recorded in the cantonal commercial registers, with purpose, capital and excerpt links.
• UID register (Federal Statistical Office, SOAP): every holder of a Swiss enterprise identification number, including entities outside the commercial register, plus the authoritative ValidateUID and ValidateVatNumber operations.

Requirements

• PHP 8.3+
• Laravel 12 or 13

Installation

composer require kokonut-ch/laravel-swiss-company-registry

The UID register needs no credentials. Zefix requires free API credentials from the Federal Office of Justice:

ZEFIX_USERNAME=your-username
ZEFIX_PASSWORD=your-password

No credentials yet? Set SWISS_COMPANY_REGISTRY_PROVIDER=uid-register and every call is served by the UID register. Publishing the config file, caching, locales and the test environment are covered in docs/configuration.md.

Usage

use Kokonut\SwissCompanyRegistry\Facades\SwissCompany;

SwissCompany::search('Boulangerie Muster');      // company search across the registries
// or SwissCompany::suggest('muster');           // autocomplete alternative: matches anywhere

SwissCompany::find('CHE-123.456.788');           // full record: legal form, address, canton
SwissCompany::validateVatId('CHE-123.456.788');  // Active | Inactive | Unknown

// ----------------

use Kokonut\SwissCompanyRegistry\Facades\SwissUid;

SwissUid::parse('che 123 456 788')->formatVat();  // "CHE-123.456.788 TVA", offline

Providers at a glance

Every call is routed to the first provider that offers the capability and supports the query filters; provider failures surface as exceptions, never as a silent switch. Choosing the default provider, forcing one per call and the production/test switch are covered in docs/providers.md and docs/configuration.md.

Documentation

docs/README.md indexes all of the above, plus the feature highlights and the roadmap.

Development

composer test   # phpstan + pint + type coverage + pest
composer lint   # auto-fix code style

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please review our contributing guide to get started.

Security

Please review our security policy on how to report security vulnerabilities.

Credits

How this package was built

The providers, the value objects, the test suite and this documentation were written with Claude Code. During development every integration decision was checked against the live registries: the Zefix REST endpoints and the UID register SOAP operations were probed for real, search modes, XML namespaces and fault shapes included, and the test fixtures mirror responses captured from those probes.

Everything was then reviewed by the Kokonut team before release. That review covers the code and the interface mapping, not the registry data itself: what the registries answer is what you get.

Reference

The data and the interface contracts come from the two official Swiss registries: the publicly documented Zefix REST API (Federal Office of Justice) and the UID register SOAP Public Services (Federal Statistical Office), including the eCH-0097 check-digit algorithm. No source code was copied from either administration; see NOTICE.

This package is an independent client for those two registries. It is not affiliated with, nor endorsed by, the Swiss federal administration, Zefix or the UID register.

Authors

• Kokonut
• All Contributors

License

Swiss Company Registry is open-sourced software licensed under the MIT license.