Quickstart-Anleitung

Erstellen Sie ein kostenloses VynCo-Konto — keine Kreditkarte erforderlich. Navigieren Sie anschliessend zur Seite API-Schlüssel in Ihrem Dashboard und erstellen Sie einen neuen Schlüssel. Der Free-Tarif umfasst 60 search/h und 60 standard/h, um die API kostenlos zu erkunden.

Verwenden Sie GET /companies zur Suche im Zefix-Register. Übergeben Sie einen Firmennamen im search Parameter. Jede Abfrage zählt als eine search_read-Anfrage gegen Ihr Ratenlimit.

curl "https://vynco.ch/api/v1/companies?search=Nestl%C3%A9&pageSize=5" \
  -H "Authorization: Bearer vc_live_abc123..."

Grenzen Sie die Ergebnisse nach Kanton und changed_since-Zeitstempel ein. Kombinieren Sie mehrere Filter in einer einzigen Anfrage.

# Filter by canton
curl "https://vynco.ch/api/v1/companies?canton=ZH&pageSize=10" \
  -H "Authorization: Bearer vc_live_abc123..."
# Filter by canton and changed_since
curl "https://vynco.ch/api/v1/companies?canton=GE&changed_since=2025-01-01T00:00:00Z" \
  -H "Authorization: Bearer vc_live_abc123..."

Rufen Sie das vollständige Profil eines bestimmten Unternehmens über seine UID ab (Format: CHE-xxx.xxx.xxx). Angereicherte Profile enthalten Aktienkapital, Branche und Revisionsstellenkategorie — verfügbar ab dem Starter-Tarif.

curl "https://vynco.ch/api/v1/companies/CHE-109.322.551" \
  -H "Authorization: Bearer vc_live_abc123..."

{
  "uid": "CHE-109.322.551",
  "name": "Nestlé S.A.",
  "canton": "VD",
  "status": "Active",
  "legalForm": "Aktiengesellschaft",
  "shareCapital": 322000000,
  "currency": "CHF",
  "industry": "Food Products",
  "auditorName": "KPMG AG",
  "auditorCategory": "state-supervised",
  "enrichmentLevel": "Enriched",
  "updatedAt": "2026-04-12T05:01:50Z"
}

Inspizieren Sie alle gruppenspezifischen Ratenlimit-Buckets für Ihren API-Schlüssel mit GET /v1/usage/current. Dieser Aufruf verbraucht keine Anfrage aus einem anderen Kontingent. Jede API-Antwort liefert zudem x-ratelimit-* Header zurück, damit Sie die verbleibende Kapazität pro Aufruf überwachen können.

curl "https://vynco.ch/api/v1/usage/current" \
  -H "Authorization: Bearer vc_live_abc123..."

{
  "tier": "starter",
  "groups": [
    { "group": "search_read",      "used": 412,  "limit": 600,  "window": "hour", "resetSeconds": 1842 },
    { "group": "standard_read",    "used": 86,   "limit": 600,  "window": "hour", "resetSeconds": 1842 },
    { "group": "analytics_read",   "used": 5,    "limit": 60,   "window": "hour", "resetSeconds": 1842 },
    { "group": "methodology_read", "used": null, "limit": null, "window": "hour", "resetSeconds": 1842 },
    { "group": "expensive_ai",     "used": null, "limit": null, "window": "day",  "resetSeconds": 51234 },
    { "group": "bulk",             "used": null, "limit": null, "window": "day",  "resetSeconds": 51234 }
  ]
}

HTTP/2 200
content-type: application/json
x-ratelimit-group: search_read
x-ratelimit-window: hour
x-ratelimit-limit: 600
x-ratelimit-remaining: 187
x-ratelimit-reset: 1746527200
x-request-id: req_01HZJ8K3...

Sobald Daten fliessen, erschliessen Sie tiefere Erkenntnisse mit den Analytics-Endpoints. Verwenden Sie POST /analytics/cluster für K-Means- oder GMM-Clustering, POST /analytics/anomalies für Anomalie-Erkennung oder GET /analytics/cohorts für Kohorten-Aufschlüsselungen nach Kanton, Rechtsform, Gründungsjahr oder Revisionsstelle. Diese Aufrufe zählen gegen analytics_read und erfordern den Starter-Tarif oder höher.

# Run K-Means clustering on Zurich companies
curl -X POST "https://vynco.ch/api/v1/analytics/cluster" \
  -H "Authorization: Bearer vc_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"algorithm":"kmeans","k":5,"canton":"ZH"}'

# Cohort analysis grouped by legal form
curl "https://vynco.ch/api/v1/analytics/cohorts?groupBy=legal_form" \
  -H "Authorization: Bearer vc_live_abc123..."

Verwenden Sie POST /v1/screening um eine Entität in einer einzigen Anfrage gegen SECO-Sanktionen, OpenSanctions (PEP-Listen) und FINMA-regulierte Entitäten zu screenen. Die Antwort enthält ein Risikoniveau sowie alle erkannten Treffer.

# Screen an entity against SECO, OpenSanctions, and FINMA
curl -X POST "https://vynco.ch/api/v1/screening" \
  -H "Authorization: Bearer vc_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Nestlé SA","sources":["seco","finma","opensanctions"]}'

{
  "queryName": "Nestlé SA",
  "queryUid": null,
  "screenedAt": "2026-03-30T10:00:00Z",
  "hitCount": 0,
  "riskLevel": "clear",
  "hits": [],
  "sourcesChecked": ["seco", "finma", "opensanctions"]
}

Verwenden Sie GET /v1/auditor-tenures um Unternehmen mit langer Revisionsstellen-Mandatsdauer aufzulisten. Setzen Sie min_years=10 um Kandidaten für die ISS-Rotation zu finden. Dieser Endpoint ist öffentlich und erfordert keine Authentifizierung.

# Find companies with auditor tenures >= 10 years (ISS rotation candidates)
# This endpoint is public — no authentication required
curl "https://vynco.ch/api/v1/auditor-tenures?min_years=10&canton=ZH&pageSize=10"

{
  "items": [
    {
      "companyUid": "CHE-105.805.080",
      "companyName": "Nestlé SA",
      "auditorName": "KPMG AG",
      "appointedAt": "2004-01-15",
      "tenureYears": 22.2,
      "isCurrent": true,
      "source": "sogc"
    }
  ],
  "total": 206,
  "page": 1,
  "pageSize": 10
}

Die vollständige OpenAPI-3.0-Spezifikation ist verfügbar unter GET /api/v1/openapi.json — keine Authentifizierung erforderlich. Nutzen Sie sie, um typisierte SDKs zu generieren, in Postman oder Insomnia zu importieren oder mit Swagger UI zu durchsuchen. Alle Endpoints, Parameter, Antwortschemas und Ratenlimit-Gruppen sind maschinenlesbar.

# Download the full OpenAPI 3.0 spec (no auth required)
curl "https://api.vynco.ch/api/v1/openapi.json" -o openapi.json

Sie haben Ihre ersten VynCo-API-Aufrufe getätigt. Erkunden Sie diese Ressourcen, um tiefer einzusteigen.