Documentatie / btw-validatie

btw-validatie

Endpoints voor de resource btw-validatie. Alle calls vereisen authenticatie en geven de standaard JSON-envelope terug.

🔗

Basis-URL: https://companybelgium.be/api/v2 · Authenticatie

Validate an EU VAT number via VIES#

GET/vat/{vatNumber}

Real-time validation of any EU VAT number through the European Commission VIES service. Accepts spaces, dots and the country prefix.

Parameters

NaamIn/TypeVerplichtOmschrijving
vatNumber path string Verplicht VAT identifier, e.g. BE1033022383, BE 1.033.022.383 or 1033022383.

Verzoek

curl https://companybelgium.be/api/v2/vat/BE1033022383 \
  -H "X-API-Key: $API_KEY" -H "X-API-Secret: $API_SECRET"
const res = await fetch("https://companybelgium.be/api/v2/vat/BE1033022383", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.API_KEY,
    "X-API-Secret": process.env.API_SECRET,
  },
});
const { data } = await res.json();

Antwoord

{
  "success": true,
  "data": {
    "valid": true,
    "countryCode": "BE",
    "vatNumber": "1033022383",
    "name": "ESPERO-SOFT INFORMATIQUES",
    "address": "..."
  },
  "error": null,
  "timestamp": "2026-06-05T09:00:00.000Z",
  "meta": null
}