Guide de démarrage rapide

Créez un compte VynCo gratuit — aucune carte de crédit requise. Naviguez ensuite vers la page Clés API de votre tableau de bord et créez une nouvelle clé. Le tarif Free comprend 60 search/h et 60 standard/h pour explorer l'API gratuitement.

Utilisez GET /companies pour interroger le registre Zefix. Passez un nom d'entreprise dans le paramètre search . Chaque recherche compte comme une requête search_read sur votre limite de débit.

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

Affinez les résultats par canton et horodatage changed_since. Combinez plusieurs filtres dans une seule requête.

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

Récupérez le profil complet d'une entreprise via son UID (format : CHE-xxx.xxx.xxx). Les profils enrichis incluent le capital social, le secteur et la catégorie de l'auditeur — disponible à partir du tarif 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"
}

Inspectez chaque seau de limite de débit par groupe pour votre clé API avec GET /v1/usage/current. Cet appel ne consomme aucune requête sur les autres quotas. Chaque réponse de l'API renvoie également les en-têtes x-ratelimit-* afin que vous puissiez surveiller la capacité restante à chaque appel.

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

Une fois que les données circulent, accédez à des analyses plus poussées avec les endpoints d'analytique. Lancez POST /analytics/cluster pour le clustering K-Means ou GMM, POST /analytics/anomalies pour la détection d'anomalies, ou GET /analytics/cohorts pour des ventilations par cohorte par canton, forme juridique, année de fondation ou auditeur. Ces appels comptent sur analytics_read et requièrent le tarif Starter ou supérieur.

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

Utilisez POST /v1/screening pour filtrer une entité contre les sanctions du SECO, OpenSanctions (listes PPE) et les entités régulées par la FINMA en une seule requête. La réponse inclut un niveau de risque et les correspondances détectées.

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

Utilisez GET /v1/auditor-tenures pour lister les entreprises dont les auditeurs ont une longue durée de mandat. Définissez min_years=10 pour identifier les candidats à la rotation ISS. Cet endpoint est public et ne requiert pas d'authentification.

# 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 spécification OpenAPI 3.0 complète est disponible à l'adresse GET /api/v1/openapi.json — aucune authentification requise. Utilisez-la pour générer des SDK typés, l'importer dans Postman ou Insomnia, ou la parcourir avec Swagger UI. Tous les endpoints, paramètres, schémas de réponse et groupes de limite de débit sont lisibles par machine.

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

Vous avez effectué vos premiers appels à l'API VynCo. Explorez ces ressources pour aller plus loin.