{"uid":"cap_8TAmAUWYiDvmBrpcgmZ4l","slug":"eu-vat-number-validation-via-vies-492d7f14","name":"EU VAT Number Validation via VIES","description":"EU VAT number validation against the European Commission's official VIES service, a live query of the issuing member state's national VAT register. Give a VAT id with country prefix (27 EU states plus XI) and get whether it is valid for intra-EU trade, plus registered name and address where the state discloses them. Use it for B2B invoicing and reverse-charge checks, customer onboarding/KYB and supplier data cleaning. Norway is not in VIES: use /firma.","url":"https://nordata.hihat.workers.dev/mva?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["vat"],"properties":{"vat":{"type":"string","description":"EU VAT identification number with its 2-letter country prefix, e.g. IE6388047V, NL810433941B01 or SE556036079301. Lowercase, spaces, dots and dashes are accepted and normalised; GR is mapped to EL. Prefixes: AT BE BG CY CZ DE DK EE EL ES FI FR HR HU IE IT LT LU LV MT NL PL PT RO SE SI SK XI (Northern Ireland). Norway (NO), the UK (GB) and Switzerland are not in VIES."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"const":"json"},"example":{"type":"object","properties":{"vat":{"type":"string"},"land":{"type":"string"},"navn":{"type":"string"},"kilde":{"type":"string"},"gyldig":{"type":"boolean"},"hentet":{"type":"string"},"nummer":{"type":"string"},"adresse":{"type":"string"},"sjekket":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KY_QTSKVE07wRneu4p75j","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an EU VAT identification number against the European Commission's official VIES service and returns validity status, registered name, and address.","exampleAgentPrompt":"Can you check whether the VAT number IE6388047V is valid for intra-EU trade and tell me the registered business name and address on file?","exampleUseCases":[{"title":"Reverse-charge invoice compliance check","prompt":"Before I issue this B2B invoice, can you verify that VAT number NL810433941B01 is currently registered and valid in the EU, and pull the official business name so I can put it on the invoice?"},{"title":"Customer onboarding KYB validation","prompt":"We have a new customer who gave us their VAT number DE811128135 during sign-up — can you confirm it's active and give me the registered company name and address so we can complete KYB?"},{"title":"Supplier data cleanup","prompt":"I'm cleaning up our supplier list and need to check if the VAT number SE556036079301 is still valid and matches the registered name and address we have on file for them."}],"resultDescription":"Returns a JSON object with fields: vat (normalized VAT number), land (country code), navn (registered business name if disclosed by member state), adresse (registered address if disclosed), gyldig (boolean validity flag), kilde (data source), hentet (retrieval timestamp), sjekket (checked timestamp), and nummer (number portion).","failureModes":["VAT number format is invalid or unrecognized prefix — returns gyldig: false or error","VIES service for the queried member state is temporarily unavailable — returns error or timeout","Country prefix is not one of the 27 EU states or XI (e.g. NO, GB, CH) — not supported by this endpoint","VAT number exists but member state does not disclose name/address — returns gyldig: true with empty navn/adresse","Malformed or missing vat query parameter — returns 4xx error"],"whenToPreferThis":"Use this endpoint when you need a live authoritative validation of an EU VAT number against each member state's national register via VIES — ideal for B2B invoicing, reverse-charge VAT compliance, KYB onboarding, or supplier data hygiene. Covers all 27 EU member states plus Northern Ireland (XI). Do not use for Norwegian companies (NO), UK (GB) or Swiss companies — for Norwegian entities use the /firma endpoint on the same host.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:31:26.076Z","isFirstParty":false,"canonicalSlug":"eu-vat-number-validation-via-vies-492d7f14"}