apyhub
DATA VALIDATION · FINANCE

Validate EU VAT API

Hosted on ApyHub

What it does

VAT Number Validator checks whether a VAT number is valid. Send a VAT value in the request body, including the 2-letter country code prefix, and get a boolean result back in data.

Use it when you need to confirm a customer, supplier, or invoice tax ID before storing it, billing against it, or passing it into another workflow. The service is focused on a single check, so the response stays simple and easy to consume in validation flows.

The request schema only accepts one field: vat. The response schema only returns data, which is true or false depending on the result. That makes it a good fit for signup forms, tax compliance checks, and order systems that need a quick VAT verification step without extra parsing.

POST
Validate a VAT number
http://localhost:8080/apyhub/validate-vat-number
QUICKSTARTGUIDE

Quickstart

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

curl -X POST "http://localhost:8080/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.