Guida all'avvio rapido

Crei un account VynCo gratuito — nessuna carta di credito richiesta. Navighi quindi alla pagina Chiavi API del suo dashboard e crei una nuova chiave. Il piano Free include 60 search/h e 60 standard/h per esplorare l'API gratuitamente.

Utilizzi GET /companies per cercare nel registro Zefix. Passi un nome aziendale nel parametro search . Ogni ricerca conta come una richiesta search_read sul suo limite di velocità.

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

Restringa i risultati per cantone e timestamp changed_since. Combini più filtri in una singola richiesta.

# 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..."

Recuperi il profilo completo di un'azienda specifica tramite il suo UID (formato: CHE-xxx.xxx.xxx). I profili arricchiti includono capitale sociale, settore e categoria del revisore — disponibili a partire dal piano Starter.

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"
}

Ispezioni ogni bucket di limite di velocità per gruppo della sua chiave API con GET /v1/usage/current. Questa chiamata non consuma alcuna richiesta da altre quote. Ogni risposta API restituisce inoltre gli header x-ratelimit-* in modo da poter monitorare la capacità rimanente a ogni chiamata.

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...

Una volta che i dati fluiscono, sblocchi approfondimenti più ricchi con gli endpoint analytics. Esegua POST /analytics/cluster per il clustering K-Means o GMM, POST /analytics/anomalies per la rilevazione delle anomalie, oppure GET /analytics/cohorts per ripartizioni per coorte per cantone, forma giuridica, anno di fondazione o revisore. Queste chiamate contano su analytics_read e richiedono il piano Starter o superiore.

# 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..."

Utilizzi POST /v1/screening per effettuare lo screening di un'entità rispetto alle sanzioni SECO, OpenSanctions (liste PEP) e alle entità regolamentate FINMA in un'unica richiesta. La risposta include un livello di rischio e gli eventuali riscontri.

# 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"]
}

Utilizzi GET /v1/auditor-tenures per elencare le aziende con lunga durata di mandato del revisore. Imposti min_years=10 per individuare i candidati alla rotazione ISS. Questo endpoint è pubblico e non richiede autenticazione.

# 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
}

La specifica OpenAPI 3.0 completa è disponibile presso GET /api/v1/openapi.json — nessuna autenticazione richiesta. La utilizzi per generare SDK tipizzati, importarla in Postman o Insomnia, oppure sfogliarla con Swagger UI. Tutti gli endpoint, parametri, schemi di risposta e gruppi di limite di velocità sono leggibili dalla macchina.

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

Ha effettuato le sue prime chiamate API VynCo. Esplori queste risorse per andare oltre.