# Swiss Commercial Register Lookup (Zefix)

> Swiss Commercial Register Lookup (Zefix) is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Search or retrieve full company profiles from the official Swiss commercial register via the Zefix API, including UID, legal form, status, canton, registered seat, purpose, and capital.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/ch/company
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/swiss-commercial-register-lookup-zefix-2abb7f10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_25l6Ze2r88b6BtKUC_wxp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability swiss-commercial-register-lookup-zefix-2abb7f10
```

Example prompt: Can you look up the official Swiss commercial register record for Swisscom — I need their UID, legal form, current status, and registered canton from the Zefix database?

## When to prefer this

Use this endpoint when you need authoritative, official Swiss company data sourced directly from the Federal Office of Justice Zefix registry. Prefer it over general business search tools when you need legally reliable UID, legal form, or status for KYC, compliance, due diligence, or invoicing workflows. Best for Swiss-domiciled entities; for other European registries use the sibling French (Sirene), EU-wide (GLEIF LEI), or eu-verify endpoints.

## Known failure modes

- Company name shorter than 3 characters returns validation error
- No matching companies found returns empty results list
- Invalid UID format (not CHE-xxx.xxx.xxx) returns error
- Invalid CH-ID format returns error
- Canton filter not a valid 2-letter Swiss canton code returns error
- Limit outside 1-20 range returns validation error
- Payment not received returns 402 Payment Required
- Rate limit exceeded returns 429 Too Many Requests
- Zefix upstream unavailable returns 503

## How this service works

Official Swiss commercial register via Zefix (Federal Office of Justice). Search: ?q=swisscom (company name, 3+ chars) returns matches with UID, legal form and status. Profile: ?uid=CHE-105.909.036 (or ?chid=CH-...) returns the full record: legal form, status, canton, registered seat, purpose, capital and the official Zefix/cantonal excerpt links. Optional canton, active_only, limit (1-20). Sole-proprietor home addresses withheld (GDPR). 24h cache.

## Output

For a name search: a list of matching Swiss companies (up to 20), each with name, UID, legal form, and active/cancelled status. For a UID or CH-ID lookup: the full Zefix company profile including legal form, status, canton, registered seat, business purpose, share capital, and links to the official Zefix and cantonal excerpt pages. Sole-proprietor home addresses are withheld per GDPR. Results are cached for 24 hours.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "description": "Company name to search (3+ chars, substring)"
      },
      "uid": {
       "type": "string",
       "description": "Swiss UID for the full record, e.g. CHE-105.909.036"
      },
      "chid": {
       "type": "string",
       "description": "Swiss CH-ID, e.g. CH-020.3.926.598-9"
      },
      "limit": {
       "type": "integer",
       "default": 5,
       "description": "Max search results (1-20)"
      },
      "canton": {
       "type": "string",
       "description": "Filter search by 2-letter canton, e.g. ZH"
      },
      "active_only": {
       "type": "boolean",
       "default": true,
       "description": "false = include cancelled companies in search"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/swiss-commercial-register-lookup-zefix-2abb7f10/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)