---
title: "Priorisierte Prueffaelle des eigenen Portfolios"
method: GET
path: "/actions"
tags: ["Aktionen"]
---

# Priorisierte Prueffaelle des eigenen Portfolios

`GET /actions`

## Request

- Base URL: `https://firmenwatch.ch/api/v1`
- URL: `https://firmenwatch.ch/api/v1/actions`
- Auth: HTTP bearer

Liefert kuratiert erkannte Ereignisfolgen ausschliesslich fuer die Firmenlisten des durch den API-Schluessel bestimmten Kontos. Jeder Fall nennt die Version der ausloesenden Regel, eine konkrete Empfehlung und stabile, zum amtlichen SHAB rueckverfolgbare Ereignisbelege. version ist der opake Versionsstand fuer ein konkurrenzsicheres spaeteres PATCH. Die Priorisierung ist eine Arbeitshilfe, kein Bonitaetsurteil und keine rechtliche Entscheidung. status=resolved enthaelt auch systemisch geschlossene Faelle und entspricht nicht dem manuellen Entscheidarchiv.

## Query parameters

- `q` string
- `status` 'pending' | 'open' | 'snoozed' | 'resolved' | 'dismissed'
- `priority` 'critical' | 'high' | 'medium' | 'low'
- `limit` integer
- `offset` integer

## Response `200`

Priorisierte Prueffaelle, dringendste und danach neueste zuerst.

- object
  - `data` ActionCase[], required
    - `id` string, required: Oeffentliche, unveraenderliche Kennung des Prueffalls.
    - `version` string, required: Opaque Versionskennung. Fuer PATCH unveraendert als starker quoted If-Match-ETag senden.
    - `case_key` string, required: Deterministischer Entdopplungsschluessel fuer denselben Regel- und Firmenkontext.
    - `rule_code` 'leadership_signatory_gap' | 'organ_auditor_churn' | 'capital_reduction_officer_departure' | 'bankruptcy_opened_review' | 'liquidation_opened_review' | 'company_deletion_review' | 'master_data_change_review', required: Stabile Kennung der kuratierten Regel.
    - `rule_version` string, required: Fassung der Regel, die den Fall begruendet.
    - `status` 'pending' | 'open' | 'snoozed' | 'resolved' | 'dismissed', required
    - `priority` 'critical' | 'high' | 'medium' | 'low', required
    - `priority_score` integer, required: Numerische Sortierprioritaet innerhalb derselben Prioritaetsklasse.
    - `reason` string, required: Beobachtete Ereignisfolge in Klartext.
    - `recommendation` string, required: Naechster, bewusst als Pruefung formulierter Arbeitsschritt.
    - `facts` object, required: Versionierte, maschinenlesbare Messwerte und Fristen der ausloesenden Regel.
    - `triggered_at` string, date-time, required
    - `due_at` string, date-time, nullable, required
    - `opened_at` string, date-time, nullable, required
    - `snoozed_until` string, date-time, nullable, required
    - `resolved_at` string, date-time, nullable, required
    - `dismissed_at` string, date-time, nullable, required
    - `decision` ActionDecision, required
      - `outcome` 'action_taken' | 'no_action_needed' | 'forwarded' | 'not_relevant' | 'other', required: Strukturierter Ausgang der internen Pruefung. forwarded kann aus Kompatibilitaetsgruenden in frueheren Entscheiden vorkommen; neue API-Entscheide bieten es nicht an, weil Uebergaben ohne Wiedervorlage keinen geschlossenen Prozess bilden.
      - `note` string, required: Interner Ergebnis- und Entscheidungsnachweis des Kundenkontos.
      - `decided_by` string, required: Interne Nutzerkennung des Bearbeiters.
      - `decided_at` string, date-time, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `company` ActionCompany, required
      - `uid` string, required
      - `name` string, required
      - `slug` string, required
      - `canton` string, nullable, required
      - `town` string, nullable, required
      - `status` 'active' | 'in_liquidation' | 'bankrupt' | 'deleted', required
      - `url` string, uri, required
    - `watchlist` ActionWatchlist, required
      - `id` integer, required
      - `name` string, required
    - `annotation` ActionAnnotation, required
      - `reference` string, nullable, required: Eigene ERP-/CRM-Referenz.
      - `relationship_type` 'customer' | 'supplier' | 'mandate' | 'lead' | 'partner' | 'null', nullable, required: Private Beziehung des Kontos zur Firma; steuert nur den Arbeitskontext.
      - `owner` string, nullable, required: Intern zustaendige Stelle.
      - `own_rating` 'critical' | 'high' | 'normal' | 'low' | 'null', nullable, required: Vom Konto selbst gesetzte Geschaeftsrelevanz; kein Firmenwatch-Bonitaetsurteil.
      - `tags` string[], nullable, required: Eigene Schlagwoerter des Kontos.
      - `follow_up_at` string, date, nullable, required: Eigener Wiedervorlagetermin des Kontos.
    - `evidence` ActionEvidence[], required
      - `id` string, required: Stabile, aus Publikations-ID und Ereignisart abgeleitete Kennung. Sie bleibt bei einem Neuaufbau gleich.
      - `event_id` integer, required: Laufende Nummer der ausgewerteten normalisierten Ereigniszeile. Nicht als Cursor des Ereignisstroms verwenden.
      - `publication_id` string, uuid, required
      - `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
      - `summary` string, nullable, required
      - `official_url` string, uri, required: Direkter Beleg im amtlichen SHAB-Portal.
  - `total` integer, required: Gesamtzahl der Faelle fuer die gesetzten Filter vor limit.
  - `limit` integer, required
  - `offset` integer, required
  - `next_offset` integer, nullable, required: Offset der naechsten Seite; null am Ende.

## 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).
- `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)