API v2 — New
API v2
API version 2 exposes granular endpoints (activities, address, contact, denominations…), VIES VAT validation, customer introspection, director extraction from the Belgian Official Gazette and a full webhook system.
What's new in v2
Granular endpoints
Fetch only the subset you need (activities, contact, address, denominations…). Less bandwidth, more cacheable.
VIES VAT validation
Wrapper around the official European Commission API with a 24h Redis cache.
HMAC-signed webhooks
Receive enterprise change notifications in real time, signed with HMAC-SHA256 and retried automatically.
Directors and officers
Automatic extraction of directors in office from the latest Belgian Official Gazette publication. This data is not an extract from the UBO Register.
Base URL
Base URL
https://companybelgium.be/api/v2
Quick example
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