{"uid":"cap_KQ3T-PkjnwseguHwrfzMP","slug":"eu-vat-number-vies-validation-0dc07d76","name":"EU VAT Number VIES Validation","description":"Use when an agent needs the current official VIES validation status of an EU VAT number before B2B onboarding, invoicing or procurement. Queries the European Commission VIES REST API and returns whether the number is currently valid, plus the registered company name and address when the member state returns them. It does not give tax advice and is not proof a company is legitimate, an invoice is compliant, or a sanctions/KYC/AML check.","url":"https://agent-api-production.tim1712.workers.dev/v1/business/eu-vat-check","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"vatNumber":{"type":"string","maxLength":24,"minLength":1},"countryCode":{"enum":["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"],"type":"string"}}},"responseSchema":{"type":"json","example":{"name":"EXAMPLE HOLDING B.V.","valid":true,"source":"eu-vies","address":"EXAMPLESTRAAT 1\n1234 AB AMSTERDAM","warnings":[],"checkedAt":"2026-08-30T10:00:02.000Z","vatNumber":"123456789B01","countryCode":"NL","requestDate":"2026-08-30T00:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_755mW39vCOQIouxCUPcmt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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 number against the official European Commission VIES REST API and returns current validity status, registered company name, and address.","exampleAgentPrompt":"Can you check if VAT number NL123456789B01 is currently valid on VIES? I need the registered company name and address before I onboard them as a supplier.","exampleUseCases":[{"title":"B2B supplier onboarding check","prompt":"Before I add this new Dutch supplier to our system, can you verify their VAT number NL123456789B01 is currently valid on VIES and tell me the registered company name and address?"},{"title":"EU invoice VAT validation","prompt":"I need to issue an invoice to a German company — can you confirm that DE811428000 is a valid VAT number and give me whatever name and address VIES has on file for them?"},{"title":"Procurement due diligence","prompt":"We're about to sign a procurement contract with a French vendor who gave us VAT number FR83404833048 — can you check its current VIES status and return the official registered details?"}],"resultDescription":"A JSON object containing: whether the VAT number is currently valid (boolean), the registered company name and address (when the member state returns them), the source ('eu-vies'), the VAT number and country code echoed back, the timestamp the check was performed, the VIES request date, and any warnings (e.g. when name/address are unavailable).","failureModes":["VIES service temporarily unavailable for a specific member state — returns a warning or error indicating the national system is down","Invalid country code supplied — returns a validation error","VAT number format does not match the expected format for the country — may return invalid or an error","Member state does not return name/address — valid status returned but name and address fields are empty","Network timeout to VIES REST API — returns an error response"],"whenToPreferThis":"Use this endpoint when you need a real-time, official VIES validation of an EU or Northern Ireland (XI) VAT number before B2B onboarding, invoicing, or procurement. Prefer this over third-party VAT databases when you need the authoritative live status from the European Commission's own system. Not suitable for sanctions screening, KYC/AML checks, or formal tax compliance certificates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:50.501Z","isFirstParty":false}