{"uid":"cap_HnOYdQUUQTcesl8uRfH0a","slug":"irish-vat-number-validation-via-eu-vies-ea871287","name":"Irish VAT Number Validation via EU VIES","description":"Validates the Irish VAT number format and check letter, then confirms registration live with EU VIES. Returns PASSED, FAILED or UNAVAILABLE (VIES outage) with a reason code.","url":"https://supplier-payment-verifier-production.up.railway.app/v1/checks/vat?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"vat_number":{"type":"string","title":"Vat Number","maxLength":20,"minLength":2,"description":"Irish VAT number, with or without IE prefix; spaces and lowercase are normalized. Not a CRO number or company name."}}},"responseSchema":{"type":"json","example":{"check":"VIES_VAT","outcome":"PASSED","checked_at":"2026-10-15T12:00:00Z","reason_code":"VAT_VALID","agent_audit_receipt":{"key_id":"<id>","vies_timestamp":"2026-10-15T12:00:00Z","agent_signature":"<base64 Ed25519>","raw_response_hash":"<sha256 hex>"},"consultation_number":null}},"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_Xd39DdDN3MwClriNhsqMb","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 Irish VAT number's format and check letter, then verifies it live against the EU VIES registry, returning PASSED, FAILED, or UNAVAILABLE with a reason code and audit receipt.","exampleAgentPrompt":"Before I pay this Irish supplier invoice, can you check whether VAT number IE3628739UA is genuinely registered — run it against VIES and tell me if it passes or fails?","exampleUseCases":[{"title":"Pre-payment supplier VAT check","prompt":"I've got an invoice from an Irish company claiming VAT number IE6388047V — can you verify that number is actually registered on VIES before I approve the payment?"},{"title":"Onboarding new Irish vendor","prompt":"We're adding a new Irish supplier to our vendor list; their declared VAT number is IE8256625E — please check the format and confirm it's live on the EU VIES registry."},{"title":"Finance audit compliance review","prompt":"Our auditors need us to re-validate VAT numbers for all Irish suppliers — start with IE9S99999L and tell me whether it passed or failed VIES verification, including the reason code."}],"resultDescription":"A JSON object containing: the check type (VIES_VAT), outcome (PASSED, FAILED, or UNAVAILABLE if VIES is down), the UTC timestamp of the check, a machine-readable reason_code (e.g. VAT_VALID), and an agent_audit_receipt with a key ID, VIES timestamp, Ed25519 agent signature over the response, and a SHA-256 hash of the raw VIES response for tamper-evident auditing. A consultation_number is included when available from VIES.","failureModes":["FAILED outcome with reason_code indicating invalid format or failed check-letter calculation if the VAT number is malformed","UNAVAILABLE outcome when VIES is experiencing an outage or is temporarily unreachable","Payment required (HTTP 402) if the x402 micropayment header is missing or invalid","Input validation error if vat_number is missing, too short, or exceeds 20 characters","Network timeout if the VIES service takes too long to respond"],"whenToPreferThis":"Choose this endpoint when you specifically need to validate an Irish VAT number (with or without the IE prefix) against the live EU VIES registry, and require a tamper-evident audit receipt with an Ed25519 signature. It is ideal for automated accounts-payable agents that must log cryptographic proof of VAT checks before approving supplier payments. Prefer it over generic VAT lookup tools when Irish-specific format validation (including check-letter verification) plus live VIES confirmation in a single call is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:38:40.700Z","isFirstParty":false,"canonicalSlug":"irish-vat-number-validation-via-eu-vies-ea871287"}