getapi-nl VAT Validation API
The VAT Validation API from getapi-nl — 1 operation(s) for vat validation.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/getapi-nl:getapi-nl-vat-validation-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: GetApi VAT Validation API
version: 0.0.1
description: '## Authentication
All API endpoints require authentication. Include your API key in every request using **one** of the following methods:
**Option 1 — X-Api-Key header (recommended)**
```
X-Api-Key: ga_live_xxxxxxxxxxxxxxxxxxxx
```
**Option 2 — Bearer token**
```
Authorization: Bearer ga_live_xxxxxxxxxxxxxxxxxxxx
```
You can generate and manage API keys in your dashboard.
## AI & Agent Payments (x402)
Some endpoints support direct payments for AI agents via the **x402** protocol (https://www.x402.org).
No API key or account is needed. Send a normal request without key;
the server will respond with **HTTP 402** and a `PAYMENT-REQUIRED` header:
```
PAYMENT-REQUIRED:
```
This base64 string contains, among other things, `network`, `asset`, `amount`, and `payTo`.
Your agent signs an EIP-3009 *transferWithAuthorization* for the specified `amount` of USDC to that `payTo` address,
encodes the signature as base64, and resubmits the request with:
```
PAYMENT-SIGNATURE:
```
The server verifies the signature via a facilitator, provides the data, and settles the payment on-chain.
The success response includes a `PAYMENT-RESPONSE` header containing the transaction information.
A one-time `nonce` prevents replay attacks. Payments are made in USDC on **Base**;
the price is determined by the `credit_cost` of the endpoint.'
contact:
email: info@wdnoord.nl
x-guidance: 'GetAPI.nl is een Nederlandse API-platform voor lookups en validaties (postcode,
adres, kenteken, BTW, e-mail, KVK, IBAN, energiemaatwerk, overheidsdata). Elke
endpoint accepteert een API key via de X-Api-Key header of Authorization:
Bearer <key>.
Sommige endpoints zijn ook direct betaalbaar voor AI-agents via het x402-protocol
(https://www.x402.org) zonder account of API key: stuur een verzoek zonder key,
de server antwoordt met HTTP 402 en een PAYMENT-REQUIRED header (base64 JSON met
network, asset, amount, payTo). Teken daarna een EIP-3009 transferWithAuthorization
voor het gevraagde bedrag in USDC op Base en hertrail met een PAYMENT-SIGNATURE
header. De server verifieert, levert de data en settleert on-chain.
Tips voor agents:
- Lees eerst de PAYMENT-REQUIRED header van een 402-antwoord; die is leidend.
- Geef altijd de exact door de server gevraagde parameters mee.
- Een endpoint met een "x-payment-info" blok vereist betaling voor gebruik.'
servers:
- url: https://api.getapi.nl
description: GetAPI
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: VAT Validation
paths:
/v1/validate/vat:
post:
operationId: validation.vat
description: 'Validates a European VAT number via the official VIES system of the European Commission.
The country code must be the first two characters of the VAT number (e.g. `NL820646660B01`).
Supported countries: all 27 EU member states + Northern Ireland (XI).
When a member state provides it, the response includes the company name and address.
We use caching to mitigate VIES rate limits: valid numbers are cached for 24 hours, invalid numbers for 1 hour. When a member state is temporarily unavailable, we return a 503 status with an appropriate error message.'
summary: Validate an EU VAT number (VIES)
tags:
- VAT Validation
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
vat_number:
type: string
pattern: ^[A-Z]{2}[A-Z0-9+*]{2,13}$
minLength: 4
maxLength: 15
required:
- vat_number
responses:
'200':
description: VAT number is valid
content:
application/json:
schema:
type: object
examples:
- 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
1082PP AMSTERDAM'
error: null
message: BTW-nummer is geldig.
properties:
valid:
type: boolean
vat_number:
type: string
country_code:
type: string
request_date:
type: string
company:
type:
- object
- 'null'
properties:
name:
type: string
address:
type:
- string
- 'null'
required:
- name
- address
error:
type:
- string
- 'null'
message:
type: string
required:
- valid
- vat_number
- country_code
- request_date
- company
- error
- message
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
examples:
- valid: false
vat_number: NL123456789B01
country_code: NL
request_date: '2026-03-20T18:19:57.809Z'
company: null
message: BTW-nummer is ongeldig of niet geregistreerd.
properties:
valid:
type:
- boolean
- 'null'
vat_number:
type: string
country_code:
type: string
request_date:
type: string
company:
type:
- object
- 'null'
properties:
name:
type: string
address:
type:
- string
- 'null'
required:
- name
- address
message:
type: string
required:
- valid
- vat_number
- country_code
- request_date
- company
- message
'503':
description: Service temporarily unavailable
content:
application/json:
schema:
type: object
examples:
- valid: null
vat_number: NL820646660B01
country_code: NL
request_date: '2026-03-20T18:25:46.822Z'
company: null
error: upstream_unavailable
message: De brondata is tijdelijk niet beschikbaar. Probeer het later opnieuw.
properties:
valid:
type:
- boolean
- 'null'
vat_number:
type: string
country_code:
type: string
request_date:
type: string
company:
type:
- object
- 'null'
properties:
name:
type: string
address:
type:
- string
- 'null'
required:
- name
- address
error:
type: string
message:
type: string
required:
- valid
- vat_number
- country_code
- request_date
- company
- error
- message
'402':
description: Payment Required
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.010000'
protocols:
- x402: {}
parameters: []
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-Api-Key
BearerAuth:
type: http
scheme: bearer