API BCE zoeken op adres: Belgische ondernemingen vinden
Zoeken op adres met API BCE: vind de Belgische ondernemingen op een adres (postcode, straat, nummer), met gepagineerde resultaten en hun status.
Endpoints voor de resource Zoeken. Alle calls vereisen authenticatie en geven de standaard JSON-envelope terug.
Basis-URL: https://companybelgium.be/api/v2 · Authenticatie
Search enterprises by postal address#
Find enterprises registered at a given Belgian address. Street is matched partially (FR or NL); results are paginated.
Parameters
| Naam | In/Type | Verplicht | Omschrijving |
|---|---|---|---|
postalCode | query string | Verplicht | 4-digit Belgian postal code, e.g. 1000. |
street | query string | Verplicht | Street name (partial match, FR or NL). |
houseNumber | query string | optioneel | Exact house number. |
page | query integer | optioneel | 1-based page number (20 results per page). |
pageSize | query integer | optioneel | Results per page (default 20, max 100). Alias: limit. |
Verzoek
curl https://companybelgium.be/api/v2/search/address \
-H "X-API-Key: $API_BCE_KEY" \
-H "X-API-Secret: $API_BCE_SECRET"Antwoord
{
"success": true,
"data": {
"results": [
{
"enterpriseNumber": "1033.022.383",
"name": "ESPERO-SOFT INFORMATIQUES",
"status": "AC",
"statusCode": "AC",
"juridicalSituationCode": "...",
"type": "PM",
"address": "Rue de la Colonne 1A, 1080 Molenbeek-Saint-Jean",
"startDate": "..."
}
],
"totalResults": "...",
"currentPage": 1,
"totalPages": "...",
"searchParams": {
"zipCode": "1080"
}
},
"timestamp": "...",
"meta": {
"responseTime": "..."
}
}â–¶ Dit verzoek proberen
Wanneer zoeken op adres met API BCE nuttig is#
Soms ken je geen naam of nummer, maar wel een plaats. Zoeken op adres beantwoordt dan de vraag: welke ondernemingen zijn hier geregistreerd? Dat blijkt in de praktijk verrassend nuttig, zowel voor controle als voor prospectie.
- Fraudepreventie: nagaan hoeveel ondernemingen op hetzelfde adres staan, bijvoorbeeld bij een nieuwe klant.
- KYB: controleren of het opgegeven adres overeenkomt met wat in het register staat.
- Lokale prospectie: alle ondernemingen in een bepaalde straat of een bedrijventerrein in kaart brengen.
- Vastgoed en facility: de huurders van een gebouw identificeren.
Betere resultaten krijgen#
De postcode en de straat zijn verplicht. De straat wordt bovendien gedeeltelijk vergeleken, in het Frans of het Nederlands. Dat is handig in tweetalige gemeenten. Een te kort fragment geeft echter veel ruis. Gebruik daarom een herkenbaar deel van de straatnaam.
Voeg vervolgens houseNumber toe als je één gebouw zoekt. Dat nummer wordt exact vergeleken. Laat het dus weg als je niet zeker bent van de schrijfwijze, bijvoorbeeld bij nummers met een letter.
Resultaten zijn gepagineerd met page en pageSize. De standaard is 20 per pagina en het maximum 100. Kies een grotere pagina voor batchverwerking en een kleinere voor een scherm. Meer over pagineren staat op de pagina Zoeken en filteren.
Resultaten correct interpreteren#
Elk resultaat bevat een status. Op een adres staan vaak ook stopgezette ondernemingen. Filter daarom op de status als je alleen actieve ondernemingen wilt. Haal daarna, indien nodig, de volledige fiche op voor meer details.
Denk ten slotte aan privacy. Een adres kan ook dat van een zelfstandige zijn, dus van een natuurlijk persoon. Gebruik de resultaten van API BCE daarom alleen voor een legitiem doel.
Adressen uit je eigen bestand
Wil je een adres uit je eigen database controleren, splits het dan eerst in postcode, straat en huisnummer. Vrije tekst zoals "Kerkstraat 7 bus 2" werkt immers niet in één veld. Normaliseer bovendien afkortingen, zoals "str." voor "straat". Vergelijk vervolgens de gevonden ondernemingsnummers met je eigen gegevens. Zo zie je snel of een klant echt op het opgegeven adres geregistreerd staat.
Veelgestelde vragen over API BCE en zoeken op adres#
Moet ik de straatnaam in het Nederlands of het Frans invullen?
Allebei kan. De straat wordt gedeeltelijk vergeleken in het Frans of het Nederlands.
Kan ik zoeken met alleen een postcode?
Nee. Zowel postalCode als street zijn verplicht. Een postcode bestaat uit 4 cijfers, bijvoorbeeld 1000.
Waarom staan er stopgezette ondernemingen in mijn resultaten?
Het zoeken geeft alle ondernemingen die op het adres geregistreerd zijn. Filter op het statusveld als je alleen actieve ondernemingen wilt tonen.