{"uid":"cap_g4iE2pIG57h4wpz-73thn","slug":"handel-halowerk-com-vat-resolve-f9a77d68","name":"handel.halowerk.com VAT Resolve","description":"Two answers in one call. Validation: the number is checked against the VIES service of the member state that issued it, with the consultation date returned. Treatment: given the supplier country, the customer country and whether the customer is a business, it states whether the supply is domestic with the local rate, an intra-community B2B supply where the reverse charge shifts the liability to the customer, a B2C supply taxed where the customer sits, or an export outside the EU.","url":"https://handel.halowerk.com/v1/vat-resolve","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"vat_number":{"type":"string","maxLength":20,"minLength":4,"description":"VAT number with country prefix, e.g. DE811907980."},"supply_type":{"enum":["goods","services","digital_services"],"type":"string","default":"goods","description":"What is being supplied."},"supplier_country":{"type":"string","maxLength":2,"minLength":2,"description":"ISO country code of the supplier, for the treatment question."},"customer_is_business":{"type":"boolean","default":true,"description":"Whether the customer is a business (B2B) or a consumer (B2C)."}}},"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_XFF_mRbv6-N1_dehqhH-3","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 a VAT number against VIES and determines the correct VAT treatment (domestic, intra-community reverse charge, B2C distance, or export) for a given supplier-customer transaction in a single call.","exampleAgentPrompt":"Check if VAT number DE123456789 is valid and tell me the correct VAT treatment for a sale from a German supplier to a French business customer — I need to know whether to apply reverse charge or charge local VAT.","exampleUseCases":[{"title":"Pre-invoice VAT check for EU B2B sale","prompt":"Before I issue this invoice, validate VAT number NL856787894B01 and tell me the correct tax treatment for a Dutch supplier selling to an Italian business customer — do I apply reverse charge or charge Dutch VAT?"},{"title":"B2C cross-border VAT treatment for e-commerce","prompt":"I'm a Spanish e-commerce seller shipping to a French consumer — they are not a business. Can you validate their situation and tell me whether I charge Spanish VAT, French VAT, or something else?"},{"title":"Export outside EU — confirm zero-rating","prompt":"We're a Polish company selling to a UK business post-Brexit. Check VAT number GB123456789 and confirm whether this is an EU export that should be zero-rated and what the correct VAT treatment is."}],"resultDescription":"Returns two sets of results: (1) VAT validation — whether the number is currently registered in VIES, the member state that issued it, and the consultation timestamp; (2) VAT treatment — one of domestic (local rate applies), intra-community B2B (reverse charge, liability shifts to customer), B2C distance supply (taxed at customer location), or export outside the EU (zero-rated). The treatment is determined from the supplier country, customer country, and business status.","failureModes":["VIES service temporarily unavailable — member state's registry may be offline at the time of consultation","Invalid VAT number format — returns validation error before querying VIES","Unknown or unsupported country code — treatment logic cannot be applied","VAT number not found in VIES — returns invalid status with consultation date","Network timeout if VIES member state is slow to respond"],"whenToPreferThis":"Use this endpoint when you need both VAT number validation and VAT treatment determination in a single API call for EU cross-border transactions. It is the right choice for automating invoice generation, quoting workflows, or compliance checks where you need to know both whether a customer's VAT number is legitimate and which tax regime applies. Prefer it over separate VIES lookups combined with manual treatment logic, especially when handling B2B, B2C, and export scenarios programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:29.610Z","isFirstParty":false}