Belgische bedrijfsgegevens API
Zoek een Belgisch bedrijf op ondernemingsnummer of naam en krijg naam, rechtsvorm, adres, activiteiten, vestigingen en een gecontroleerd btw-nummer terug in één JSON-antwoord.
Wat je krijgt
Opzoeken op ondernemingsnummer
Eén GET met het nummer in elke notatie: 0123.456.749, 0123456749 of BE0123456749. Je krijgt het volledige bedrijfsprofiel terug.
Zoeken op naam en postcode
Vind het ondernemingsnummer van een bedrijf als je alleen de naam kent. Verfijn met een postcode van vier cijfers.
Btw-nummer afgeleid en gecontroleerd
Het Belgische btw-nummer is BE plus het ondernemingsnummer. Wij leiden het af en controleren het in VIES, het btw-systeem van de EU.
Batch tot 25 nummers
Verrijk een klantenbestand in één call. Elk nummer wordt apart gecontroleerd en afgerekend.
Endpoints
Alle Belgische endpoints staan onder /v1/be en gebruiken dezelfde API-key en dezelfde foutstructuur als de Nederlandse API.
| Endpoint | Doet | Tokens |
|---|---|---|
GET /v1/be/lookup/{ondernemingsnummer} | Bedrijfsprofiel van één ondernemingsnummer | 1 |
GET /v1/be/search?q=&postalCode= | Zoeken op naam (min. 2 tekens) en/of postcode, maximaal 25 resultaten | 1 |
GET /v1/be/validate/vat/{BE...} | Btw-nummer controleren via VIES | 1 |
POST /v1/be/lookup/batch | Tot 25 ondernemingsnummers in één request | 1 per nummer |
GET /v1/lookup/{nummer} | Het bestaande endpoint herkent Belgische nummers ook | 1 |
Een call, het hele bedrijf
Een Belgisch lookup-antwoord bevat dezelfde soorten velden als een Nederlands, aangevuld met wat in België belangrijk is: de juridische toestand, de NACE-activiteiten en de vestigingseenheden. Met ?lang=nl of ?lang=fr komen rechtsvorm en toestand in de taal van je gebruiker terug.
curl "https://api.kvkbase.nl/v1/be/lookup/0123.456.749?lang=nl" \
-H "Authorization: Bearer YOUR_API_KEY"const API = "https://api.kvkbase.nl";
const headers = { Authorization: "Bearer " + process.env.KVKBASE_KEY };
// 1. Look up by enterprise number, in any notation
const res = await fetch(API + "/v1/be/lookup/BE0123456749?lang=nl", { headers });
const company = await res.json();
console.log(company.name, company.legalFormShort, company.vat?.valid);
// 2. Search by name and postal code
const hits = await fetch(API + "/v1/be/search?q=voorbeeld&postalCode=9000", { headers });
// 3. Batch, up to 25 numbers per call
await fetch(API + "/v1/be/lookup/batch", {
method: "POST",
headers: { ...headers, "Content-Type": "application/json" },
body: JSON.stringify({ cbeNumbers: ["0123456749", "0123456848"] }),
});{
"country": "BE",
"cbeNumber": "0123456749",
"cbeNumberFormatted": "0123.456.749",
"name": "Voorbeeld BV",
"tradingNames": ["Voorbeeld"],
"legalForm": "Besloten vennootschap",
"legalFormShort": "BV",
"entityType": "legal_person",
"address": { "street": "Veldstraat", "houseNumber": "1", "postalCode": "9000", "city": "Gent", "country": "BE" },
"isActive": true,
"juridicalSituation": "Normale toestand",
"registrationDate": "2019-04-02",
"activities": [{ "sbiCode": "62010", "description": "...", "isMain": true }],
"establishments": [{ "establishmentNumber": "2.123.456.789", "startDate": "2019-04-02", "address": { "...": "..." } }],
"vat": { "number": "BE0123456749", "valid": true, "status": "validated", "checksumValid": true }
}De belangrijkste velden
cbeNumber, cbeNumberFormatted | Het ondernemingsnummer als 10 cijfers en met punten (0123.456.749). |
name, tradingNames | De naam van de onderneming en haar commerciële benamingen. |
legalForm, legalFormShort, entityType | Rechtsvorm als label (Besloten vennootschap) en afkorting (BV), plus het verschil tussen rechtspersoon en natuurlijke persoon. |
isActive, juridicalSituation | Of de onderneming actief is en wat haar juridische toestand is, zoals normale toestand, vereffening of faillissement. |
activities | NACE-activiteiten met code en omschrijving. De hoofdactiviteit is gemarkeerd. |
establishments | De vestigingseenheden met hun nummer, startdatum en adres. |
vat | Het afgeleide btw-nummer met de uitkomst van de VIES-controle en het tijdstip ervan. |
Dezelfde tokens en prijzen als in Nederland
Een Belgische lookup, een zoekopdracht en een btw-controle kosten elk 1 token. In een batch betaal je 1 token per nummer. Een ongeldig nummer wordt afgewezen voordat er iets wordt opgevraagd en kost dus niets.
Het gratis plan geeft je 50 tokens per maand, zonder kredietkaart. Voor meer volume kies je een betaald plan, zie de prijzenpagina. Belgische en Nederlandse lookups tellen samen op één saldo.
Probeer het zonder code
Btw-nummer controleren
Controleer de opbouw van een Belgisch btw-nummer en vraag het na in VIES.
OpenenWaarvoor gebruiken developers het?
- Een checkout of onboarding die bedrijfsgegevens invult zodra de klant zijn ondernemingsnummer typt.
- Facturatie die controleert of een btw-nummer actief is voor je een levering zonder btw factureert.
- KYC en leveranciersbeheer: bestaat het bedrijf, is het actief, wat is zijn rechtsvorm en wat doet het?
- CRM-verrijking van een bestand met alleen ondernemingsnummers of namen.
Werk je ook met Nederlandse bedrijven? Dezelfde API-key werkt voor Nederlandse bedrijfsgegevens.
Gidsen voor developers
Ondernemingsnummer opzoeken: zo vind en controleer je het nummer van een Belgisch bedrijf
Ondernemingsnummer opzoeken: waar je het vindt, hoe je het controleert met het controlegetal en hoe je het automatiseert met een API. Met voorbeelden.
OpenenOndernemingsnummer, KBO-nummer en btw-nummer: het verschil
Wat is het verschil tussen ondernemingsnummer en btw-nummer? Zo is het opgebouwd, wanneer er geen btw-nummer is en wat je in je database bewaart.
OpenenBtw-nummer controleren in België via VIES: stap voor stap
Btw-nummer controleren België: formaatcontrole, VIES, het resultaat lezen, bewijs bewaren en omgaan met downtime. Met curl- en JavaScript-voorbeelden.
OpenenBelgisch bedrijf controleren voor je zaken doet: checklist
Controleer een Belgisch bedrijf voor je tekent of factureert: bestaan, status, rechtsvorm, adres, btw via VIES, activiteit en rode vlaggen, met voorbeeld.
OpenenBelgische bedrijfs-API: codevoorbeelden in curl, JavaScript en Python
Werkende codevoorbeelden voor de Belgische bedrijfsgegevens-API: lookup, zoeken op naam en postcode, btw-controle, foutafhandeling en rate limits.
OpenenBelgische bedrijven in bulk controleren met de batch-API
Een CSV met ondernemingsnummers controleren via de batch-API: normaliseren, controlegetal vooraf, niet gevonden en gestopte bedrijven, script en caching.
OpenenBelgische bedrijven zoeken per postcode, gemeente en sector
Zo vind je Belgische bedrijven per postcode, gemeente, provincie en NACE-sector: de overzichtspagina's op KVKBase en zoeken via de API, met limieten.
OpenenBtw-nummer België: opbouw en controlegetal stap voor stap berekend
Hoe is een Belgisch btw-nummer opgebouwd en hoe werkt het controlegetal (modulo 97)? Met een uitgewerkt voorbeeld en uitleg over VIES en notatievarianten.
OpenenNACE-codes zoeken per sector: zo vind je de activiteitscode van een Belgisch bedrijf
Hoe vind je de NACE-code van een activiteit, hoe is de indeling opgebouwd en hoe gebruik je sectoren om Belgische bedrijven te vinden voor prospectie?
OpenenVeelgestelde vragen
Wat is het verschil tussen een ondernemingsnummer en een btw-nummer?
Welke notaties van het ondernemingsnummer worden aanvaard?
Wat kost een Belgische lookup?
Hoe actueel zijn de gegevens?
Kan ik ook zoeken op naam?
Wat als VIES niet bereikbaar is?
Klaar om Belgische bedrijven op te zoeken?
Start gratis, zonder kredietkaart. 50 tokens per maand om te proberen.
Maak een gratis account