jschwendener / zefix-php
PHP SDK for the Swiss Zefix REST API
v0.0.3
2024-09-10 16:39 UTC
Requires
- php: ^8.2
- saloonphp/saloon: ^3.0
- vlucas/phpdotenv: ^5.6
Requires (Dev)
- pestphp/pest: ^2.35
- phpstan/phpstan: ^1.12
README
This is a simple PHP wrapper around the Zefix Public REST API which can be used to search for swiss companies and retrieve their details. This package is not affiliated with the Zefix.
Installation
You can install the package via composer:
composer require jschwendener/zefix-php
Authentication
A valid username and password is required to access the Zefix API.
You can request access by sending an email to zefix@bj.admin.ch and providing the following information:
- An email address which will be used as username
- Additional email addresses which should receive information maintenance and updates of the API
Usage
Search for companies
Search for companies registered in the commercial register by different parameters
use Jschwendener\Zefix\Zefix; $zefix = new Jschwendener\Zefix\Zefix('username', 'password'); // Search for companies by name $results = $zefix->company()->search('company name'); // Search for companies by name and additional parameters $results = $zefix->company()->search('company name', [ 'canton' => 'ZH', 'activeOnly' => false, ]);
Get company details
Get detailed company info by UID
use Jschwendener\Zefix\Zefix; $zefix = new Jschwendener\Zefix\Zefix('username', 'password'); $details = $zefix->company()->getByUid('CHE-123.456.789');
Credits
This SDK is built using Saloon PHP.
The Zefix PHP SDK is open-sourced software licensed under the MIT license.