Guida all'avvio rapido

Create a free VynCo account — no credit card required. Then navigate to the API Keys page in your dashboard and create a new key. The free tier gives you 1,000 credits per month to explore the API.

Use GET /companies to search the Zefix registry. Pass a company name in the search parameter. Each lookup costs 1 credit.

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

Narrow results by canton and changed_since timestamp. Combine multiple filters in a single request.

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

Fetch the full profile of a specific company using its UID (format: CHE-xxx.xxx.xxx). Enriched profiles include share capital, industry, and auditor category and cost 5 credits.

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": "KPMG",
  "enrichmentLevel": "Enriched",
  "updatedAt": "2026-04-12T05:01:50Z"
}

Monitor your credit consumption at any time with the balance endpoint. Credits are also returned in every response via the X-Credits-Remaining header.

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

{
  "balance": 48750,
  "tier": "Starter",
  "periodStart": "2026-03-01T00:00:00Z",
  "periodEnd": "2026-03-31T23:59:59Z"
}

Once you have data flowing, unlock deeper insights with the analytics endpoints. Run POST /analytics/cluster for K-Means or GMM clustering (15 credits), POST /analytics/anomalies for anomaly detection (15 credits), or GET /analytics/cohorts for cohort breakdowns by canton, legal form, founding year, or auditor (20 credits). These endpoints require the Professional tier or above.

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

Use POST /v1/screening to screen an entity against SECO sanctions, OpenSanctions (PEP lists), and FINMA regulated entities in a single request. The response includes a risk level and any matched hits.

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

Use GET /v1/auditor-tenures to list companies with long auditor tenures. Set min_years=10 to find ISS rotation candidates. This endpoint is public and does not require authentication.

# 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": 1456,
  "page": 1,
  "pageSize": 10
}

The full OpenAPI 3.0 specification is available at GET /api/v1/openapi.json — no authentication required. Use it to generate typed SDKs, import into Postman or Insomnia, or browse with Swagger UI. All endpoints, parameters, response schemas, and credit costs are machine-readable.

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

You have made your first VynCo API calls. Explore these resources to go further.