API-Dokumentation

Firmensuche

Volltext- und Facettensuche über alle eingetragenen Rechtseinheiten. Ohne Suchbegriff stehen aktive, zuletzt veränderte Einträge zuoberst.

curl -s -G "https://firmenwatch.ch/api/v1/companies" \
  -H "Authorization: Bearer fw_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "q=Muster Handels" \
  --data-urlencode "canton=ZH" \
  --data-urlencode "status=active" \
  --data-urlencode "limit=25"

{
  "data": [
    {
      "uid": "CHE-000.000.000",
      "name": "Muster Handels AG",
      "slug": "muster-handels-ag-zuerich",
      "legal_form_code": "0106",
      "legal_form": "Aktiengesellschaft",
      "status": "active",
      "seat": "Zürich",
      "canton": "ZH",
      "capital": { "nominal": 250000, "paid": 250000, "currency": "CHF" },
      "last_event_at": "2026-08-24",
      "url": "https://firmenwatch.ch/firma/muster-handels-ag-zuerich"
    }
  ],
  "total": 1,
  "limit": 25,
  "offset": 0
}

Einzelabfrage per UID

Stammdaten einer Rechtseinheit samt bekannten Organen und den 50 neuesten Ereignissen. Der Pfadparameter nimmt jede übliche UID-Schreibweise entgegen.

curl -s "https://firmenwatch.ch/api/v1/companies/CHE-000.000.000" \
  -H "Authorization: Bearer fw_live_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "data": {
    "uid": "CHE-000.000.000",
    "name": "Muster Handels AG",
    "slug": "muster-handels-ag-zuerich",
    "legal_form_code": "0106",
    "legal_form": "Aktiengesellschaft",
    "status": "active",
    "seat": "Zürich",
    "canton": "ZH",
    "address": {
      "care_of": "c/o Muster Treuhand AG",
      "street": "Musterstrasse",
      "house_number": "12",
      "po_box": null,
      "zip": "8001",
      "town": "Zürich"
    },
    "purpose": "Handel mit Waren aller Art, insbesondere mit Büromaterial.",
    "capital": { "nominal": 250000, "paid": 250000, "currency": "CHF" },
    "industry": { "code": "46.90", "label": "Grosshandel ohne ausgeprägten Schwerpunkt" },
    "first_registered_at": "2019-03-14",
    "deleted_at": null,
    "last_event_at": "2026-08-24",
    "url": "https://firmenwatch.ch/firma/muster-handels-ag-zuerich",
    "officers": [
      {
        "name": "Muster, Anna",
        "kind": "person",
        "first_name": "Anna",
        "last_name": "Muster",
        "place_of_origin": "Bern",
        "function": "Mitglied des Verwaltungsrates",
        "role": "director",
        "signature": "Einzelunterschrift",
        "active": true,
        "from": "2019-03-14",
        "to": null
      }
    ],
    "timeline": [
      {
        "id": 4812993,
        "type": "address_change",
        "occurred_at": "2026-08-24",
        "canton": "ZH",
        "summary": "Neues Domizil: Musterstrasse 12, 8001 Zürich.",
        "severity": 40,
        "payload": {
          "field": "address",
          "after": "Musterstrasse 12, 8001 Zürich"
        }
      }
    ]
  }
}

Organe

Die eingetragenen Personen mit Funktion und Zeichnungsberechtigung. Standardmässig nur amtierende Organe.

curl -s "https://firmenwatch.ch/api/v1/companies/CHE-000.000.000/officers?include_former=true" \
  -H "Authorization: Bearer fw_live_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "data": [
    {
      "name": "Muster, Anna",
      "kind": "person",
      "first_name": "Anna",
      "last_name": "Muster",
      "place_of_origin": "Bern",
      "function": "Mitglied des Verwaltungsrates",
      "role": "director",
      "signature": "Einzelunterschrift",
      "active": true,
      "from": "2019-03-14",
      "to": null
    },
    {
      "name": "Beispiel, Peter",
      "kind": "person",
      "first_name": "Peter",
      "last_name": "Beispiel",
      "place_of_origin": "Basel",
      "function": "Geschäftsführer",
      "role": "managing_officer",
      "signature": "Kollektivunterschrift zu zweien",
      "active": false,
      "from": "2019-03-14",
      "to": "2024-11-06"
    }
  ],
  "uid": "CHE-000.000.000"
}

Historie

Die neuesten normalisierten Ereignisse zu einer UID, neueste zuerst.

curl -s "https://firmenwatch.ch/api/v1/companies/CHE-000.000.000/events?limit=50" \
  -H "Authorization: Bearer fw_live_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "data": [
    {
      "id": 4790112,
      "type": "officer_removed",
      "occurred_at": "2024-11-06",
      "canton": "ZH",
      "summary": "Beispiel, Peter, Geschäftsführer, ist ausgeschieden.",
      "severity": 50,
      "payload": {
        "persons": [{ "name": "Beispiel, Peter", "role": "managing_officer" }]
      }
    }
  ],
  "uid": "CHE-000.000.000"
}

Ereignisstrom

Der chronologische Strom aller Publikationen. Grundlage für Lead-Feeds und Portfolioüberwachung.

Mit since_id lässt sich der Strom lückenlos abholen: die höchste bereits verarbeitete ID mitgeben, das Feld next_since_id der Antwort speichern und beim nächsten Abruf verwenden. Eine Blätterung über Datum und Versatz verliert dagegen Ereignisse, sobald an einem Tag mehrere Publikationen nachträglich eintreffen.

curl -s -G "https://firmenwatch.ch/api/v1/events" \
  -H "Authorization: Bearer fw_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "types=new_registration" \
  --data-urlencode "cantons=ZH,ZG" \
  --data-urlencode "since_id=4812993" \
  --data-urlencode "limit=100"

{
  "data": [
    {
      "id": 4813004,
      "type": "new_registration",
      "occurred_at": "2026-08-25",
      "summary": "Neueintragung: Muster Handels AG",
      "severity": 60,
      "payload": {
        "legalForm": "Aktiengesellschaft",
        "capital": "250000.00"
      },
      "company": {
        "uid": "CHE-000.000.000",
        "name": "Muster Handels AG",
        "legal_form": "Aktiengesellschaft",
        "canton": "ZH",
        "address": {
          "care_of": null,
          "street": "Musterstrasse",
          "house_number": "12",
          "zip": "8001",
          "town": "Zürich"
        },
        "purpose": "Handel mit Waren aller Art.",
        "capital": 250000,
        "industry": "Grosshandel ohne ausgeprägten Schwerpunkt",
        "url": "https://firmenwatch.ch/firma/muster-handels-ag-zuerich"
      }
    }
  ],
  "limit": 100,
  "next_since_id": 4813004
}

UID prüfen und normalisieren

Prüft Format und Prüfziffer nach der Spezifikation des Bundesamts für Statistik (Modulo 11 mit den Gewichten 5, 4, 3, 2, 7, 6, 5, 4) und schlägt die UID anschliessend im Bestand nach.

Eine formal gültige UID muss nicht eingetragen sein: valid undfound sind bewusst getrennt. Für eine Onboarding-Prüfung ist in der Regel beides zu verlangen.

curl -s -X POST "https://firmenwatch.ch/api/v1/uid/validate" \
  -H "Authorization: Bearer fw_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"uid":"CHE-000.000.000"}'

{
  "data": {
    "valid": true,
    "normalized": "CHE-000.000.000",
    "found": false,
    "company": null
  }
}

Betriebszustand

Zeigt, bis zu welchem SHAB-Publikationsdatum der Bestand nachgeführt ist. Geeignet für die eigene Überwachung.

Dieser Endpunkt ist öffentlich und benötigt keinen API-Schlüssel. Bei veralteten Daten oder nicht erreichbarer Datenbank antwortet er mit HTTP 503.

curl -s "https://firmenwatch.ch/api/v1/health"

{
  "ok": true,
  "latest_publication": "2026-08-25",
  "data_age_days": 1,
  "entities": 0,
  "events": 0,
  "publications": 0
}

Die Zahlen im Beispiel sind Platzhalter. Massgebend ist der Wert, den die Schnittstelle zum Abfragezeitpunkt zurückgibt.