Stuur een Europees BTW-nummer (incl. landcode-prefix) en ontvang realtime een validatieresultaat via het officiële VIES-systeem van de Europese Commissie. De API retourneert naast geldigheid ook de bedrijfsnaam en het adres, indien de lidstaat deze deelt. Ondersteunt alle 27 EU-lidstaten en Noord-Ierland (XI).
Controleer het BTW-nummer van een zakelijke klant bij het plaatsen van een bestelling om BTW-vrijstelling correct toe te passen bij intracommunautaire leveringen.
Valideer automatisch het BTW-nummer wanneer een nieuw bedrijfscontact wordt aangemaakt, zodat je altijd met geverifieerde gegevens werkt.
Verifieer BTW-nummers van leveranciers vóór factuurverwerking om fouten en terugvorderingen bij de Belastingdienst te voorkomen.
Toon direct feedback bij het invullen van het BTW-veld in een registratieformulier, zodat gebruikers direct weten of hun nummer correct is ingevoerd.
Alle 27 EU-lidstaten plus Noord-Ierland (prefix XI). Het Verenigd Koninkrijk (GB) is niet meer beschikbaar na Brexit (01-01-2021).
Sommige lidstaten, zoals Duitsland en Oostenrijk, delen naam en adres niet via VIES vanwege privacywetgeving. In dat geval is company: null terwijl valid: true.
VIES bevraagt de nationale belastingdienst realtime. Als die offline is, retourneert de API HTTP 503 met valid: null en error: "ms_unavailable". Je kunt het verzoek na enkele minuten opnieuw proberen.
Stuur het nummer inclusief de 2-letterige landcode-prefix als vat_number-parameter, bijvoorbeeld NL820646660B01 of DE123456789.
Momenteel ondersteunt de API alleen single-nummer validatie. Voor bulk-validatie kun je meerdere verzoeken na elkaar uitvoeren of neem contact op voor maatwerk oplossingen.
Onze API biedt een eenvoudige REST-interface, ingebouwde foutafhandeling en caching, zodat je snel en betrouwbaar BTW-validatie kunt integreren zonder zelf de complexiteit van VIES te hoeven beheren.
Indien er nog een gecachte versie van de validatie beschikbaar is, wordt deze teruggegeven. Anders retourneert de API HTTP 503 met valid: null en error: "ms_unavailable". Je kunt het verzoek na enkele minuten opnieuw proberen.
Integreren in jouw applicatie? Probeer onze codevoorbeelden hieronder of bekijk de volledige documentatie voor meer details en extra talen en/of collecties.
curl "https://api.getapi.nl/api/v1/validate/vat?vat_number=value" \
--header "X-Api-Key: ga_live_YOUR_KEY"const response = await fetch('https://api.getapi.nl/api/v1/validate/vat?vat_number=value', {
method: 'GET',
headers: {
'X-Api-Key': 'ga_live_YOUR_KEY',
},
});
const data = await response.json();$ch = curl_init();
$headers = [
'X-Api-Key: ga_live_YOUR_KEY',
];
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.getapi.nl/api/v1/validate/vat?vat_number=value',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $headers,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);import requests
headers = {
'X-Api-Key': 'ga_live_YOUR_KEY',
}
params = {
'vat_number': 'value',
}
response = requests.get('https://api.getapi.nl/api/v1/validate/vat', headers=headers, params=params)
data = response.json(){
"valid": true,
"vat_number": "NL820646660B01",
"country_code": "NL",
"request_date": "2026-03-20T18:25:46.822Z",
"company": {
"name": "ABN AMRO BANK N.V.",
"address": "GUSTAV MAHLERLAAN 00010\n1082PP AMSTERDAM"
},
"error": null,
"message": "BTW-nummer is geldig."
}Overzicht van alle velden die de API teruggeeft in een succesvol antwoord.
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
valid
|
boolean | ja | |
vat_number
|
string | ja | |
country_code
|
string | ja | |
request_date
|
string | ja | |
company
|
object null | ja | |
└ name
|
string | ja | |
└ address
|
string null | ja | |
error
|
string null | ja | |
message
|
string | ja |
| Tier | Rate limit | Kosten per call |
|---|---|---|
| Betaald | Alleen beschikbaar bij een abonnement. | |
| Premium | 60 verzoeken/min | 1.00 credit |
Credits worden afgeschreven per succesvol verzoek. Bekijk onze prijzen voor meer informatie over creditpakketten.
Documentatie & codevoorbeelden
Bekijk de volledige API-referentie met authenticatie, endpoints en automatisch gegenereerde codevoorbeelden in cURL, PHP, JavaScript en Python.