België

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.

EndpointDoetTokens
GET /v1/be/lookup/{ondernemingsnummer}Bedrijfsprofiel van één ondernemingsnummer1
GET /v1/be/search?q=&postalCode=Zoeken op naam (min. 2 tekens) en/of postcode, maximaal 25 resultaten1
GET /v1/be/validate/vat/{BE...}Btw-nummer controleren via VIES1
POST /v1/be/lookup/batchTot 25 ondernemingsnummers in één request1 per nummer
GET /v1/lookup/{nummer}Het bestaande endpoint herkent Belgische nummers ook1

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
curl "https://api.kvkbase.nl/v1/be/lookup/0123.456.749?lang=nl" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
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"] }),
});
Voorbeeld van een antwoord (fictief bedrijf)
{
  "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, cbeNumberFormattedHet ondernemingsnummer als 10 cijfers en met punten (0123.456.749).
name, tradingNamesDe naam van de onderneming en haar commerciële benamingen.
legalForm, legalFormShort, entityTypeRechtsvorm als label (Besloten vennootschap) en afkorting (BV), plus het verschil tussen rechtspersoon en natuurlijke persoon.
isActive, juridicalSituationOf de onderneming actief is en wat haar juridische toestand is, zoals normale toestand, vereffening of faillissement.
activitiesNACE-activiteiten met code en omschrijving. De hoofdactiviteit is gemarkeerd.
establishmentsDe vestigingseenheden met hun nummer, startdatum en adres.
vatHet 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.

Bekijk de prijzen

Probeer het zonder code

Ondernemingsnummer opzoeken

Controleer meteen of een nummer klopt en open het bedrijfsprofiel.

Openen

Btw-nummer controleren

Controleer de opbouw van een Belgisch btw-nummer en vraag het na in VIES.

Openen

Bedrijven zoeken

Blader door Belgische bedrijven op naam.

Openen

Bedrijven per stad

Vind Belgische bedrijven per gemeente en postcode.

Openen

Bedrijven per sector

Blader door bedrijven per NACE-sector.

Openen

Bedrijven per provincie

Bekijk bedrijven per provincie en in het Brussels Gewest.

Openen

Bedrijven per rechtsvorm

BV, NV, vzw en andere rechtsvormen, met uitleg per vorm.

Openen

Waarvoor 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.

Openen

Ondernemingsnummer, 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.

Openen

Btw-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.

Openen

Belgisch 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.

Openen

Belgische 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.

Openen

Belgische 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.

Openen

Belgische 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.

Openen

Btw-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.

Openen

NACE-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?

Openen

Alle gidsen

Veelgestelde vragen

Wat is het verschil tussen een ondernemingsnummer en een btw-nummer?
Het ondernemingsnummer identificeert de onderneming, 10 cijfers die met 0 of 1 beginnen. Het btw-nummer is BE gevolgd door datzelfde nummer. Niet elke onderneming is btw-plichtig, dus een afgeleid btw-nummer moet nog bevestigd worden in VIES.
Welke notaties van het ondernemingsnummer worden aanvaard?
Met of zonder punten en spaties, met of zonder BE ervoor. Een nummer van negen cijfers krijgt de voorloopnul terug. Een nummer waarvan de controlecijfers niet kloppen wordt geweigerd voor er iets wordt opgevraagd.
Wat kost een Belgische lookup?
1 token per lookup, per zoekopdracht en per btw-controle, en 1 token per nummer in een batch. Het gratis plan bevat 50 tokens per maand.
Hoe actueel zijn de gegevens?
De gegevens zijn officiële Belgische bedrijfsgegevens. Antwoorden worden een tijd bewaard zodat herhaalde vragen snel zijn, en het antwoord vermeldt wanneer het is opgehaald. De btw-controle in VIES krijgt een eigen tijdstempel.
Kan ik ook zoeken op naam?
Ja. Gebruik GET /v1/be/search met q voor de naam en eventueel postalCode voor de postcode. Je krijgt maximaal 25 resultaten per zoekopdracht, met het ondernemingsnummer om daarna op te zoeken.
Wat als VIES niet bereikbaar is?
Dan krijg je het laatst bekende resultaat terug, duidelijk gemarkeerd als verouderd, of een foutmelding wanneer er niets bekend is. Een btw-nummer wordt nooit als ongeldig gemeld omdat VIES niet antwoordt.

Klaar om Belgische bedrijven op te zoeken?

Start gratis, zonder kredietkaart. 50 tokens per maand om te proberen.

Maak een gratis account