{"uid":"cap_N-nm-Z2r6UM0ZvvZ_rxd8","slug":"eu-vat-number-validation-vies-28f23d9e","name":"EU VAT Number Validation (VIES)","description":"EU VAT number validation (VIES) with predictable behavior for agents. Validates any EU VAT number against the European Commission's VIES service. Two modes: fast validation (may serve a cached result, labeled with its timestamp) and consultation-proof mode (always live, returns the official consultation number, requires requester identification). 'Not confirmed' does not imply the company is invalid. Machine-readable errors with per-member-state availability status.","url":"https://agentdata-api.sander-van-aard.workers.dev/eu/vat","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object"},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gdEgYlo275gZs4CX-6NrJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates EU VAT numbers against the European Commission's VIES service, with both cached fast mode and live consultation-proof mode returning official consultation numbers.","exampleAgentPrompt":"Can you verify whether EU VAT number DE123456789 is valid? I need the official VIES consultation number for our records, so please use the live consultation-proof mode with our company name as the requester.","exampleUseCases":[{"title":"Supplier onboarding VAT verification","prompt":"Before we pay this new supplier invoice, can you validate their EU VAT number NL987654321? Just use the fast cached mode since we're in a hurry, but let me know if the result is recent or older."},{"title":"B2B invoice compliance audit trail","prompt":"I need to verify that our customer's VAT number FR123456789 is currently registered in the EU system. Can you check it in live mode and get me the official VIES consultation number? We need to include that in our audit documentation for the tax authority."},{"title":"Multi-country supplier VAT check","prompt":"We're onboarding suppliers across Europe and need to quickly validate a batch of VAT numbers from different countries. Can you check if IT456789012, ES789012345, and BE345678901 are all valid, and let me know if any of those countries' VIES systems are currently down?"}],"resultDescription":"Returns validation status (confirmed/not confirmed), company name and address if available, the consultation number (in live mode), a cache timestamp (in fast mode), and per-member-state availability status if the VIES service for that country is down. Machine-readable errors indicate when a specific member state's VIES endpoint is unavailable.","failureModes":["Member state VIES endpoint unavailable — returns per-country availability status rather than a validation result","Invalid VAT number format — returns machine-readable format error","VIES service temporarily down — returns error with availability metadata","Missing requester identification in consultation-proof mode — validation rejected","Network timeout to upstream VIES — returns error with retry guidance"],"whenToPreferThis":"Use this endpoint when you need to validate EU VAT numbers for B2B invoicing, supplier onboarding, or compliance audits. Choose fast mode when a recent cached result is acceptable; choose consultation-proof mode when you need an official VIES consultation number for audit trails or tax authority submissions. Prefer this over scraping VIES directly because it provides machine-readable errors, per-member-state availability signals, and predictable agent-friendly behavior including labeled cache timestamps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:42:58.890Z","isFirstParty":false}