API voor btw-nummercontrole

Controleer het, en kun het bewijzen.

VerifyVAT vraagt de btw-nummers van je zakenpartners live op bij VIES en bewaart bij elke controle het officiële consultatienummer. Zo kun je later laten zien dat je hebt gecontroleerd, en wanneer.

Gratis registreren Inloggen

Nieuwe accounts starten met 1.000 aanvragen per maand.

ControlebewijsVoorbeeld

Aanvraagcode: VV-3F9A1C2E
Gecontroleerd btw-nr.: DE123456789
Resultaat: geldig
Bedrijf (volgens VIES): Muster GmbH
Aanvrager: LU32633157
Tijdstempel: 2026-10-11 01:14:09

Consultatienummer (VIES)

WAPIAAAAZ4Kq8vDn

Opgeslagen in je account, terug te vinden in de geschiedenis en als CSV.

bewezen

27 + XI: EU-lidstaten en Noord-Ierland, gedekt via VIES
VV-…: Een unieke aanvraagcode voor elke afzonderlijke controle
Bewijs: Het officiële consultatienummer wordt bij elke aanvraag bewaard
CSV: Volledige geschiedenis als export voor boekhouding en controles

01Waarom controleren?

Een geldig btw-nummer bepaalt vaak de belastingbehandeling

Wie verkoopt aan bedrijven in andere EU-landen moet weten met wie hij zaken doet. Het btw-nummer van de partner is daarvoor het sleutelgegeven, en de geldigheid kan veranderen.

Vrijgestelde leveringen

Intracommunautaire leveringen aan ondernemers in een ander EU-land zijn in de regel alleen vrijgesteld als de klant een geldig btw-nummer gebruikt. Kun je dat niet aantonen, dan loop je risico op een naheffing.

Btw-verlegging bij diensten

Bij veel B2B-diensten is de afnemer de btw verschuldigd. De controle laat zien dat je klant als ondernemer is geregistreerd voordat je zonder btw factureert.

Bewijs bij een belastingcontrole

De fiscus kan later vragen of en wanneer je hebt gecontroleerd. Met aanvraagcode, tijdstempel en consultatienummer heb je een antwoord dat je niet hoeft te reconstrueren.

Dit is geen belastingadvies. Welk bewijs jij nodig hebt, bespreek je met je belastingadviseur.

02Eenvoudig of gekwalificeerd

Het verschil tussen “geldig” en “bewezen”

VIES kent twee soorten aanvragen. Voor de documentatie telt de tweede.

Eenvoudige aanvraag

Je stuurt alleen het nummer van je partner. VIES antwoordt of het geldig is. Er is geen kenmerk voor de aanvraag, dus je hebt alleen je geheugen of een screenshot.

GET /check?vat_number=DE123456789
→ { "valid": true }

Dit doet VerifyVAT bij elke aanvraag

Aanvraag met aanvrager

Je geeft ook je eigen btw-nummer op. VIES geeft dan een consultatienummer af voor precies deze aanvraag. VerifyVAT stuurt je btw-nummer automatisch mee en bewaart het nummer.

GET /check?vat_number=DE123456789
→ { "valid": true,
    "consultation_number": "WAPIAAAAZ4Kq8vDn" }

Hoe het werkt

Van registratie tot je eerste controle duurt het enkele minuten.

1
Account aanmaken
Je registreert met de gegevens van je bedrijf, inclusief je eigen btw-nummer. Dat gaat bij elke controle als aanvrager naar VIES; alleen zo geeft VIES een bewijs af.
2
Sleutel aanmaken
In het dashboard maak je per toepassing een API-sleutel aan, bijvoorbeeld voor webshop of ERP. Een sleutel kun je altijd intrekken.
3
Aanvragen versturen
Je stuurt het btw-nummer van je klant naar de API. Antwoord, consultatienummer en onze eigen aanvraagcode worden direct opgeslagen.

04Voor ontwikkelaars

Eén aanvraag, één antwoord

De API is een eenvoudige GET-aanroep met je sleutel in een header. Je krijgt JSON terug met het resultaat, de bedrijfsgegevens volgens VIES en het bewijs. Schrijf het btw-nummer van de klant met landcode, bijvoorbeeld DE123456789.

Elke aanvraag krijgt een unieke code (VV-…), ook als die mislukt.
Maandquotum en limiet per minuut gelden per account en zijn zichtbaar in het dashboard.
Is VIES niet bereikbaar, dan krijg je een 502 en de aanvraagcode. Er wordt niets ten onrechte als geldig gemeld.

Aanvraag

curl "https://verifyvat.eu/api/v2/check?vat_number=DE123456789" \
  -H "apikey: vat_xxxxxxxx_xxxxxxxxxxxxxxxx"

Antwoord

{
  "request_code": "VV-3F9A1C2E",
  "valid": true,
  "query": "DE123456789",
  "company_name": "Muster GmbH",
  "company_address": "Musterstraße 1, 10115 Berlin",
  "consultation_number": "WAPIAAAAZ4Kq8vDn",
  "vies_request_date": "2026-10-11T01:14:09.000Z",
  "proof_available": true
}

De velden van het antwoord

request_code: Je aanvraagcode (VV-…). Doorzoekbaar in het dashboard.
valid: true als VIES het nummer als geldig kent, anders false.
company_name / company_address: Naam en adres volgens VIES, voor zover de lidstaat ze verstrekt.
consultation_number: Het consultatienummer van VIES. Dit is je bewijs.
vies_request_date: Tijdstip van de aanvraag volgens VIES.
proof_available: true als VIES een consultatienummer heeft afgegeven.

Statuscodes

Een ongeldig nummer is geen fout: je krijgt 200 en valid: false.

200: Aanvraag verwerkt, resultaat in het veld valid.
400: vat_number ontbreekt of heeft een ongeldig formaat.
401: De apikey-header ontbreekt, of de sleutel is ongeldig of ingetrokken.
402: Het maandquotum is opgebruikt.
403: Er is nog geen eigen btw-nummer in het account opgeslagen.
429: De limiet per minuut is overschreden. Even wachten en opnieuw proberen.
502: VIES is momenteel niet bereikbaar. De aanvraag is met code opgeslagen.

Wat je in je account ziet

Het dashboard is zo opgezet dat je elke controle later in seconden terugvindt.

Geschiedenis

Alle aanvragen met code, resultaat, bedrijf, consultatienummer en tijdstempel. Doorzoekbaar op code, btw-nummer en consultatienummer.

CSV-export

De volledige geschiedenis als bestand voor boekhouding of belastingcontrole.

Handmatige controle

Controleer één nummer met de hand. Je bedrijf is al ingevuld als aanvrager.

Meerdere sleutels

Eén sleutel per systeem, afzonderlijk in te trekken, zodat je altijd weet waar een aanvraag vandaan kwam.

Gebruik

Gebruikt en resterend maandquotum, limiet per minuut en slagingspercentage in één oogopslag.

Hulp

Documentatie met voorbeelden en een supportformulier dat je vanaf elke pagina bereikt.

Waarvoor teams het gebruiken

Webshop en checkout

Controleer het btw-nummer op het moment dat een klant het in de checkout invult en maak de factuur daarop aan.

ERP en boekhouding

Controleer nieuwe debiteuren bij het aanmaken en controleer je bestand regelmatig opnieuw. Bewaar het consultatienummer bij de boeking.

SaaS en onboarding

Verifieer zakelijke klanten bij aanmelding zonder dat iemand handmatig op een overheidssite hoeft te zoeken.

06Beveiliging

Je toegang en gegevens zijn beschermd

Je vertrouwt ons API-toegang en bedrijfsgegevens toe. Daarom gelden deze basisregels:

Versleutelde verbinding

Alle aanroepen lopen via HTTPS.

API-sleutels beschermd

Sleutels worden versleuteld opgeslagen en zijn altijd afzonderlijk in te trekken.

Bescherming tegen misbruik

Inloggen en API zijn beperkt tegen gokken en overbelasting.

Gescheiden accounts

Elke klant ziet alleen zijn eigen aanvragen en sleutels.

Begrippen kort uitgelegd

Btw-nummer: Btw-identificatienummer. Het begint met een landcode, bijvoorbeeld NL voor Nederland, gevolgd door het nummer.
VIES: Het btw-informatie-uitwisselingssysteem van de Europese Commissie. Het stuurt je aanvraag door naar de nationale belastingdienst.
Consultatienummer: Het kenmerk waaronder VIES een aanvraag met aanvrager vastlegt.
Aanvrager: Dat ben jij: je eigen btw-nummer, dat met de aanvraag wordt meegestuurd.
Aanvraagcode: De korte code VV-… van VerifyVAT. Uniek per aanvraag en doorzoekbaar in het dashboard.

Veelgestelde vragen

Waarom heb ik mijn eigen btw-nummer nodig?+

VIES geeft een consultatienummer alleen af als de aanvrager is opgegeven. Zonder opgeslagen btw-nummer is de API daarom niet ingeschakeld.

Wat is het consultatienummer?+

Het is het kenmerk waarmee VIES een aanvraag met aanvrager vastlegt. Je bewaart het als bewijs bij je administratie.

Waar komen de gegevens vandaan?+

Alles komt uit VIES, de dienst van de Europese Commissie. VerifyVAT is geen aanbod van de Europese Commissie.

Welke landen worden gecontroleerd?+

Alle 27 EU-lidstaten plus Noord-Ierland (XI). Nummers uit Zwitserland, het Verenigd Koninkrijk of andere derde landen kent VIES niet.

Wat betekent “ongeldig”?+

VIES kent het nummer op het moment van de aanvraag niet als geldig. Dat kan een typefout zijn, een nog niet geactiveerd of een verwijderd nummer. Vraag bij twijfel na bij je zakenpartner.

Wat gebeurt er als VIES niet bereikbaar is?+

Dan antwoordt de API met 502 en krijg je de aanvraagcode. Er wordt niets als geldig gemeld. Je kunt de aanvraag later opnieuw versturen.

Kan ik het ook zonder programmeren gebruiken?+

Ja. Het dashboard heeft een handmatige controle, met je bedrijf al ingevuld als aanvrager.

Wat kost het?+

Op dit moment niets. Je quotum zie je in je dashboard.

Klaar voor je eerste controle?

Account aanmaken, sleutel genereren, aan de slag. Het kost enkele minuten.