{"uid":"cap_vrv7AUWahF_hjjeckfUd3","slug":"invoket-vat-treatment-batch-9894bb91","name":"Invoket VAT Treatment Batch","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/batch","method":"POST","headers":{},"bodySchema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","description":"Array of transactions judged in one settlement. Its length is priced per unit (base + N x unit), capped at 200 (an empty or oversized batch is a 400 invalid_batch_size, never charged). Each item is EXACTLY the body of /invoice/vat-treatment: supplier_country and customer_country (ISO 3166-1 alpha-2), transaction_type (goods | services), customer_type (business | consumer), supply_kind (general, intra_eu_dispatch, export_outside_eu, import, services_b2b_general, services_b2c_general, services_land_related, services_electronic_b2c), date, and the optional customer_vat_status (valid | invalid | unknown, DECLARED - verify it with /company/vat) plus amount and currency. A malformed item is reported at its position; the batch is not rejected for it"}}},"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_0UgxDZoMfooQhCeYjJ--D","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 correct EU VAT treatment for a batch of up to 200 invoiced transactions in a single call, with provenance from official sources.","exampleAgentPrompt":"I have 15 invoices from our end-of-month settlement — suppliers in Germany, France, and Spain, customers split between businesses and consumers across the EU — can you run a batch VAT treatment check on all of them so I know the correct VAT rule (reverse charge, standard rate, zero rate, etc.) for each one before we issue them?","exampleUseCases":[{"title":"Monthly invoice batch VAT classification","prompt":"We're closing the books for October — I have 80 transactions mixing intra-EU goods dispatches and B2B services between different EU countries. Can you run them all through a batch VAT treatment check and tell me the correct VAT rule for each one?"},{"title":"Cross-border e-commerce VAT compliance","prompt":"Before we issue invoices for last week's orders, can you check the VAT treatment for 40 sales — some are goods exported outside the EU, others are electronic services to EU consumers — so we know which are zero-rated, which attract local VAT, and which need the reverse charge?"},{"title":"Accountant pre-settlement VAT audit","prompt":"I'm preparing a settlement run with 120 mixed B2B and B2C service transactions across EU member states — some customers have valid VAT numbers, some are unknown. Can you batch-classify the VAT treatment for all of them at once so I can catch any misclassifications before we pay?"}],"resultDescription":"An array of per-item VAT treatment determinations, each including the applicable VAT rule (e.g. standard rate, reverse charge, zero-rate, exempt), the governing supply kind, the legal basis with provenance, and any per-item validation errors at their position in the batch. Malformed items are flagged individually without rejecting the entire batch.","failureModes":["400 invalid_batch_size — batch is empty or exceeds 200 items; not charged","Per-item error at position N for malformed fields (missing required country codes, invalid enum values, unrecognised currency); rest of batch still processed","Invalid customer_vat_status declared without prior verification via /company/vat — result flagged as DECLARED, not verified","Unsupported supply_kind / transaction_type combination returns a classification error at item level","Payment failure via x402 prevents the call from being processed"],"whenToPreferThis":"Use this endpoint when you need to classify VAT treatment for multiple transactions in a single API call rather than one at a time — ideal for end-of-month settlement runs, batch invoice issuance, or any workflow processing more than a handful of cross-border EU transactions. Prefer it over the single /invoice/vat-treatment endpoint when you have 2–200 items to process; it is priced per item so it is cost-equivalent but far more efficient. Choose this over generic VAT-rate lookup services when you need provenance-backed, supply-kind-aware treatment decisions (not just a rate percentage) that account for customer type, VAT registration status, and transaction type.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:47:49.249Z","isFirstParty":false}