AccountCloud
ENMaak een testsleutel

Btw-nummers controleren bij VIES, met bewijs.

Controleer een EU-btw-nummer bij VIES, het systeem van de Europese Commissie. Je krijgt terug of het geldig is, de naam en het adres als de lidstaat die deelt, en een consultatienummer als bewijs.

Maak een testsleutelLees de gids
Status
PreviewBouw er nu mee met een testsleutel. In preview kan er nog iets veranderen voordat het algemeen beschikbaar is.
Prijs
prijs volgt
Operaties
vat.validate
Docs
De gidsAPI-referentieTestwaardenDe docs zijn in het Engels.

Wat het doet

Wat het doet

Stuur een btw-nummer met de landcode ervoor, zoals NL123456789B01. Spaties, punten en streepjes mogen. We controleren eerst of het nummer het formaat van zijn land heeft. Klopt dat, dan vragen we het op dat moment na bij VIES. Een eerder antwoord gebruiken we nooit opnieuw.

Het consultatienummer

Bij een controle geeft VIES een consultatienummer terug: het bewijs dat je het nummer op dat moment hebt gecontroleerd. Bewaar het bij de factuur, bijvoorbeeld als je de btw verlegt naar een afnemer in een ander EU-land.

Goed om te weten

  • Een nummer in het verkeerde formaat is een 200 met valid: false en format_valid: false. VIES wordt dan niet gevraagd, en het kost niets.
  • Ligt VIES of het register van een lidstaat eruit, dan krijg je 503 provider_unavailable, ook zonder kosten. Probeer het opnieuw na Retry-After.
  • Het werkt voor de EU-lidstaten en Noord-Ierland (XI). Nummers van buiten de EU, zoals GB, krijgen 404 country_not_supported.
  • Btw-tarieven per land zitten nog niet in de API.

Voorbeeld

Echte calls met een testsleutel. Vervang ac_test_… door je eigen sleutel.

Een geldig Nederlands btw-nummer. Bewaar het consultatienummer bij de factuur.
GET/v1/vat-numbers/NL999999990B01
Request
curl https://api.accountcloud.io/v1/vat-numbers/NL999999990B01 \
  -H "Authorization: Bearer ac_test_…"
Response200 OK
AccountCloud-Charged: 0.0000
{
  "object": "vat_number",
  "vat_number": "NL999999990B01",
  "country": "NL",
  "valid": true,
  "format_valid": true,
  "name": "TESTBEDRIJF B.V.",
  "address": "TESTSTRAAT 00001\n1234AB AMSTERDAM",
  "consultation_number": "WAPITEST00000001",
  "source": {
    "register": "vies",
    "name": "VIES (European Commission)",
    "retrieved_at": "2026-11-04T01:03:36Z"
  }
}

Wat het kost

Btw-nummersprijs volgtcontroleren via VIES

Exclusief btw, van je tegoed. Testsleutels zijn gratis, en een fout of ongeldige invoer kost niets.

Zolang er geen prijs is, krijgt een live-sleutel 503 operation_unavailable. Testsleutels werken al.

Verder lezen

Begin met een testsleutel. Die is gratis.

Aanmelden kost een minuut. De quickstart in de docs vijf.

Maak een testsleutelLees de gids