{"uid":"cap_hsAYB2DMcIwWEMXzz8Lwl","slug":"invoket-vat-treatment-checker-b5010627","name":"Invoket VAT Treatment Checker","description":"The checks your agent runs before it acts: verify a bank account, a phone number, a law in force, the weather or a vehicle — computed from official sources, with provenance in every response. You only pay for answers.","url":"https://api.invoket.com/invoice/vat-treatment","method":"POST","headers":{},"bodySchema":{"type":"object","required":["date","amount","currency","supply_kind","customer_type","customer_country","supplier_country","transaction_type","customer_vat_status"],"properties":{"date":{"type":"string","description":"Date VAT becomes chargeable (YYYY-MM-DD, and a real calendar date): the rate served is the one in force AT THAT DATE, each rate carrying its own validity in the committed TEDB snapshot. Earlier than the snapshot is a 400, never extrapolated"},"amount":{"type":"string","description":"Optional taxable base (simple decimal string): supplying it triggers computed, and then currency (ISO 4217; XXX and XTS refused) is required. An overflowing amount is a 400, never a 5xx"},"currency":{"type":"string"},"supply_kind":{"type":"string","description":"Closed enumeration, required: general (domestic), intra_eu_dispatch, export_outside_eu, import, services_b2b_general, services_b2c_general, services_land_related (then add property_country), services_electronic_b2c. A value outside the list is a 400 naming the admitted values - never a fallback to general"},"customer_type":{"type":"string"},"customer_country":{"type":"string"},"supplier_country":{"type":"string","description":"Where the supplier is established, ISO 3166-1 alpha-2 (EL accepted for GR), required - as is customer_country (where the customer is established, or where the goods arrive). Both are checked together, so two bad codes are two issues in one 400. Territories outside the VAT territory of the Union that ISO can express (IC, EA, AX, French overseas departments) are third territories; Monaco is FR"},"transaction_type":{"type":"string","description":"goods | services, required - as is customer_type (business | consumer). Both must be CONSISTENT with supply_kind: a services_b2b_general declared with a consumer customer is a motivated refusal (paid 200, undetermined), never a guess"},"customer_vat_status":{"type":"string","description":"valid | invalid | unknown (default). DECLARED, never verified here: zero network by design. invalid and unknown are treated identically - the Directive does not distinguish them - and both make the intra-Community exemption (Art. 138(1)(b)) and the Art. 196 reverse charge fall away, the supply being taxed at the supplier's rate. Live check: GET /company/vat"}}},"responseSchema":{"type":"object"},"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_g06--VwuCdukAQCOeglFt","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":"Determines the applicable EU VAT treatment, rate, and optionally computed tax amount for a transaction on a specific date, based on official TEDB data.","exampleAgentPrompt":"What's the VAT treatment for a B2B intra-EU dispatch of goods from Germany to France on 2024-11-01 for a business customer with valid VAT status — the taxable base is EUR 1200?","exampleUseCases":[{"title":"Pre-invoice VAT check for B2B sale","prompt":"Before I issue this invoice, check the correct VAT treatment for a services_b2b_general transaction: a Spanish supplier selling to a German business customer on 2024-09-15, with a taxable amount of EUR 800. The customer has a valid VAT number."},{"title":"E-commerce digital services VAT for EU consumer","prompt":"I'm selling an e-book to a French consumer from my Irish company — it's a services_electronic_b2c supply. What VAT rate should I apply on 2024-12-01, and can you compute the tax on EUR 29.99?"},{"title":"Historical rate audit for past transaction","prompt":"I need to verify what VAT rate was legally in force on 2022-03-10 for a goods export outside the EU from Italy — supplier is IT, customer is a business in the US, supply kind is export_outside_eu."}],"resultDescription":"Returns the VAT treatment applicable to the described transaction, including the rate in force on the requested date (sourced from the official TEDB snapshot), validity window for that rate, whether reverse charge or zero-rating applies, and — if an amount was supplied — the computed VAT and gross amounts. Every response includes provenance indicating the authoritative source.","failureModes":["Date before TEDB snapshot coverage → 400 error, not extrapolated","Invalid or unrecognized supply_kind value → 400 with list of admitted values","Inconsistent combination (e.g. services_b2b_general with customer_type=consumer) → paid 200 with undetermined status, not a guess","Invalid ISO 4217 currency code (XXX/XTS or unknown) → 400","Invalid or dual-bad country codes → 400 naming both issues","Amount exceeding overflow threshold → 400, never a 5xx","Unknown future date beyond snapshot → 400"],"whenToPreferThis":"Use this endpoint when an AI agent needs to determine the legally correct EU VAT treatment before issuing an invoice, processing a payment, or filing a tax record. It is specifically suited for cross-border EU transactions where the supply kind, customer type, and VAT status interact under TEDB rules. Prefer this over generic tax APIs when you need official TEDB provenance, date-specific historical rates, or computed VAT amounts tied to a specific transaction context — not just a country's standard rate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:50:44.685Z","isFirstParty":false}