API Reference
The Business Identity Validator API allows you to find the Swiss enterprise identification number (UID) for a company or organisation, then retrieve company data and authorised signatories.
Every operation requires an OAuth 2.0 access token — see Authentication and Authorization. Which operations your subscription can call depends on your plan — see Plans and Base URLs. For status codes and handling guidance, see Errors and Status Codes.
Resources
Suggestions API
Search the UID and ZEFIX registers by name prefix or exact UID to find an organisation and its UID.
Organisations API
Look up organisations, query and validate signatories, and retrieve register excerpts.
Health API
Check the technical availability of the service.
All operations at a glance
| Resource | Method and path | Purpose |
|---|---|---|
| Suggestions | GET /suggestions | Search organisations by name prefix or exact UID |
| Organisations | GET /organisations/by-uid/{uid} | Retrieve organisation details by UID |
| Organisations | GET /organisations/by-name/{name} | Retrieve organisation details by exact legal name |
| Organisations | GET /organisations/{uid}/signatories | List authorised signatories |
| Organisations | GET /organisations/{uid}/signatories/rules | Return signing authorities and competences |
| Organisations | POST /organisations/{uid}/signatories/validate | Validate whether a signer combination can legally sign |
| Organisations | GET /organisations/{uid}/excerpt | Return the ZEFIX cantonal commercial-register excerpt |
| Organisations | GET /organisations/{uid}/excerpt-uid | Return excerpts from the Swiss UID register |
| Health | GET /health | Return service version and uptime |