Bedrijfsgegevens voor je volgende agent.
Zoek Belgische ondernemingen met één vraag. Gebruik de REST-API of verbind je agent met onze MCP-server. Beide gebruiken dezelfde zoekindex en bronnen.
Dit is een onafhankelijke zoekdienst op basis van KBO Open Data, geen officiële overheidswebsite.
Snel beginnen
Combineer namen en adressen: voorbeeldbedrijf gent of jan janssens pontstraat. De namen en het ondernemingsnummer in deze voorbeelden zijn fictief; vervang ze door echte gegevens. Zoekresultaten bevatten ondernemingsnummers waarmee je details en Peppol-registratie kunt opvragen.
curl "https://vindbtw.be/v1/search?q=voorbeeldbedrijf%20gent&limit=10" curl "https://vindbtw.be/v1/businesses/0123456749" curl "https://vindbtw.be/v1/businesses/0123456749/peppol"
Geen aanmelding of sleutel nodig. Antwoorden zijn JSON; browsers mogen de API rechtstreeks aanroepen (CORS). Bij te veel verzoeken volgt 429 met Retry-After.
Een zoekopdracht bevat maximaal 200 tekens en 16 woorden. Vraag 1 tot 50 resultaten op met limit. Meer resultaten nodig? Verfijn de zoekopdracht. Er is geen paginering voorbij 50 resultaten.
Zoeken op ondernemingsnummer
Volledige en gedeeltelijke nummers werken met of zonder BE, spaties en punten: BE 0123.456.749, 0123 456 of 456749. Een expliciete BE-prefix of opmaak kiest nummerzoeken. Losse getallen tot vier cijfers zoeken ook in adresvelden.
Verbind via MCP
Voeg in je MCP-client een server toe met transport Streamable HTTP en als adres https://vindbtw.be/mcp. De server is stateless, vraagt geen authenticatie en biedt uitsluitend leesfuncties.
claude mcp add --transport http vindbtw https://vindbtw.be/mcp
Of in een JSON-configuratie:
{"mcpServers": {"vindbtw": {"type": "http", "url": "https://vindbtw.be/mcp"}}}| Functie | Gebruik |
|---|---|
search_businesses | Zoek met query en optioneel limit. |
get_business | Bedrijfsgegevens en activiteiten met number. |
get_peppol | Controleer Peppol-registratie met number. |
Zo interpreteer je de resultaten
- Ondernemingen en vestigingen: meerdere resultaten kunnen bij dezelfde onderneming horen. Groepeer op
enterprise_number. - Personen: de index bevat namen van zelfstandigen. Hij geeft geen overzicht van bestuurders, aandeelhouders of uiteindelijke eigenaars.
- Actualiteit: KBO-gegevens komen uit een momentopname. Vermeld
snapshot_date(DD-MM-JJJJ) bij bedrijfsgegevens. - Peppol: DNS-controle wordt op aanvraag uitgevoerd en kort gecachet. Vermeld
checked_at. Registratie bevestigt geen factuurondersteuning.unavailablebetekent dat de controle mislukte, niet dat de onderneming afwezig is. - Plaatsnamen: Ruiselede wordt herkend als postcode 8755 binnen Wingene. Andere plaatsnamen worden als zoektekst behandeld.
- Betrouwbaarheid: controleer het ondernemingsnummer en vul ontbrekende gegevens niet zelf in.
Documentatie en bronnen
Interactieve API-documentatie · OpenAPI-schema · llms.txt
Kruispuntbank van Ondernemingen levert de brongegevens. Peppol-registratie wordt afzonderlijk gecontroleerd. Links naar officiële bronnen staan bij de bedrijfsdetails.