apyhub
Back
DATA VALIDATION · FINANCE

Validate EU VAT API

Hosted on ApyHub

What it does

The VAT Validation API checks whether an EU VAT number is valid. Send the number with its two-letter country prefix, get back true or false.

Use it before you invoice. A wrong VAT number on a B2B invoice means the reverse charge does not apply, and the tax becomes your problem rather than your customer's. Checking at signup costs one call. Finding out at audit costs considerably more.

It fits three places in most products. On the signup or checkout form, when a business customer enters their VAT number. On supplier onboarding, before the first payment goes out. And as a periodic job over stored records, because VAT registrations get cancelled and nobody tells you.

Need more than a yes or no? The VAT Company Lookup API returns the registered company name and address behind the number, which is what you need when the invoice has to carry the legal entity. Checking a list rather than one number? The Validate EU VAT Batch API takes up to 10 per request.

POST
Validate a VAT number
https://api.eu.apyhub.com/apyhub/validate-vat-number

QUICKSTART

GUIDE

Quickstart

Validate a VAT number by sending it in a simple JSON body.

curl -X POST "https://api.eu.apyhub.com/apyhub/validate-vat-number" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"vat":"NL862735944B01"}'

What you'll get back

Returns a JSON object with a data boolean field — true when the VAT number is valid, false otherwise.

{
  "data": true
}
TRY ITLIVE · 50 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
VAT number including 2-letter country code prefix.

About this endpoint

What it does

Validates a VAT number submitted in the request body and returns a boolean result indicating whether it is valid.

Request Body

ParameterTypeMandatoryDescription
vatStringYesVAT number including a 2-letter country code prefix.

Response

Returns a JSON object with a data boolean field — true when the VAT number is valid, false otherwise.

ParameterTypeMandatoryDescription
dataBooleanYesValidation result for the submitted VAT number.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.