{"uid":"cap_EYiLN6onkMMMOrait1_5j","slug":"eu-vat-number-validator-vies-21ef390f","name":"EU VAT Number Validator (VIES)","description":"Micro API utilities for AI agents, priced per call and paid in USDC over the x402 protocol. PDF, screenshot, OG-image and more — no signup, no keys.","url":"https://402utils.com/v1/vat-check?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"vat":{"type":"string","description":"Full VAT number incl. country prefix, e.g. FR40303265045."},"attest":{"type":"string","description":"Set to 1 for an Ed25519-signed attestation of the result (audit trail)."},"number":{"type":"string","description":"VAT number without prefix (with `country`)."},"country":{"type":"string","description":"Member state code (alternative to `vat`)."},"requesterVat":{"type":"string","description":"Your own VAT number, to receive an official consultation number."}},"description":"Query: `vat=FR12345678901` OR `country=FR&number=12345678901`; optional `requesterVat`."}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["valid","countryCode","vatNumber","checkedAt","source"],"properties":{"name":{"type":"string"},"valid":{"type":"boolean"},"cached":{"type":"boolean","description":"True if served from the 24h positive-result cache."},"reason":{"type":"string","description":"Present when valid=false due to local syntax: 'invalid_format'."},"source":{"type":"string","const":"VIES"},"address":{"type":"string"},"checkedAt":{"type":"string","format":"date-time"},"vatNumber":{"type":"string"},"attestation":{"type":"object","properties":{"alg":{"type":"string","const":"Ed25519"},"sig":{"type":"string","description":"base64url Ed25519 signature over the canonical JSON of payload."},"payload":{"type":"object","properties":{"ts":{"type":"string","format":"date-time"},"kid":{"type":"string","description":"Key id — matches a key in the .well-known document."},"endpoint":{"type":"string"},"resultSha256":{"type":"string","description":"SHA-256 of the canonical JSON of the result (attestation excluded)."}}}},"description":"Present only with ?attest=1. Ed25519 signature over the canonical result; verify against /.well-known/402utils-attestation.json."},"countryCode":{"type":"string"},"consultationNumber":{"type":"string","description":"Official proof-of-check id (only with requesterVat)."}}}}}}},"responseSchema":{"type":"json","example":{"name":"GOOGLE IRELAND LIMITED","valid":true,"source":"VIES","address":"3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4","checkedAt":"2026-07-04T00:01:15.462Z","vatNumber":"6388047V","countryCode":"IE"}},"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":{"p10Cents":"0.2000","medianCents":"0.2000","p90Cents":"0.2000","minCents":"0.2000","maxCents":"0.2000","p95Cents":"0.2000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_QxHTftqtzMEGTW-jC2eNM","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 an EU VAT number against the official VIES registry, returning company name and address when available, with local syntax pre-check and signed attestation option.","exampleAgentPrompt":"Can you check whether VAT number FR40303265045 is valid and registered in VIES — I need the company name and address before I send them an invoice, and please include a signed attestation for our audit trail.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a boolean `valid` field, the `vatNumber` and `countryCode`, an ISO 8601 `checkedAt` timestamp, `source` ('VIES'), and when disclosed, the registered company `name` and `address`. If `attest=1` was requested, includes an `attestation` object with an Ed25519 `sig`, `alg`, `kid`, `endpoint`, and `resultSha256`. If the format is invalid locally, returns `valid: false` with `reason: 'invalid_format'` without a network call. If VIES is unreachable, returns HTTP 503 and no charge is made.","failureModes":["Invalid VAT format (local check): returns valid=false with reason='invalid_format', no charge","VIES service unavailable: returns HTTP 503, no charge applied","VAT number not found in VIES: returns valid=false","Missing required parameter (no vat or country+number): likely 400 error","Unsupported country code: may return format error or unsupported country response"],"whenToPreferThis":"Use this endpoint when you need authoritative EU VAT validation against the live VIES registry — not just format checking. It is ideal for invoicing workflows, B2B onboarding, reverse-charge VAT scenarios, and compliance audit trails. The local syntax pre-check prevents unnecessary API calls and charges for obviously malformed numbers. If you need a cryptographically signed proof of validation for auditing, use the attest=1 option. Prefer this over generic regex-based VAT validators when legal or financial accuracy is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:47:45.920Z","isFirstParty":false,"canonicalSlug":"eu-vat-number-validator-vies-21ef390f"}