Alert-Driven Monitoring: Get Notified When Swiss Companies Match Your Criteria

Manual checking is tedious and unreliable. If you are monitoring Swiss companies for status changes, new incorporations, or auditor rotations, you need a system that watches for you. The VynCo alert evaluation feature does exactly that: save a search, attach an alert, and get notified when the results change.

Step 1: Save a Search

Alerts are built on top of saved searches. First, define the criteria you care about:

from vynco import VynCoClient

client = VynCoClient()

saved = client.saved_searches.create(
    name="ZH AG Capital >1M",
    query_params={
        "canton": "ZH",
        "legal_form": "AG",
        "min_capital": 1000000,
        "status": "active"
    }
)
print(f"Saved search ID: {saved.id}")

This search matches all active Zurich-based AG companies with registered capital above CHF 1 million. The search is stored in your account and can be re-executed at any time.

Step 2: Create an Alert

Now attach an alert to that saved search. You choose the frequency and optionally provide a webhook URL:

alert = client.alerts.create(
    saved_search_id=saved.id,
    frequency="daily",
    webhook_url="https://your-app.com/webhooks/vynco"
)
print(f"Alert ID: {alert.id}")

Frequency Options

Choose based on how time-sensitive your monitoring is. Compliance teams tracking sanctions exposure typically use daily. Trading desks monitoring corporate actions might prefer hourly.

How the Pipeline Works

Behind the scenes, the alert evaluation pipeline runs every hour. On each run, it:

1. Re-executes your saved search with the original query parameters
2. Compares the current result set against the previous snapshot
3. Identifies changes: new matches, removed matches, and field-level changes on existing matches
4. If any changes are detected, triggers a notification

This means you get alerted when a new company appears in your results, when a company drops out (e.g., dissolved), or when a matching company changes its auditor, capital, or status.

Notification Delivery

When an alert fires, two things happen:

In-app notification: A notification appears in your VynCo portal dashboard. You will see it in the notification bell with a summary of what changed.

Webhook delivery (optional): If you provided a webhook URL, VynCo sends a POST request with the change payload. Every webhook request is signed with HMAC-SHA256, so you can verify authenticity:

import hmac
import hashlib

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

The signature is sent in the X-VynCo-Signature header.

Complete Workflow Example

Here is a realistic use case: "Notify me when any Zurich-based AG with capital above CHF 1M changes its auditor."

# 1. Save the search
saved = client.saved_searches.create(
    name="ZH AG >1M Auditor Watch",
    query_params={
        "canton": "ZH",
        "legal_form": "AG",
        "min_capital": 1000000
    }
)

# 2. Create a daily alert with webhook
alert = client.alerts.create(
    saved_search_id=saved.id,
    frequency="daily",
    webhook_url="https://your-app.com/webhooks/vynco"
)

# 3. When a company changes auditor, you receive:
# - An in-app notification in the portal
# - A signed webhook POST to your endpoint

No polling. No cron jobs. No manual checks. The pipeline handles evaluation, diffing, and delivery.

Get Started

Alerts are available on all paid plans. Save your first search in the portal or via the API, then attach an alert to start monitoring.

Ready to automate your monitoring? Get your API key at vynco.ch/pricing.