apyhub

VAT Number Validator

What it does

VAT Number Validator checks up to 10 VAT numbers in one request and returns a per-item validation result. Send an array of VAT strings in vat_numbers; the response includes each vat plus a boolean valid flag, and an error field when lookup fails for that item.

Use it when you need to verify supplier tax IDs during onboarding, clean CRM records before invoicing, or flag entries that should be reviewed by finance. Because the endpoint works in batch, you can validate a small list of records without building your own loop around single-item checks.

The response is straightforward to consume: iterate over the returned data array and inspect valid for each VAT number. If a lookup cannot be completed, the item still comes back with the original vat and an explanatory error value so you can separate invalid numbers from transient lookup issues.

VAT Number Validator is a good fit anywhere you need lightweight tax-ID validation as part of a backend workflow, import job, or form review step.

POST
Validate VAT numbers in batch
https://api.eu.apyverse.com/apyhub/validate-vat-batch

QUICKSTART

GUIDE

Quickstart

Check the VAT numbers you send in a single batch request.

curl -X POST "https://api.eu.apyverse.com/apyhub/validate-vat-batch" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"vat_numbers":["DE345789108","GB123456789","FR12345678901"]}'

What you'll get back

Returns a JSON object with a data array. Each item in the array is an object with vat as a string, valid as a boolean, and optional error as a string when lookup fails for that VAT.

{
  "data": [
    { "vat": "NL862735944B01", "valid": true },
    { "vat": "GB123456789", "valid": false },
    { "vat": "FR12345678901", "valid": 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_numbers*

About this endpoint

What it does

Validates up to 10 VAT numbers in a single request and returns a result entry for each submitted VAT number. The response includes the VAT number and whether it is valid, with an error message only for items where the lookup failed.

Request Body

ParameterTypeMandatoryDescription
vat_numbersString ArrayYesVAT numbers to validate. Minimum 1 item, maximum 10 items.

Response

Returns a JSON object with a data array field. Each item in data is an object with a vat string field, a valid boolean field, and an optional error string field that is present only when lookup failed for that item.

ParameterTypeMandatoryDescription
dataObject ArrayNoArray of validation results. Each item includes vat and valid; error is present only when lookup failed for that item.
data[].vatStringNoThe VAT number that was validated.
data[].validBooleanNoWhether the VAT number is valid.
data[].errorStringNoPresent only when lookup failed for this item.

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.