apyhub
Back
▣ VERIFICATION KIT

Validate European VAT Numbers API

What it does

The Validate European VAT Numbers API checks VAT numbers against the official registers: EU VIES for the 27 member states and Northern Ireland (XI), the Brønnøysund Register Centre for Norway, and the Swiss UID register for Switzerland. Send up to 100 numbers in vatNumbers and get back one row per number in items, with a status (valid, invalid, invalid_format or unavailable), the registered name and address where the register shares them, and the source that answered.

Numbers can include spaces, dots and dashes, and lowercase prefixes are accepted. Use EL for Greece, XI for Northern Ireland, NO…MVA for Norway and CHE-… for Switzerland. Set defaultCountry for numbers sent without a prefix. Add your own EU number in requesterVatNumber and VIES returns a consultation_number for each EU check, which you can keep as proof for a tax audit. Malformed numbers are rejected locally without an upstream call, and a member state that does not answer is reported as unavailable, not as invalid.

Use it to check customers before you invoice without VAT, to vet suppliers during onboarding, or to clean VAT numbers in a CRM. UK (GB) VAT numbers are not covered.

POST
VAT Validation API - EU VIES + Norway + Switzerland
https://api.eu.apyhub.com/martin10291/validate-european-vat-numbers

QUICKSTART

GUIDE

Quickstart

Validate two VAT numbers in one call.

curl -X POST "https://api.eu.apyhub.com/martin10291/validate-european-vat-numbers" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"vatNumbers": ["IE6388047V", "DE811569869"]}'

What you'll get back

Returns a JSON object with count, billed and an items array, one row per VAT number with its status, the registered name and address where the register shares them, and the source that answered.

{
  "billed": 2,
  "count": 2,
  "items": [
    {
      "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
      "checked_at": "2026-11-17T08:40:11Z",
      "consultation_number": null,
      "country": "Ireland",
      "country_code": "IE",
      "error": null,
      "full_vat_number": "IE6388047V",
      "input": "IE6388047V",
      "name": "GOOGLE IRELAND LIMITED",
      "response_ms": 1,
      "source": "EU VIES (European Commission)",
      "source_checked_at": "2026-11-17T08:33:20.321Z",
      "status": "valid",
      "valid": true,
      "vat_number": "6388047V"
    },
    {
      "address": null,
      "checked_at": "2026-11-17T08:40:11Z",
      "consultation_number": null,
      "country": "Germany",
      "country_code": "DE",
      "error": null,
      "full_vat_number": "DE811569869",
      "input": "DE811569869",
      "name": null,
      "note": "Germany does not share the company name/address through VIES; the number itself is valid",
      "response_ms": 0,
      "source": "EU VIES (European Commission)",
      "source_checked_at": "2026-11-17T08:33:21.293Z",
      "status": "valid",
      "valid": true,
      "vat_number": "811569869"
    }
  ]
}
TRY ITLIVE · 100 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*
vatNumbers*
VAT numbers with country prefix, up to 100 per call. Spaces, dots and dashes are ignored. EU: DE811569869, IE6388047V, EL for Greece, XI for Northern Ireland. Norway: NO923609016MVA. Switzerland: CHE-116.281.710 MWST. UK (GB) numbers are not supported.
Two-letter country code used for numbers sent without a prefix, e.g. DE. Not case sensitive.
Your own EU VAT number with prefix. VIES then returns a consultation_number for each EU check, which you can keep as proof for a tax audit.

About this endpoint

What it does

Validates up to 100 VAT numbers in one request against EU VIES, the Norwegian business register and the Swiss UID register, and returns one result row per number with its status and, where the register shares them, the registered name and address.

Request Body

ParameterTypeDescription
vatNumbersString ArrayRequired. VAT numbers with their country prefix, for example IE6388047V, DE811569869, EL094014201 (Greece), XI220430231 (Northern Ireland), NO923609016MVA (Norway) or CHE-116.281.710 MWST (Switzerland). Spaces, dots and dashes are ignored and prefixes are not case sensitive. Minimum 1 item, max 100 items. Empty values, hidden characters (zero-width space, BOM) and markup are rejected with 400.
defaultCountryStringTwo-letter country code used for numbers sent without a prefix, for example DE. Not case sensitive. An unknown code makes those rows invalid_format.
requesterVatNumberStringYour own EU VAT number with prefix. When set, VIES returns a consultation_number for each EU check, and the result is always fetched live. Must be a valid EU VAT number format, otherwise the request fails with 400.

Response

Returns a JSON object with count, billed and an items array with one row per distinct VAT number, in the order sent. Every row has the same fields; fields the register does not provide are null.

ParameterTypeDescription
countIntegerNumber of rows in items.
billedIntegerProvider-side count of rows that got a register answer. invalid_format and unavailable rows are not counted. ApyHub charges per call, not per row.
itemsObject ArrayOne result per VAT number.
items[].inputStringThe number as you sent it (leading and trailing spaces removed).
items[].statusENUMAllowed values: valid, invalid, invalid_format, unavailable. valid: registered. invalid: not registered. invalid_format: wrong layout or unknown prefix, checked locally with no upstream call. unavailable: the register did not answer; this is not a verdict on the number, retry later.
items[].validBooleantrue for valid, false for invalid and invalid_format, null for unavailable.
items[].country_codeStringCountry code, for example IE, EL, XI, NO, CH. null when the prefix is unknown.
items[].countryStringCountry name. null when the prefix is unknown.
items[].vat_numberStringThe number without its country prefix.
items[].full_vat_numberStringThe cleaned number with prefix, for example CHE116281710. null when the prefix is unknown.
items[].nameStringRegistered name. null when the register does not share it (for example Germany and Spain) or the number is not valid.
items[].addressStringRegistered address. Same conditions as name.
items[].sourceStringRegister that answered: EU VIES (European Commission), Bronnoysund Register Centre (Norway) or Swiss Federal UID register. null for invalid_format rows.
items[].consultation_numberStringVIES consultation number, only when requesterVatNumber is set and the number is an EU number. Otherwise null.
items[].errorStringReason for an invalid_format or unavailable row (and some Norwegian invalid rows). null otherwise.
items[].noteStringOnly present on some rows, for example when a member state does not share the name and address.
items[].bankruptBooleanNorway only. Whether the company is registered as bankrupt.
items[].in_liquidationBooleanNorway only. Whether the company is in liquidation.
items[].checked_atStringTime this row was produced, ISO 8601 UTC.
items[].source_checked_atStringEU rows only. Time the register was actually queried. Earlier than checked_at when the answer was served from cache.
items[].response_msIntegerUpstream response time in milliseconds. 0 when served from cache or checked locally.

Notes

  • Repeated numbers in one request return a single row.
  • UK (GB) VAT numbers are not supported and return invalid_format.
  • A request with exactly one number whose register does not answer returns 502 with code: upstream_unavailable; in a multi-number request the same number gets an unavailable row instead.
  • Errors use one shape: {"code": "invalid_input", "error": "...", "message": "..."}.
▣ 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.