API v2 — Nieuw
API v2
API versie 2 biedt granulaire endpoints (activiteiten, adres, contact, benamingen…), VIES BTW-validatie, klant-introspectie, extractie van bestuurders uit het Belgisch Staatsblad en een volledig webhook-systeem.
Wat is nieuw in v2
Granulaire endpoints
Haal alleen op wat u nodig heeft (activiteiten, contact, adres, benamingen…). Minder bandbreedte, beter cachebaar.
VIES BTW-validatie
Wrapper rond de officiële API van de Europese Commissie met een Redis-cache van 24 uur.
HMAC-ondertekende webhooks
Ontvang wijzigingen van ondernemingen in real-time, ondertekend met HMAC-SHA256 en automatisch opnieuw geprobeerd.
Bestuurders en mandatarissen
Automatische extractie van zetelende bestuurders uit de meest recente publicatie in het Belgisch Staatsblad. Deze gegevens vormen geen uittreksel uit het UBO-register.
Basis-URL
Base URL
https://companybelgium.be/api/v2
Snel voorbeeld
bash
# Récupérer le détail d'une entreprise
curl -H "X-API-Key: ${API_KEY}" -H "X-API-Secret: ${API_SECRET}" \
https://companybelgium.be/api/v2/enterprise/1033022383
# Lister uniquement les activités
curl -H "X-API-Key: ${API_KEY}" -H "X-API-Secret: ${API_SECRET}" \
https://companybelgium.be/api/v2/enterprise/1033022383/activities
# Dirigeants et mandataires (extraits du Moniteur belge)
curl -H "X-API-Key: ${API_KEY}" -H "X-API-Secret: ${API_SECRET}" \
https://companybelgium.be/api/v2/enterprise/1033022383/roles
# Validation TVA via VIES
curl -H "X-API-Key: ${API_KEY}" -H "X-API-Secret: ${API_SECRET}" \
https://companybelgium.be/api/v2/vat/BE1033022383