{"uid":"cap_6VEeH3sGVmUrMgEbRa6T_","slug":"supplier-identity-and-vat-verification-8a40c6db","name":"Supplier Identity and VAT Verification","description":"Use before paying a supplier invoice to check that the supplier is who it claims to be. Reconciles the claimed legal name, company registration number and VAT number against the Irish Companies Registration Office (IE) and the EU VIES VAT service, and returns an advisory RELEASE, REVIEW, BLOCK or INSUFFICIENT_EVIDENCE decision with per-check results and reason codes. Advisory only: it never executes or authorises a payment.","url":"https://supplier-payment-verifier-production.up.railway.app/v1/verifications?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"supplier":{"type":"object","required":["claimed_legal_name","country_code"],"properties":{"vat_number":{"type":"string","description":"VAT number including country prefix."},"country_code":{"type":"string","description":"ISO 3166-1 alpha-2 code, e.g. IE."},"claimed_legal_name":{"type":"string","description":"Legal name on the invoice."},"company_registration_number":{"type":"string","description":"Registry company number, e.g. the CRO number for IE."}},"description":"The supplier claim to verify."},"policy_id":{"const":"eu-b2b-payment-v1","description":"Always eu-b2b-payment-v1."},"request_id":{"type":"string","format":"uuid","description":"Caller-generated unique id."},"schema_version":{"const":"1.0","description":"Always 1.0."}}},"responseSchema":{"type":"json","example":{"checks":[{"code":"ENTITY_MATCH","outcome":"PASS","summary":"Company registry record matched."},{"code":"VAT_VALID","outcome":"PASS","summary":"VAT registration is valid."}],"policy":{"id":"eu-b2b-payment-v1","version":"1.0.0"},"status":"COMPLETED","billing":{"meter":"verification.completed","units":1,"billable":true},"decision":"RELEASE","created_at":"2026-10-13T12:48:01Z","request_id":"76de334e-f97f-4fef-accc-75b1ed0a634e","completed_at":"2026-10-13T12:48:02Z","reason_codes":["ALL_REQUIRED_CHECKS_PASSED"],"advisory_only":true,"schema_version":"1.0","verification_id":"a75d7f47-5af4-4e61-a697-0df83f548878"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ok4YtYZFHg0Osqd0d9UG4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies a supplier's legal name, company registration number, and VAT number against the Irish CRO and EU VIES, returning an advisory RELEASE, REVIEW, BLOCK, or INSUFFICIENT_EVIDENCE decision before paying an invoice.","exampleAgentPrompt":"Before we pay this invoice from Acme Supplies Ltd, can you verify them — their claimed legal name is 'Acme Supplies Ltd', their Irish CRO number is 123456, their VAT number is IE1234567T, and their country code is IE?","exampleUseCases":[{"title":"Pre-payment supplier fraud check","prompt":"We just received an invoice from a new supplier called 'Brennan Logistics Ltd' with CRO number 654321 and VAT number IE9876543B — can you verify their identity against the Irish CRO and EU VIES and tell me if it's safe to release the payment?"},{"title":"Accounts payable onboarding screen","prompt":"We're onboarding a new EU vendor, 'Dublin Tech Solutions Ltd', CRO 789012, VAT IE1122334C — run them through the supplier verification check and flag if we should review or block them before adding them to our approved supplier list."},{"title":"Invoice discrepancy investigation","prompt":"The name on this invoice says 'Green Fields Ireland Ltd' but I'm not sure it matches the CRO registration — their number is 246810 and VAT is IE4455667D, country IE. Can you reconcile the legal name and give me a RELEASE or BLOCK recommendation?"}],"resultDescription":"Returns an advisory decision (RELEASE, REVIEW, BLOCK, or INSUFFICIENT_EVIDENCE) along with individual check results for legal name, company registration, and VAT number, plus structured reason codes explaining each sub-decision. Does not execute or authorise any payment.","failureModes":["Invalid or missing country_code returns a validation error","VAT number format mismatch (e.g. missing country prefix) causes VIES lookup failure","CRO number not found in the Irish registry returns INSUFFICIENT_EVIDENCE","VIES service temporarily unavailable may degrade VAT check result","Mismatched legal name results in a REVIEW or BLOCK decision","Missing required fields (claimed_legal_name or country_code) returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when processing B2B supplier invoices from Irish or EU-registered companies and you need a structured, policy-backed advisory decision (RELEASE/REVIEW/BLOCK) rather than a raw data lookup. It is specifically suited to accounts-payable automation workflows where you want a single call that cross-checks legal name, CRO registration, and EU VAT status in one step, with reason codes for audit trails. Prefer this over manual CRO/VIES queries when you need a decision recommendation, not just raw registry data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:30:24.750Z","isFirstParty":false,"canonicalSlug":"supplier-identity-and-vat-verification-8a40c6db"}