Référence API

Documentation REST API complète pour la plateforme VynCo Swiss Corporate Intelligence

SDK officiels

VynCo publie des bibliothèques client maison pour Python, TypeScript, Rust et .NET. Tous les SDK sont open source (Apache-2.0 ou MIT) et synchronisés avec la dernière version de l'API.

pip install vynco

npm install @vynco/sdk

cargo add vynco

dotnet add package VynCo

Authentification

Les endpoints d'écriture exigent un jeton Bearer dans l'en-tête Authorization ; la plupart des endpoints de lecture fonctionnent sans authentification dans le tarif Free. Deux types de jetons sont pris en charge :

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

En-têtes de réponse

Chaque réponse de l'API inclut des en-têtes de limite de débit par groupe ainsi qu'un identifiant de requête pour le support et le traçage. Le registre complet par groupe est exposé via ces en-têtes — aucune information de consommation ne figure dans le corps de la réponse.

Entreprises

Recherchez et récupérez des fiches d'entreprises suisses enrichies depuis le registre. L'ensemble de données couvre plus de 790'000 entreprises actives — 41 champs par enregistrement, dont les données de registre, l'adresse, la géolocalisation, la classification NOGA, les drapeaux de sanctions et les traductions.

Changements

Suivez les mutations du registre — changements d'adresse, changements d'auditeur, augmentations de capital, modifications du conseil d'administration. Les lectures consomment le groupe standard_read ; voir la section Limites de débit pour les quotas par tarif.

Personnes

Recherchez des personnes physiques et leurs mandats au conseil d'administration à travers le registre. Les lectures consomment le groupe standard_read.

Dossiers

Générez des dossiers IA ancrés à des citations. Le LLM émet des balises [[obl:...]] résolues contre le graphe de connaissance méthodologique, de sorte que chaque affirmation renvoie à une obligation enregistrée ou à une ligne de preuve. Disponible dans le tarif Professional (groupe methodology_read).

Analytics

Exécutez des analyses de machine learning sur l'ensemble du registre des entreprises suisses — clustering, détection d'anomalies, analyse de cohortes. Tous les endpoints d'analytique requièrent le tarif Starter ou supérieur (groupe analytics_read).

Relations

Naviguez dans les structures parent / filiale. Les lectures consomment le groupe standard_read.

Actualités & rapports

Récupérez les actualités d'entreprise issues de SIX et de sources publiques, ainsi que les rapports financiers annuels analysés. Les lectures consomment le groupe standard_read.

Notes & étiquettes

Annotez les entreprises avec des notes et étiquettes au périmètre d'équipe. Les notes prennent en charge des types (Note, Annotation, Évaluation, Drapeau) et des contrôles de confidentialité. Les étiquettes permettent une catégorisation et un filtrage personnalisés.

Notes

Étiquettes

Classification & empreinte

Récupérez les classifications sectorielles (hiérarchie de type GICS) et les empreintes d'entreprise calculées avec les indicateurs clés, la catégorie de taille et le résumé de profil.

Comparaison

Comparez deux entreprises ou plus côte à côte en une seule requête (2 à 10 entreprises).

Watches & notifications

Surveillez des entreprises pour recevoir des notifications dès qu'une modification du registre est détectée. La gestion des watches et la consultation des notifications font partie du groupe account.

Préférences de notification

Screening

Filtrez des entités contre les sanctions du SECO, OpenSanctions (listes PPE) et les entités régulées par la FINMA en une seule requête. Renvoie un niveau de risque et toutes les correspondances détectées.

Auditor Intelligence

Interrogez les données de durée de mandat des auditeurs sur l'ensemble du registre du commerce suisse. Identifiez les entreprises dont les auditeurs ont une longue durée de mandat pour l'analyse de rotation ISS, ou récupérez l'historique complet des nominations d'auditeurs pour une entreprise donnée. Ces endpoints sont publics et ne requièrent pas d'authentification.

Événements d'entreprise

Récupérez l'historique des événements de changement d'une entreprise, dont les changements d'auditeur, les changements de capital, les changements d'organes et plus encore. Les événements suivent la spécification CloudEvents et incluent des métadonnées de sévérité et de catégorie. Endpoint de lecture public.

Recherches sauvegardées

Sauvegardez des filtres de recherche pour réutilisation rapide et planifiez leur exécution automatique selon une cadence quotidienne, hebdomadaire ou mensuelle. Les recherches planifiées génèrent des notifications lorsque de nouveaux résultats sont trouvés.

Bénéficiaire effectif

Tracez la chaîne complète des bénéficiaires effectifs pour toute entreprise suisse. L'endpoint résout récursivement les entités parentes et renvoie les pourcentages de propriété à chaque niveau. Les structures de propriété circulaires sont détectées et signalées automatiquement. Disponible dans le tarif Professional (groupe methodology_read).

Risk v2

Score de risque de l'équipe méthodologie : postérieurs Beta-Bernoulli à 9 facteurs avec priors alignés FATF. Chaque facteur expose son prior, son postérieur, son poids et ses preuves justificatives ; le score composite est la log-odds pondérée. Disponible dans le tarif Professional (groupe methodology_read).

Intelligence IA

Endpoints assistés par IA pour la génération de dossiers de due diligence, la recherche d'entreprise en langage naturel et l'évaluation de risque multi-signaux. Les endpoints de dossier et de recherche utilisent l'inférence LLM ; le scoring de risque algorithmique est multi-facteurs. La génération IA est mesurée contre le groupe expensive_ai.

IA comparative

Générez une analyse comparative multi-entreprises assistée par IA avec détection de chevauchement de conseils d'administration, score de gouvernance et positionnement concurrentiel. Comparez jusqu'à 10 entreprises en une seule requête. Mesuré contre le groupe expensive_ai.

Opérations en masse

Effectuez des opérations sur plusieurs entités à la fois. Le screening en masse contrôle plusieurs entités contre les listes de sanctions en une seule requête. L'import CSV de watchlist permet d'ajouter des entreprises en masse. L'export par champs sélectionnés permet de choisir précisément les colonnes à inclure dans votre téléchargement. Mesuré contre le groupe bulk (tarif Enterprise).

Exports en masse

Soumettez des jobs d'export en masse asynchrones au format NDJSON ou CSV. Interrogez l'endpoint de statut du job jusqu'à ce que l'export soit terminé, puis récupérez les données en ligne (jusqu'à 10 Mo). Prend en charge le filtrage par canton, statut et limites de lignes. Mesuré contre le groupe bulk.

PDF d'entreprise

Générez un profil PDF téléchargeable pour toute entreprise suisse. Le document inclut un aperçu du registre, l'historique des changements, la composition du conseil, les détails de l'auditeur et les indicateurs de risque. Choisissez les sections à inclure via un paramètre de requête.

Widget intégrable

Intégrez des cartes de résumé d'entreprise en direct sur des sites partenaires. Deux méthodes d'intégration sont prises en charge : un auto-loader JavaScript qui scanne la page à la recherche d'attributs data-vynco-uid, ou une intégration iframe directe. Les deux options prennent en charge les thèmes clair et sombre. Aucune authentification requise pour les widgets publics.

<script src="https://vynco.ch/api/v1/widget/embed.js"></script>
<div data-vynco-uid="CHE-105.962.875"></div>

<iframe src="https://vynco.ch/api/v1/widget/company/CHE-105.962.875?theme=light&fields=name,canton,capital,status"
        width="400" height="200" frameborder="0"></iframe>

Rapports sectoriels

Accédez à des rapports sectoriels générés par IA avec narration LLM, statistiques clés, entreprises de tête et analyse de tendances. Les rapports couvrent les secteurs sectoriels basés sur GICS à travers le registre suisse. Listez les secteurs disponibles ou récupérez un rapport détaillé pour un secteur donné. Mesuré contre le groupe expensive_ai.

Blog

Endpoints de blog publics pour lister et récupérer les billets publiés. Aucune authentification requise. Filtrez par étiquette ou récupérez un billet unique par slug.

Export

Exportez les données d'entreprise sous forme de feuilles Excel. Prend en charge les exports filtrés avec sélection de champs personnalisable. Disponible dans le tarif Professional (groupe bulk).

Spécification OpenAPI

La spécification OpenAPI 3.0 complète (plus de 140 endpoints) est disponible pour l'auto-découverte, la génération de SDK et l'intégration avec des outils tels que Postman, Insomnia ou Swagger UI. Aucune authentification n'est nécessaire pour récupérer la spécification.

curl "https://api.vynco.ch/api/v1/openapi.json"

Gestion

Endpoints de gestion d'équipe, de clés API et de consommation. Ces lectures font partie du groupe account et bénéficient d'une limite généreuse par tarif.

Équipes

Clés API

Consommation

Référence des erreurs

Toutes les réponses d'erreur suivent le format Problem Details RFC 7807 avec une structure cohérente sur l'ensemble des endpoints. L'exemple ci-dessous montre une réponse 429 Too Many Requests — le mode d'échec le plus fréquent sous le modèle de limite de débit par groupe.

HTTP/1.1 429 Too Many Requests
Retry-After: 3540
x-ratelimit-group: methodology_read
x-ratelimit-window: 1h
x-ratelimit-limit: 600
x-ratelimit-remaining: 0
x-ratelimit-reset: 3540
{
  "type": "https://api.vynco.ch/errors/rate-limit-exceeded",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded for the methodology_read group on the Professional tier (600/h). Honour the Retry-After header.",
  "instance": "/v1/dossiers/CHE-109.322.551",
  "group": "methodology_read",
  "window": "1h",
  "limit": 600,
  "retryAfterSeconds": 3540
}

Limites de débit

Les requêtes API sont limitées en débit par groupe d'endpoints et par tarif. Les limites sont exposées via les en-têtes de réponse x-ratelimit-* et réinitialisées à la fin de chaque fenêtre. Lorsqu'une requête dépasse son seau, l'API renvoie 429 Too Many Requests avec un en-tête Retry-After.

Related Articles