---
title: "Btw-nummer controleren - deboeck.dev"
description: "Controleer een Europees btw-nummer via VIES. Probeer het op deze pagina, of stuur zelf een verzoek naar het open eindpunt op api.deboeck.dev. Geen sleutel nodig."
url: "https://deboeck.dev/btw"
author: "Hans De Boeck"
language: "nl-BE"
---

# Een btw-nummer controleren

Tik een nummer in en je ziet wat het open eindpunt antwoordt: naam, adres en bron. Hetzelfde verzoek mag je zelf sturen, zonder sleutel.

*Op de webpagina staat hier een formulier.*

Of probeer:

Punten en spaties mag je laten staan. Een Belgisch nummer mag ook zonder BE ervoor. Een bot-controle van Cloudflare kijkt mee, en die laat zich zelden zien.

## Wat je ermee kunt

### Formulieren invullen

Een klant geeft enkel het nummer in, en je formulier vult zelf naam en adres aan. Minder tikwerk, minder fouten.

### Webshop en checkout

Controleer het nummer op het moment van de bestelling, en zie meteen of het bestaat en op wie het staat.

### Facturatie

Kijk na voor je factureert, zodat de factuur op de juiste naam en het juiste adres staat.

### Je klantenbestand

Zie welke nummers niet meer bestaan of op een andere naam staan. Voor lange lijsten neem je het pakket.

## Wat je terugkrijgt

{"valid": true,"vat_number": "BE0720529757","name": "De Boeck, Hans","address": {"street": "Ros Beiaardstraat","number": "14","zip_code": "9200","city": "Dendermonde","country": "Belgi\u00eb","country_code": "BE"},"source": "vies"}

Bestaat het niet, dan blijft de status 200: de vraag was geldig, het antwoord is enkel negatief.

{"valid": false,"vat_number": "BE0000000097","error": "Invalid VAT number"}

valid

true of false. Staat altijd in het antwoord, ook bij een fout.

vat_number

Het nummer zoals het opgezocht is: hoofdletters, landcode ervoor, zonder punten of spaties.

name

De naam waarop het nummer staat.

address.street

De straat, zonder huisnummer.

address.number

Het huisnummer, apart. Niet elke bron levert dat, dan blijft het leeg.

address.zip_code

De postcode.

address.city

De gemeente.

address.country

Het land voluit, in het Nederlands. Leeg voor landen buiten de lijst.

address.country_code

De landcode van twee letters.

source

Welke bron antwoordde: vies, cbw (controleerbtwnummer.eu) of btwo (btw-opzoeken.be).

error

Staat er enkel bij valid: false, en zegt waarom.

## Zo bouw je het in

### Eerst proberen

Het eindpunt is open: geen sleutel, geen token, geen registratie. Een GET volstaat, het antwoord is altijd JSON.

De rem staat op **vijf verzoeken per minuut per ip-adres**. Daarboven krijg je een 429 met een Retry-After. Hoeveel je er nog over hebt staat in X-RateLimit-Remaining.

curl -s https://api.deboeck.dev/v1/btw/BE0720529757

### Op je website

Het eindpunt stuurt de nodige cors-koppen mee, dus een fetch vanaf je eigen site werkt. Dit voorbeeld vult naam en gemeente in zodra iemand het nummer heeft ingetikt.

Hou er rekening mee dat de vijf per minuut dan per bezoeker tellen, niet per site.

const veld = document.querySelector('#btw');veld.addEventListener('change', async () => {const antwoord = await fetch('https://api.deboeck.dev/v1/btw/' + encodeURIComponent(veld.value)).then((r) => r.json());if (antwoord.valid) {document.querySelector('#naam').value = antwoord.name;document.querySelector('#gemeente').value = antwoord.address.city;}});

### In een Laravel-project

Een gewoon verzoek met de Http-client van Laravel. Meer heb je niet nodig.

use Illuminate\Support\Facades\Http;$antwoord = Http::acceptJson()->timeout(10)->get('https://api.deboeck.dev/v1/btw/BE0720529757')->json();if ($antwoord['valid'] ?? false) {echo $antwoord['name'];echo $antwoord['address']['city'];}

### Op je eigen server

Er hangt geen sla aan dit eindpunt: het draait mee op deze site en ligt eruit wanneer VIES eruit ligt. Zit het in een stroom die niet mag haperen, installeer dan het pakket en laat de opzoeking bij jou draaien.

Dezelfde code, dezelfde bronnen, jouw server. Het staat bij de andere [Laravel packages](https://deboeck.dev/laravel-packages).

composer require hansdeboeck/laravel-vat-validator

## Goed om te weten

200

Er is een antwoord. Lees valid om te weten of het nummer bestaat.

422

Wat je stuurde heeft de vorm van geen enkel btw-nummer. Er is niets opgezocht.

429

Meer dan vijf verzoeken in een minuut vanaf hetzelfde ip. Retry-After zegt hoe lang je moet wachten.

### Waar het op steunt

De opzoeking vraagt het eerst aan [VIES](https://ec.europa.eu/taxation_customs/vies/), de databank van de Europese Commissie. Antwoordt die niet, dan gaan controleerbtwnummer.eu en btw-opzoeken.be de vraag na. Welke bron het werd, staat in source.

### Elk nummer mag

Het nummer mag met of zonder punten en spaties. Een Belgisch ondernemingsnummer van negen of tien cijfers krijgt er vanzelf BE voor. Wat je terugkrijgt blijft een dag in cache, dus hetzelfde nummer twee keer opzoeken kost de bron niets.

### Meer dan naam en adres

Bestuurders, vestigingen, jaarrekeningen, akten en subsidies van een Belgische onderneming staan op [btwzoeken.be](https://btwzoeken.be), een eigen site op de openbare registers, zonder aanmelding en zonder betaalmuur.

### Meer dan vijf per minuut

Er bestaat een ruimere versie met een sleutel, en een variant op RapidAPI. Laat weten wat je nodig hebt, dan zetten we dat op: [hans@deboeck.dev](mailto:hans@deboeck.dev).

## Even controleren

Cloudflare gaat kort na of je geen robot bent. Dat duurt een paar tellen.
