Skip to main content
This guide is outdated and will be removed on 1 November 2026. The up-to-date Switzerland reference is on the Switzerland country page.

Start here

This guide contains public integration notes for Switzerland. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.

Switzerland coverage, pricing, and sources

Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.

Table of Contents

Data Sources

Switzerland uses official federal and cantonal sources. In verification mode, company data comes from a live Zefix lookup. In prefill mode, a limited company identity comes from the published Zefix linked-data index. Legal representatives and other key persons are extracted from the official cantonal trade register extract in verification mode, with SOGC publications as a fallback for legal representatives.

All company types

  • Zefix (Zentraler Firmenindex): The Central Business Name Index, operated by the Federal Office of Justice (FOJ) since 2004. Zefix aggregates data from all 26 cantonal commercial registers into a single searchable index via a REST API. Live Zefix lookups provide verification-mode company data: legal name, status, legal form, registered address, share capital, activity description (purpose), and identifiers. Zefix data is sourced from the cantonal commercial registers, which are the authoritative registers of record.
  • Zefix linked-data index: A regularly imported copy of company identity fields for prefill. It provides name, UID, EHRA ID, legal form, and seat (city and canton). It does not distinguish active companies from companies being cancelled, and it omits cancelled companies. The response therefore does not claim a company status.
  • SOGC/SHAB (Swiss Official Gazette of Commerce): The Schweizerisches Handelsamtsblatt / Feuille officielle suisse du commerce, published electronically since 2002 and managed by SECO. All commercial register mutations are published in the SOGC as structured text. Used for two purposes: (1) as a fallback source for legal representatives via AI parsing of publication texts, used when the cantonal trade register extract is unavailable (this fallback is less complete); (2) as the source for the Certificate of Incorporation document (the SOGC publication announcing the initial registration).

Cantonal Commercial Registers (for documents)

Switzerland has 26 cantonal commercial registers (Handelsregisterämter), each maintaining the register of companies domiciled in that canton. While Zefix serves as the central index for company data, the cantonal registers issue the Trade Register Extract documents. Trade register extracts are issued by the relevant cantonal commercial register for all 26 cantons; delivery typically takes a few seconds. The same extract is the source of legal representatives and other key persons.
The cantonal commercial registers are the authoritative source of record. Zefix aggregates their data into a searchable central index but does not itself issue official documents. Trade register extracts are issued by the relevant cantonal register.

Company Identifiers

Query Identifiers

UID Format Breakdown: CHE408600128 = CHE + 8 digits assigned at random + 1 check digit. The register also writes it CHE-408.600.128; the dots and hyphen are only for readability. The UID (Unternehmens-Identifikationsnummer) is assigned by the Federal Statistical Office and is permanent.Check digit: weight the first eight digits 5, 4, 3, 2, 7, 6, 5, 4 and sum them. The check digit is 11 minus the sum modulo 11 (0 when the remainder is 0; a result of 10 is never issued).

Identifiers in API Response

Once you retrieve company data, the identifiers object contains all available identifiers for that entity: GLEIF is the supplementary data source for this identifier. company.identifiers.lei is optional. It is returned when the Swiss UID (uid) matches exactly one LEI through a GLEIF registration or validation reference. The Legal Entity Identifier has 20 uppercase alphanumeric characters, ending in two check digits. Coverage varies by entity. An absent lei does not prove that the company has no LEI. Lapsed, retired or merged LEIs may be returned; annulled LEIs are excluded.

Search Capabilities

Search Performance: Use UID-based searches for best performance and exact matching. Name searches query the Zefix API and may return multiple results. All UID formats (dotted, compact, or the 9 digits alone) are accepted for both search and company data.
Search combines the published Zefix index with live Zefix lookups. Name searches require a minimum of 3 characters and a maximum of 100 characters. Live results can include more status detail than the index.

Active companies only

With activeOnly=true, results are checked against live Zefix before they are returned, also in streamed results, which removes companies being cancelled whenever Zefix also finds them. The linked-data index has no reliable status field, so a result only the index finds is kept, and the filter stays partial for Switzerland. Request the company datapoint in verification mode when status matters.

Quirks & Gotchas

Mappings

Company Status

Company status comes from Zefix. active is true only for the ACTIVE status. CANCELLED companies with a deletion date map to Closed with that closure date; other statuses are classified into the standard categories.
When a company has status CANCELLED and a deletionDate is present, the deletion date is used as the closureDate in the statusDetails response. The BEING_CANCELLED status corresponds to companies undergoing liquidation proceedings.
Switzerland uses the eCH-0097 data standard (Datenstandard Unternehmensidentifikation) for legal form classification. The system maps all 38 eCH-0097 codes deterministically to standardized forms and, where one exists, to their ISO 20275 (ELF) code. No AI inference is involved for codes with an ISO 20275 mapping.
Multilingual legal form names: Swiss legal form names from Zefix come in the registration language of the company (German, French, Italian, or English). The legalForm.localName reflects this. The eCH-0097 code is used for deterministic mapping regardless of language.
The full eCH-0097 specification is available at eCH. ISO 20275 ELF codes are maintained by GLEIF. All 38 Swiss legal form codes are deterministically mapped, so no AI enrichment is needed for any code that has an ISO 20275 mapping.
Legal representatives are extracted from the official cantonal trade register extract (Handelsregisterauszug / extrait du registre du commerce). Zefix publishes no structured officer roster, so the extract’s own person table — which states each person’s role and signing authority — is fetched and parsed by AI. It may be in German, French, Italian or English depending on the canton. legalRepresentatives contains people with recorded signing authority. representationMode states sole or joint signing when that rule can be read unambiguously. Known office labels use published translations and standardized values for the recorded signing context. Board members the register lists without signing authority, and the statutory auditor, are returned under otherKeyPersons instead — see Listing the full board. If a cantonal portal is temporarily unavailable, the answer falls back to AI parsing of SOGC publications (Swiss Official Gazette of Commerce), which is less complete.
Signature types documented in SOGC publications:
  • mit Einzelzeichnung / avec signature individuelle / con firma individuale = individual signature rights
  • mit Kollektivzeichnung zu zweien / avec signature collective a deux / con firma collettiva a due = joint signature rights (two jointly)
Whether a person is a legal representative or an other key person is decided by the extract’s own “Signing authority” column, not by their job title: anyone the register grants signing authority is a legal representative; anyone it lists without is an other key person. A “Mitglied des Verwaltungsrates” (Board Member) is therefore a legal representative when they can sign and an other key person when the extract says “without signing authority” — in both cases they carry corporateBody: "board". Both individuals and corporate entities can hold roles.

Representation Mode

Legal representatives include a representationMode field indicating signing authority:
  • { mode: "sole" }: Can sign alone (“mit Einzelzeichnung” / “avec signature individuelle” / “con firma individuale”)
  • { mode: "joint", minimumSignatories: 2 }: Must sign jointly with one other (“mit Kollektivzeichnung zu zweien” / “avec signature collective à deux” / “con firma collettiva a due”)
  • { mode: "joint", minimumSignatories: N }: Must sign jointly with a specified number of others
  • null: only possible on the SOGC fallback path; on the cantonal-extract path a person with no signing authority is returned under otherKeyPersons instead
The field is extracted from the extract’s “Signing authority” / “Zeichnungsart” / “Signature mode” column.

Other Key Persons

People the cantonal extract lists without signing authority. They cannot bind the company, which is why they are not returned as legal representatives. Requires the cantonal extract. For a company Zefix publishes no cantonal extract link for, this datapoint returns a no_document_available error rather than an empty list, and is not billed.

Listing the full board

Because the split is by signing authority, a company’s board of directors can span both arrays. Every person carries a corporateBody field naming the body they sit on (board, supervisoryBoard, management, audit; absent for an authorized signatory, who holds a power of attorney rather than a seat). Filter across both arrays:
Switzerland has no separate supervisory organ: the Verwaltungsrat is the board of directors, so supervisoryBoard is never returned for a Swiss company.

Shareholders

Shareholder data is not currently available for Swiss companies. The Swiss commercial register (Zefix) and SOGC publications do not provide structured shareholder or ownership data in a programmatically accessible format.

Activity Code Mapping

Switzerland does not use a national activity code classification in the Zefix registry. Activity codes are AI-inferred from the company’s purpose (Zweck / But / Scopo) field, which is a free-text description of the company’s business activities.
Both NACE and ISIC codes are always AI-inferred for Swiss companies because the Zefix registry provides only a free-text activity description, not structured activity codes. The isAIInferred flag is always true for Swiss activity codes. The single code inferred from the purpose text is also flagged with isMainActivity: true. Since that code is AI-inferred, it is distinguishable from a main activity a register would declare itself; an absent flag means the source did not designate one.

Data Availability

Data Availability Matrix

Legend: ✅ Available | ❌ Not Available | ⚠️ Conditionally Available | Async = Asynchronous processing

Documents by Company Type

Canton-specific document retrieval: Trade register extracts are issued by the relevant canton’s register, selected automatically from the company’s cantonal registration. Delivery typically takes a few seconds.

Example API Responses

All examples use placeholder data. Query: POST /v2/company with { "id": "<id>", "countryCode": "CH", "dataPoints": ["company", "legalRepresentatives"] }
Note: Closed companies have active: false with a closureDate when available. Legal representatives and other key persons may not be available for dissolved companies when the cantonal register publishes no extract for them.
Note: Sole proprietorships (Einzelunternehmen / Entreprise individuelle / Ditta individuale) use the owner’s name as the legalName. Legal representatives are not typically present.
Documents are returned when "dataPoints": ["availableDocuments"] is requested.

Data Source Priority & Routing

Verification mode uses a live Zefix lookup for company data. Prefill mode uses the published Zefix index for a limited company identity. Legal representatives and other key persons come from the official cantonal trade register extract via AI parsing in verification mode, with SOGC publications as a fallback for legal representatives only.
Source Routing:
  1. Prefill company identity (name, UID/EHRA ID, legal form, city/canton): Zefix linked-data index; no status claim
  2. Verification company data (name, status, legal form, address, capital, purpose, identifiers): Zefix API (live query via REST API)
  3. Legal representatives and other key persons: Cantonal trade register extract (AI-parsed, split by signing authority). If the extract is unavailable, legal representatives fall back to SOGC publications (less complete); other key persons have no fallback
  4. Activity codes: AI-inferred from the free-text purpose field in verification mode
  5. Legal form standardization: Deterministic eCH-0097 to ISO 20275 mapping (AI only used as fallback if eCH-0097 code is not in the mapping table)
  6. Status enrichment: AI-enriched for detailed status information in verification mode

Attribute-Level Source Mapping