Ereignisse

Ereignisstrom

Der chronologische Strom der seit 2025-01-03 erfassten Publikationen. Publikationen vor diesem Datum sind nicht verfuegbar. Fuer die laufende Abholung wird since_id empfohlen: die hoechste bereits verarbeitete sequence mitgeben, dann liefert die Antwort ausschliesslich Neues und es gehen keine Ereignisse verloren, wenn mehrere Publikationen am selben Tag erscheinen.

BRECHENDE AENDERUNG vom 26. August 2026: Das Feld id war bis zum 25. August 2026 die laufende Nummer (integer) und ist seither die stabile Kennung (string, z. B. fw1_7cb69d9f34d5dd79b7445c65071e6592). Die damalige laufende Nummer der ersten Fassung steht unter sequence; since_id und next_since_id beziehen sich weiterhin auf diese Stromposition.

Seit dem 27. August 2026 ist sequence eine append-only Stromposition. Eine Berichtigung behaelt ihre stabile id, erhaelt aber eine neue sequence, content_hash und revised_at und erscheint dadurch auch nach einem bereits gelesenen since_id erneut. Zu jedem since_id muss die zuletzt gelieferte epoch mitgesendet werden. Ein Neuaufbau oder eine Datenschutzredaktion antwortet mit 409 stream_reset und replay_from=0, statt historische Darstellungen still zu aendern.

get/events

Request

Base URL: https://firmenwatch.ch/api/v1
URL: https://firmenwatch.ch/api/v1/events
Auth: HTTP bearer

Query parameters

typesstring

Ereignistypen, kommagetrennt.

cantonsstring

Kantonskuerzel, kommagetrennt.

zipsstring

Postleitzahlen, kommagetrennt.

legal_formsstring

Rechtsformcodes nach eCH-0097, kommagetrennt.

industriesstring

Sichtbare Firmenwatch-Branchenklassifikationen aus dem eingetragenen Zweck (Konfidenz mindestens 0.45), kommagetrennt.

keywordsstring

Stichwoerter in Firmenname oder Zweck, kommagetrennt.

exclude_keywordsstring

Auszuschliessende Stichwoerter, kommagetrennt.

capital_minnumber

Untergrenze des aktuellen belegten CHF-Nominalkapitals der Firma. Der Filter bezieht sich auf company.capital, nicht auf ein historisches event_capital; Firmen ohne belegten CHF-Code werden ausgeschlossen.

capital_maxnumber

Obergrenze des aktuellen belegten CHF-Nominalkapitals der Firma. Der Filter bezieht sich auf company.capital, nicht auf ein historisches event_capital; Firmen ohne belegten CHF-Code werden ausgeschlossen.

fromstring date

Fruehestes Publikationsdatum, einschliesslich; nicht vor 2025-01-03.

tostring date

Spaetestes Publikationsdatum, einschliesslich; nicht vor 2025-01-03.

since_idinteger

Nur Fassungen mit hoeherer sequence als der angegebenen. Gemeint ist die append-only Stromposition aus sequence, nicht die stabile Kennung aus id. Wenn since_id gesetzt ist, ist epoch zwingend.

epochstring

Stromepoche aus dem Checkpoint oder letzten Ereignisabruf. Zusammen mit since_id zwingend. Bei Neuaufbau oder Datenschutzredaktion antwortet die API mit 409 stream_reset und verlangt einen Replay ab Sequenz 0.

min_severityinteger

Mindest-Relevanz des Ereignisses.

limitinteger

offsetinteger

Versatz ohne since_id; darf nicht mit since_id kombiniert werden.

Response

Ereignisstrom, aufsteigend nach sequence bei Verwendung von since_id, sonst neueste zuerst.

limitinteger required

next_since_idinteger

Sicher abgearbeitete Stromgrenze, direkt als since_id des naechsten Abrufs verwendbar. Kann bei einer leeren gefilterten Antwort bis zum geprueften High-Water vorruecken. Nicht die Kennung aus id.

stream_epochstring

Gegenwaertige Stromepoche; zusammen mit next_since_id speichern.

Example response

{
  "data": [
    {
      "id": "fw1_7cb69d9f34d5dd79b7445c65071e6592",
      "schema_version": "1.0",
      "sequence": 4813004,
      "status": "aktiv",
      "revised_at": null,
      "content_hash": "6cf4ec2e9b3974ec365594d54c4861c04362ee0176e56e143aff4a749c3f9151",
      "source": {
        "publication_id": "0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
        "published_at": "2026-08-25",
        "rubric": "HR01",
        "official_url": "https://www.shab.ch/#!/search/publications/detail/0a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"
      },
      "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": "Zuerich"
        },
        "purpose": "Handel mit Waren aller Art.",
        "capital": 250000,
        "capital_currency": "CHF",
        "capital_qualification": "current_registered_state",
        "capital_verification": "currency_evidenced",
        "capital_evidence_basis": "register_master_data_with_captured_currency_evidence",
        "industry": "Grosshandel ohne ausgepraegten Schwerpunkt",
        "industry_code": "46.90",
        "industry_confidence": 0.82,
        "industry_qualification": "derived",
        "industry_basis": "registered_purpose_text",
        "url": "https://firmenwatch.ch/firma/muster-handels-ag-zuerich"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.