Typ een ondernemingsnummer (bijvoorbeeld 0417.497.106) of een btw-nummer met landcode. De pagina vormt het btw-nummer en vraagt aan VIES, het systeem van de Europese Commissie, of het vandaag geldig is voor handel binnen de EU.
Ondernemingsnummer of btw-nummer (BE…)
curl "https://api.prometiam.com/functions/v1/risk-api/vat/BE0417497106" \ -H "Authorization: Bearer YOUR_API_KEY"
Typ het ondernemingsnummer of het btw-nummer van de factuur in het veld hierboven en klik op de knop. U krijgt “Geldig in VIES” of “Niet bevestigd door VIES”, de datum van de controle en, als België ze meedeelt, de naam en het adres. Of de onderneming bestaat en actief is, zegt VIES niet: dat zoekt u op in de KBO.
Een Belgisch btw-nummer is het ondernemingsnummer met de landcode BE ervoor: 0417.497.106 geeft BE0417497106. Het telt altijd tien cijfers en begint met een 0 of een 1. De punten en spaties op een factuur, zoals in BE 0417.497.106, negeert de tool; VIES zelf wil het nummer als één aaneengesloten reeks.
De laatste twee cijfers vormen het controlegetal: neem de eerste acht cijfers als één getal, bereken de rest bij deling door 97 en trek die rest af van 97. Bij 0417.497.106 is de rest van 04174971 gedeeld door 97 gelijk aan 91, en 97 min 91 is 06: precies de laatste twee cijfers. Zo ziet u een tikfout nog voor u iets bevraagt.
| Ondernemingsnummer | Rest van de eerste acht cijfers door 97 | 97 min die rest | Laatste twee cijfers | Uitkomst |
|---|---|---|---|---|
| 0417.497.106 | 91 | 06 | 06 | klopt |
| 0202.239.951 | 46 | 51 | 51 | klopt |
| 0417.497.107 | 91 | 06 | 07 | tikfout |
Een kloppend controlegetal bewijst enkel dat het nummer juist is geschreven. De tool zelf controleert enkel de vorm (tien cijfers, eerste cijfer 0 of 1) en laat de rest aan VIES. Is bij een nummer van negen cijfers een nul vooraan weggevallen, bijvoorbeeld door een spreadsheet, voeg ze dan weer toe.
Staat het nummer niet op de factuur, zoek de onderneming dan op in de KBO Public Search van de FOD Economie, de kosteloze officiële opzoeksite van de Kruispuntbank van Ondernemingen (KBO). Onze gratis KBO-opzoeking doet dat ook op naam of nummer, en Wat is de KBO? legt uit wat het register bevat. VIES zelf zoekt niet op naam of adres.
Op de pagina van een onderneming toont de KBO Public Search onder Hoedanigheden of ze Onderworpen aan btw is, en onder Btw-activiteiten de NACE-BEL-codes die ze voor de btw opgaf. Staat er bij Hoedanigheden “Geen gegevens opgenomen in KBO”, dan kent de KBO geen btw-gegevens voor die onderneming: ze heeft een ondernemingsnummer, maar BE plus dat nummer is niet vanzelf een btw-nummer, want niet elke onderneming of vereniging is btw-plichtig. Ook de status (“Actief”) en de rechtstoestand (“Normale toestand”) staan in de KBO, niet in VIES.
VIES is het systeem van de Europese Commissie om btw-nummers te controleren van ondernemingen die in de EU goederen of diensten over de grens leveren. Het heeft geen eigen databank: uw vraag gaat naar de nationale btw-databank van de lidstaat, voor een Belgisch nummer dus naar België.
Ook een eenmanszaak heeft een ondernemingsnummer en, als ze btw-plichtig is, een btw-nummer. De VIES-controle werkt voor haar zoals voor een vennootschap: typ het btw-nummer zoals het op de factuur staat, BE gevolgd door tien cijfers. Een bedrijfsprofiel van een eenmanszaak levert Prometiam niet: ondernemingen van natuurlijke personen worden nooit geleverd.
GET /vat/BE0417497106 vraagt VIES en geeft JSON met is_valid, name, address en request_date. GET /companies/search?country=BE&company_number=0417497106 geeft het bedrijfsrecord uit de KBO met vat_number en vat_number_source: register wanneer de KBO de btw-registratie bevestigt, rule wanneer het nummer enkel uit het ondernemingsnummer is gevormd (de vorm klopt, de registratie is niet bevestigd: controleer ze met GET /vat/{nummer}). Een fout controlegetal geeft een 400-fout (validation_error).
# 1. Btw-nummer bij VIES controleren curl 'https://api.prometiam.com/functions/v1/risk-api/vat/BE0417497106' \ -H 'Authorization: Bearer rk_live_...' # 2. Bedrijfsrecord uit de KBO, met vat_number en vat_number_source curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=BE&company_number=0417497106' \ -H 'Authorization: Bearer rk_live_...'
{
"data": {
"vat_number": "BE0417497106",
"country_code": "BE",
"number": "0417497106",
"is_valid": true,
"name": "...",
"address": "...",
"request_date": "2026-10-16T17:37:56.433Z",
"source": "VIES — VAT Information Exchange System (European Commission)"
}
}
Een controle bij VIES kost 1 credit, ook als VIES het nummer niet bevestigt; een geslaagde bedrijfsopzoeking kost er ook 1. Een aanroep die faalt (een 400, of een 503 wanneer VIES niet antwoordt) kost niets. POST /companies/lookup zoekt tot 100 ondernemingen tegelijk op, aan 1 credit per onderneming. Starter kost 9,99 € per maand met 1.000 credits, Professional 29,99 € (10.000) en Scale 99,99 € (50.000). De proefperiode duurt 14 dagen en omvat 500 credits; een betaalkaart is vereist, tijdens de proefperiode wordt niets aangerekend en daarna loopt het Starter-plan, tenzij u opzegt. Hoe de controle in e-facturatie past, leest u bij Peppol e-facturatie en tegenpartijcontrole.
Contains data from the Crossroads Bank for Enterprises (KBO/BCE), FPS Economy; see data_as_of for the date of the update. De antwoorden van /vat komen van VIES, het systeem van de Europese Commissie. Laatst nagekeken op 16 oktober 2026 aan de hand van de KBO Public Search en de VIES-website.
Start uw gratis proefperiode van 14 dagen · API-documentatie
De proefperiode duurt 14 dagen en omvat 500 credits. Een betaalkaart is vereist, tijdens de proefperiode wordt niets aangerekend; daarna loopt het Starter-plan (9,99 € per maand) tenzij u opzegt.