{"uid":"cap__NqkiJVmX2b2PFPmm49jw","slug":"2s-vat-number-validation-7c883e48","name":"2s VAT Number Validation","description":"Validate a European Union VAT number against the official VIES (VAT Information Exchange System) register in real time. Confirms whether the VAT identifier is currently registered for intra-EU trade and, when the member state discloses them, returns the registered business name and address. Covers the 27 EU member states (Greece as EL) plus Northern Ireland (XI); Great Britain (GB) is not in VIES. Pass either a full identifier (vat=DE811569869) or country + number. Returns {valid, countryCode, vatNumber, name, address, requestDate, reason}. When a member-state register is temporarily down, returns a retryable 503 rather than a false negative. Data from the European Commission VIES service.","url":"https://2s.io/api/tax/vat","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","properties":{"vat":{"type":"string","maxLength":20,"minLength":3,"description":"Full VAT identifier: 2-letter country prefix + number, e.g. \"DE811569869\" or \"NL810433941B01\" (spaces/dots/hyphens allowed)."},"number":{"type":"string","maxLength":18,"minLength":2,"description":"The VAT number without the country prefix, e.g. \"811569869\". Use with country."},"country":{"type":"string","maxLength":2,"minLength":2,"description":"2-letter VAT country prefix, e.g. \"DE\". Greece is EL (GR also accepted); Northern Ireland is XI. Use with number."}},"description":"Provide either vat (a full identifier) or both country and number.","additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"vat":"DE811569869"}}},"response":{"data":{"ok":true,"meta":{"country":"DE"},"items":[{"name":null,"input":"DE811569869","valid":true,"reason":null,"source":{"url":"https://ec.europa.eu/taxation_customs/vies/","license":"© European Union — VIES VAT number validation service (free public service)","provider":"European Commission — VIES"},"address":null,"vatNumber":"811569869","countryCode":"DE","requestDate":"2026-06-21T05:05:03.214Z"}],"total":1,"source":{"url":"https://ec.europa.eu/taxation_customs/vies/","license":"© European Union — VIES VAT number validation service (free public service)","provider":"European Commission — VIES"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"tax.vat","settlement":{"txHash":"0x33026a6e5e89d49695765bbbbe80db8bf0cdc06460135494a5554fb5fb38dae6","network":"eip155:8453","success":true}}}},"exampleRequest":{"vat":"DE811569869"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fH3YsR9Queiq9lmWHj7Md","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a European VAT number via VIES and returns the registered legal name, address, and validity status","exampleAgentPrompt":"Can you check if the VAT number DE811569869 is valid and tell me the registered company name and address?","exampleUseCases":null,"resultDescription":"Returns a JSON object with ok=true, an items array containing the validity flag (true/false), the registered legal name, registered address (single line), the country code, the VAT number, a VIES request timestamp, and a reason string if the number is invalid, plus a source object with provider, URL, and license info.","failureModes":["VAT number not found in VIES — valid=false with reason explaining no match","VIES service temporarily unavailable — upstream timeout or error propagated","Malformed VAT input (too short, invalid country prefix) — schema validation error returned","Country member state does not disclose name or address — name and address fields returned as null","Transient VIES outage causing intermittent failures"],"whenToPreferThis":"Use this endpoint when you need real-time EU VAT validation against the official VIES database, especially for invoicing compliance, supplier onboarding, or B2B verification workflows. It requires no signup or API key and charges only $0.001 per call, making it ideal for lightweight agent pipelines. Prefer this over scraping VIES directly or using third-party VAT services with subscription fees.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:54:21.431Z","isFirstParty":false}