# vindbtw.be

> Belgische ondernemingen zoeken op naam, btw- of ondernemingsnummer, persoon, adres en gemeente. Onafhankelijke zoekdienst op basis van KBO Open Data; geen officiële overheidswebsite. Gratis en openbaar leesbaar via website, REST-API en MCP-server, zonder aanmelding.

## Toegang
- [Zoeken](https://vindbtw.be/): Nederlandse zoekpagina. Deelbare zoek-URL: https://vindbtw.be/?q=voorbeeldbedrijf%20gent
- [Voor agents](https://vindbtw.be/agents): Werkwijze, voorbeelden en beperkingen.
- [OpenAPI](https://vindbtw.be/openapi.json): Parameters en REST-endpoints.
- [API-documentatie](https://vindbtw.be/docs): Interactieve documentatie.

## MCP
- Adres: https://vindbtw.be/mcp (Streamable HTTP, stateless, geen authenticatie).
- Tools (alleen lezen): search_businesses(query, limit=10), get_business(number), get_peppol(number).
- Claude Code: claude mcp add --transport http vindbtw https://vindbtw.be/mcp

## REST
- GET https://vindbtw.be/v1/search?q=voorbeeldbedrijf%20gent&limit=10
- GET https://vindbtw.be/v1/businesses/0123456749
- GET https://vindbtw.be/v1/businesses/0123456749/peppol
- GET https://vindbtw.be/health

De namen en het ondernemingsnummer in deze voorbeelden zijn fictief. Antwoorden zijn JSON. Maximaal 200 tekens, 16 zoekwoorden en 50 resultaten per zoekopdracht. Geen paginering voorbij 50 resultaten. Bij te veel verzoeken volgt HTTP 429 met Retry-After.

## Betekenis van de gegevens
- Resultaten zijn ondernemingen en vestigingen; groepeer op enterprise_number voor unieke ondernemingen.
- Een Belgisch btw-nummer is BE gevolgd door het ondernemingsnummer. Een ondernemingsnummer bewijst geen btw-plicht; verwijs voor geldigheid naar VIES.
- Personen zijn zelfstandigen, geen lijst van bestuurders, aandeelhouders of uiteindelijke eigenaars.
- KBO-gegevens zijn een momentopname: vermeld snapshot_date bij details. Datums uit KBO gebruiken DD-MM-JJJJ.
- Peppol wordt apart via DNS opgezocht; vermeld checked_at. Resultaten worden kort gecachet.
- registered betekent registratie, niet bevestigde factuurondersteuning. unavailable betekent een mislukte controle, niet afwezigheid.
- Zoek ook op volledige of gedeeltelijke ondernemingsnummers: BE 0123.456.749, 0123 456 of 456749. BE, punten en spaties worden genormaliseerd.
- Gebruik ondernemingsnummers om resultaten te onderscheiden. Verzin geen ontbrekende gegevens.
- Ruiselede wordt herkend als postcode 8755 binnen Wingene. Andere plaatsnamen worden als zoektekst behandeld.
- Persoonsgegevens uit KBO mogen niet worden hergebruikt voor direct marketing.

## Bronnen
- [Kruispuntbank van Ondernemingen](https://economie.fgov.be/nl/themas/ondernemingen/kruispuntbank-van): Bron van de ondernemingsgegevens (KBO Open Data).
- [VIES](https://ec.europa.eu/taxation_customs/vies/): Officiële controle van de geldigheid van btw-nummers.