Documentation / Versionnage

Versionnage

API BCE est versionnée dans le chemin de l’URL. Nous n’introduisons jamais de changement cassant dans une version publiée — des champs peuvent être ajoutés, mais les champs existants conservent leur sens.

v2 — actuelle#

URL de base https://companybelgium.be/api/v2. Modèle de données plus riche, sous-ressources, finances, bénéficiaires effectifs, données de référence, validation TVA et webhooks. Utilisez v2 pour toute nouvelle intégration.

v1 — héritée#

URL de base https://companybelgium.be/api. Une surface réduite centrée sur la recherche et la consultation d’entreprise. Toujours disponible, mais les nouveautés arrivent uniquement en v2.

curl "https://companybelgium.be/api/companies/search?q=inbev" \
  -H "X-API-Key: $API_KEY"

Endpoints v1 hérités : /health, /companies/search, /companies/address, /companies/{id}, /stats, /peppol/check.