Documentation / Versioning

Versioning

API BCE is versioned in the URL path. We never make breaking changes to a released version β€” new fields may be added, but existing fields keep their meaning.

v2 β€” current#

Base URL https://companybelgium.be/api/v2. Richer data model, sub-resources, financials, beneficial owners, reference data, VAT validation and webhooks. Use v2 for all new integrations.

v1 β€” legacy#

Base URL https://companybelgium.be/api. A smaller surface focused on search and company lookup. Still available, but new features land in v2 only.

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

Legacy v1 endpoints: /health, /companies/search, /companies/address, /companies/{id}, /stats, /peppol/check.