Prise en main de KVKBase

KVKBase propose une API simple et rapide pour consulter les données des entreprises néerlandaises. Obtenez numéros KVK, adresses, validation de TVA et plus encore en un seul appel d'API.

1. Créez un compte

Créez un compte gratuit sur kvkbase.nl/fr/signup. L'offre gratuite comprend 50 jetons par mois, sans carte bancaire.

2. Récupérez votre clé d'API

Après connexion, rendez-vous dans Tableau de bord → Clés d'API et créez une nouvelle clé. Votre clé ressemblera à ceci :

kvk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Important : conservez votre clé d'API en lieu sûr. Il ne sera plus possible de l'afficher après sa création.

3. Envoyez votre première requête

Utilisez le point d'accès /v1/lookup pour récupérer les données d'une entreprise à partir de son numéro KVK :

## Rechercher une entreprise par numéro KVK
curl https://api.kvkbase.nl/v1/lookup/12345678 \
  -H "Authorization: Bearer YOUR_API_KEY"

Vous obtiendrez une réponse JSON de ce type :

{
  "kvkNumber": "12345678",
  "name": "Acme B.V.",
  "address": {
    "street": "Herengracht 100",
    "city": "Amsterdam",
    "postalCode": "1015 AA"
  },
  "vatNumber": "NL123456789B01",
  "vatValid": true,
  "isActive": true
}

4. Essayez le widget

Vous souhaitez ajouter l'autocomplétion à votre formulaire de commande ou d'inscription ? Intégrez le widget KVKBase avec une seule ligne de HTML :

<script
  src="https://widget.kvkbase.nl/v1/widget.js"
  data-apikey="YOUR_API_KEY"
  data-target="#kvk-input"
  data-autofill="true"
></script>

Consultez la documentation du widget pour toutes les options de configuration.

Étapes suivantes

  • Référence de l'API : documentation complète des points d'accès
  • Widget : autocomplétion prête à l'emploi pour vos formulaires
  • Codes d'erreur : gérez les erreurs proprement
  • Exemples : extraits de code dans plusieurs langages
  • Surveillance : alertes et webhooks signés lorsqu'une entreprise change