L'API KVK la plus simple pour les développeurs
KVKBase Team

L'API KVK la plus simple pour les développeurs

L'API KVK la plus simple : recherche de numéro KVK, validation de TVA via VIES et données d'entreprises néerlandaises, via une API REST ou un widget.

kvkapidéveloppeursdonnées-entreprisestvapays-bas

Vous développez une application qui traite avec des entreprises néerlandaises ? Tôt ou tard, vous aurez besoin d’une API KVK. Que vous préremplissiez les informations d’une entreprise à l’inscription, validiez un numéro de TVA ou enrichissiez votre CRM avec des données à jour, il vous faut un accès fiable et rapide aux informations sur les entreprises néerlandaises. Cet article explique pourquoi KVKBase est l’API KVK la plus simple pour les développeurs travaillant avec les Pays-Bas, et comment démarrer en moins de cinq minutes.

Pourquoi utiliser une API KVK ?

La recherche de numéro KVK est l’une des fonctionnalités les plus demandées dans les logiciels B2B. Lorsqu’une entreprise s’inscrit sur votre plateforme, vous voulez vérifier que le numéro KVK est valide, confirmer que la société est toujours active et récupérer ses informations. Le faire manuellement, ou demander aux utilisateurs de tout saisir eux-mêmes, fait perdre du temps et introduit des erreurs.

Une bonne API de données d’entreprises néerlandaises règle cela proprement. Vous envoyez un numéro KVK ou un nom d’entreprise à l’endpoint et, en quelques millisecondes, vous recevez un profil complet : nom commercial, adresse, forme juridique, codes SBI et bien plus. Pas de formulaires manuels, pas d’arriéré de vérifications.

Qu’est-ce qui fait de KVKBase l’API KVK la plus simple ?

Beaucoup de développeurs se heurtent à des frictions la première fois qu’ils travaillent avec des données d’entreprises néerlandaises : procédures d’accès compliquées, documentation obsolète ou formats de réponse incohérents. KVKBase est conçu avant tout pour l’expérience développeur. L’API KVK simple que nous proposons repose sur trois principes :

  1. Un seul endpoint, une réponse JSON directe : pas d’analyse XML, pas de flux d’authentification complexe
  2. Offre gratuite disponible : démarrez immédiatement, ne payez que lorsque vous montez en charge
  3. Validation de la TVA incluse : via VIES, sans intégration séparée

Intégrer les données d’entreprises néerlandaises devient ainsi une affaire de minutes plutôt que de jours.

Recherche d’un numéro KVK en trois lignes de code

Rechercher un numéro KVK avec KVKBase est très simple. Demandez une clé d’API sur kvkbase.nl et lancez votre première requête :

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.kvkbase.nl/api/v1/lookup/12345678"

La réponse vous fournit immédiatement toutes les données utiles de l’entreprise :

{
  "kvkNumber": "12345678",
  "tradeName": "Example B.V.",
  "legalForm": "Besloten Vennootschap",
  "address": {
    "street": "Keizersgracht",
    "houseNumber": "1",
    "postalCode": "1015CN",
    "city": "Amsterdam"
  },
  "isActive": true,
  "sbiActivities": [
    {
      "sbiCode": "62010",
      "sbiDescription": "Development and production of software",
      "isMainActivity": true
    }
  ]
}

Aucune transformation, aucun mapping : les données sont prêtes à être intégrées directement dans votre application.

Recherche par nom d’entreprise

Vous n’avez pas encore le numéro KVK ? Cherchez plutôt par nom :

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.kvkbase.nl/api/v1/search?q=Bol.com"

Vous recevez une liste d’entreprises correspondantes, numéros KVK inclus, afin que l’utilisateur puisse choisir la bonne.

Validation de la TVA : tout dans une seule API

Dans les plateformes B2B, il est fréquent d’intégrer séparément les données KVK et la validation de la TVA. Avec KVKBase, c’est inutile. Un seul appel à l’endpoint /validate/vat valide directement n’importe quel numéro de TVA néerlandais ou européen via le système VIES :

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.kvkbase.nl/api/v1/validate/vat?vatNumber=NL123456789B01"

Vous ne recevez pas seulement un indicateur valide/invalide, mais aussi le nom et l’adresse de l’entreprise associés : idéal pour la validation de factures et les processus de conformité européenne.

Pour approfondir techniquement la validation de la TVA, consultez notre guide de la validation des numéros de TVA néerlandais via VIES.

API de données d’entreprises néerlandaises : que recevez-vous ?

L’API de données d’entreprises néerlandaises de KVKBase donne accès à toutes les données publiques du registre du commerce :

  • Nom commercial et éventuels noms enregistrés supplémentaires
  • Adresse complète (siège et adresse postale)
  • Forme juridique (BV, NV, entreprise individuelle, fondation, etc.)
  • Codes SBI avec descriptions et indicateur d’activité principale ou secondaire
  • Numéro(s) d’établissement
  • Date de constitution
  • Statut actif ou inactif
  • Numéro de TVA (lorsqu’il est disponible)

Tout ce qu’il faut pour l’onboarding, la facturation, l’enrichissement du CRM et la conformité, dans une seule réponse JSON claire.

Récupérer les données d’entreprises néerlandaises en JavaScript

Vous travaillez sur un frontend ou une application Node.js ? Vous pouvez appeler l’API directement depuis votre code :

async function fetchCompanyData(kvkNumber) {
  const response = await fetch(
    `https://api.kvkbase.nl/api/v1/lookup/${kvkNumber}`,
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
      }
    }
  );

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  return response.json();
}

// Remplit automatiquement les champs du formulaire à la saisie du KVK
document.getElementById('kvk-input').addEventListener('change', async (e) => {
  const data = await fetchCompanyData(e.target.value);
  document.getElementById('company-name').value = data.tradeName;
  document.getElementById('address').value =
    `${data.address.street} ${data.address.houseNumber}`;
  document.getElementById('postal-code').value = data.address.postalCode;
  document.getElementById('city').value = data.address.city;
});

C’est le schéma de base utilisé par les développeurs pour les formulaires d’inscription, les parcours de paiement et les écrans de saisie de CRM.

Le widget KVKBase : récupérer les données d’entreprises sans écrire de code

Vous souhaitez ajouter une recherche de données d’entreprises sans construire une intégration complète ? Le widget intégrable de KVKBase est le chemin le plus rapide. Placez une seule balise script dans votre HTML et vous obtenez un champ de recherche d’entreprises fonctionnel :

<script src="https://widget.kvkbase.nl/embed.js"
        data-api-key="YOUR_API_KEY"
        data-target="#company-search">
</script>

Le widget est entièrement personnalisable visuellement, fonctionne immédiatement et convient parfaitement lorsque vous avez besoin d’une solution opérationnelle rapidement, sans câbler vous-même l’API REST. Vous pouvez aussi combiner le widget et l’API : le widget pour l’interface utilisateur, l’API pour la validation côté serveur.

KVKBase comparé aux autres options d’API KVK

Comparé aux autres fournisseurs d’API KVK, KVKBase se distingue par l’alliance de la simplicité et de l’exhaustivité. L’API KVK officielle exige des semaines de mise en place et ne fournit que les données KVK, sans validation de la TVA ni widget intégrable.

FonctionnalitéKVKBaseAPI KVK officielle
Délai d’inscriptionMinutesSemaines
Validation du numéro de TVAIncluseNon disponible
Widget intégrableOuiNon
Réponse JSONOuiOui (XML également)
Offre gratuiteOuiNon
Recherche par nomOuiOui
Codes SBIOuiOui

Cas d’usage courants

Les développeurs utilisent l’API KVK de KVKBase dans de nombreux scénarios :

Onboarding de clients B2B

Lorsqu’une entreprise crée un compte, vous demandez le numéro KVK, remplissez automatiquement les informations de la société et vérifiez qu’elle est active, le tout en une seule étape. Vous réduisez les fautes de frappe et améliorez la qualité de vos données clients.

Validation de factures

Avant d’envoyer une facture, vous vérifiez le numéro de TVA du client via VIES. C’est une obligation légale pour les livraisons intracommunautaires au sein de l’UE.

Enrichissement du CRM

Ajoutez des données d’entreprises à jour à vos fiches clients existantes grâce à des recherches en masse. Les noms commerciaux, adresses et formes juridiques restent ainsi toujours exacts.

Conformité et KYC

Vérifiez automatiquement si les entreprises sont actives et à quel secteur elles appartiennent grâce à leurs codes SBI. Précieux pour les institutions financières et les plateformes soumises à des obligations de connaissance client (KYC).

Démarrer avec l’API KVK de KVKBase

Prêt à intégrer l’API KVK la plus simple dans votre projet ? Voici comment faire :

  1. Créez un compte gratuit sur kvkbase.nl
  2. Copiez votre clé d’API depuis le tableau de bord
  3. Lancez votre première recherche avec la commande curl ci-dessus
  4. Intégrez l’API KVK ou le widget dans votre application

L’offre gratuite suffit largement pour la plupart des premiers projets. Lorsque votre usage augmente, passer à une offre payante se fait en un clic dans le tableau de bord, sans contrat ni engagement.

Une question ou un cas d’usage particulier à discuter ? Contactez-nous via kvkbase.nl, nous serons ravis de vous aider.