check_vat_list

com.jithox/jithox · Verify this server

Check a whole LIST of EU VAT numbers against the EU VIES register in one call — up to 20 rows of { reference?, vatId }, answered row for row in the same order. Two tiers. FREE, always: each number is normalised and checked locally — empty, malformed for its member state, a duplicate of an earlier row, or not covered (GB, CH, NO and every non-EU prefix are `not_covered`, never `invalid`). METERED: each well-formed, unique row is looked up live in VIES and comes back `valid` (with the registered name when the member state shares it), `invalid`, or `unknown`. PRICE: 1 credits (EUR 0.01) PER ROW THE REGISTER ANSWERED (valid or invalid), charged once after the call. The most a call can cost is that price times its rows (20 credits for a full call), and the balance must cover that before it runs. UNKNOWN COSTS NOTHING: a member state that is down, a rate limit or a row the 40-second time budget did not reach is `unknown` with the reason — never `invalid`. To retry, send ONLY the rows listed in `retry.indexes`; rows that already have an answer do not need to be sent again. The same payload re-sent within ten minutes is charged once. Coverage: the 27 EU member states (Greece as EL or GR); Northern Ireland (XI) numbers are checked for shape only. Optional requesterVatId, your own EU VAT number with its country prefix: each answered row then carries the European Commission's consultation number, registered to you, and a requester VIES refuses costs nothing (those rows come back `unknown`, never `invalid`). Read-only; nothing is stored. A valid number today says nothing about tomorrow, and this is not a tax opinion.