---
title: "Erfasste Ereignisse einer Rechtseinheit"
method: GET
path: "/companies/{uid}/events"
tags: ["Firmen"]
---

# Erfasste Ereignisse einer Rechtseinheit

`GET /companies/{uid}/events`

## Request

- Base URL: `https://firmenwatch.ch/api/v1`
- URL: `https://firmenwatch.ch/api/v1/companies/{uid}/events`
- Auth: HTTP bearer

Die neuesten normalisierten, seit 2025-01-03 erfassten Ereignisse zu einer UID, neueste zuerst. Keine vollstaendige amtliche Gesamthistorie.

## Path parameters

- `uid` string, required

## Query parameters

- `limit` integer

## Response `200`

Ereignisliste.

- object
  - `data` Event[], required
    - `id` integer, required: Laufende Nummer, monoton steigend. In der Historie unveraendert eine ganze Zahl.
    - `event_id` string, required: Stabile, aus Publikations-ID und Ereignisart abgeleitete Kennung.
    - `type` 'new_registration' | 'name_change' | 'address_change' | 'seat_change' | 'purpose_change' | 'capital_change' | 'legal_form_change' | 'officer_added' | 'officer_removed' | 'auditor_change' | 'liquidation_opened' | 'liquidation_closed' | 'deletion' | 'bankruptcy_opened' | 'bankruptcy_suspended' | 'bankruptcy_closed' | 'moratorium' | 'debt_enforcement' | 'branch_opened' | 'branch_closed' | 'merger' | 'other', required: Normalisierter Ereignistyp.
    - `occurred_at` string, date, required: SHAB-Publikationsdatum.
    - `severity` integer, required: Relevanz des Ereignisses.
    - `canton` string, nullable, required
    - `summary` string, nullable, required: Eine Zeile Klartext zum Ereignis.
    - `payload` unknown, required
    - `source` object, required
      - `publication_id` string, uuid, required
      - `official_url` string, uri, required
  - `uid` string, required

## Other responses

- `400`: Ungueltige Anfrage (invalid_request).
- `401`: Kein oder ungueltiger Schluessel (unauthorized).
- `402`: Monatskontingent erschoepft (quota_exceeded).
- `403`: Abonnement nicht aktiv oder benoetigtes Schluesselrecht fehlt (forbidden).
- `404`: Keine Rechtseinheit mit dieser UID (not_found).
- `429`: Ratenbegrenzung erreicht (rate_limited).
- `500`: Unerwarteter Fehler (internal).
- `503`: Der Registerbestand wird gerade vollständig verifiziert (temporarily_unavailable). Dieselbe Abfrage später erneut senden.

---

[API](https://skmtc.dev/firmenwatch/apis/firmenwatch-api.md) · [All operations](https://skmtc.dev/firmenwatch/apis/firmenwatch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firmenwatch/apis/firmenwatch-api/revisions/65e774135677?raw)