Versiebeheer

API BCE wordt geversioneerd in het URL-pad. We maken nooit brekende wijzigingen aan een uitgebrachte versie — er kunnen velden bijkomen, maar bestaande velden behouden hun betekenis.

v2 — huidig#

Basis-URL https://companybelgium.be/api/v2. Rijker datamodel, subresources, financiën, begunstigden, referentiegegevens, btw-validatie en webhooks. Gebruik v2 voor elke nieuwe integratie.

v1 — verouderd#

Basis-URL https://companybelgium.be/api. Een kleiner oppervlak gericht op zoeken en bedrijfsopzoeking. Nog beschikbaar, maar nieuwe functies komen alleen in v2.

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

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