EU VAT & IBAN/BIC Validator API
Validate IBANs, BIC/SWIFT codes, and EU/UK VAT numbers with live EU VIES lookup.
Audit extracted invoices for line-item math errors, VAT mismatches, and Peppol compliance. Validate extracted invoice JSON for line-item arithmetic, VAT rate compliance, reverse-charge rules, IBAN/VAT syntax, and EU EN 16931 / Peppol conformance.
{
"ok": true,
"data": {
"valid": true,
"verdict": "valid",
"math_valid": true,
"en16931_conformant": true,
"computed_totals": {
"subtotal_net": 100,
"total_vat": 0,
"total_gross": 100,
"vat_breakdown": [
{
"vat_rate": 0,
"taxable_net": 100,
"vat_amount": 0,
"gross_amount": 100
}
]
},
"issues": []
},
"meta": {
"request_id": "req_inv_01",
"ms": 1
}
}
curl -X POST "https://api.tinplate.dev/v1/invoice-validator" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TINPLATE_KEY" \
-d '{"invoice":{"invoice_number":"INV-2026-0412","issue_date":"2026-11-14","currency":"EUR","seller":{"name":"Acme GmbH","vat_number":"DE123456789","country_code":"DE"},"buyer":{"name":"Client BV","vat_number":"NL123456782B01","country_code":"NL"},"line_items":[{"description":"Cloud API Pro","quantity":2,"unit_price":50,"net_amount":100,"vat_rate":0,"vat_amount":0,"gross_amount":100}],"subtotal_net":100,"total_vat":0,"total_gross":100,"reverse_charge":true},"check_en16931":true}'import { TinplateClient } from "@tinplate/sdk";
const tinplate = new TinplateClient({
apiKey: process.env.TINPLATE_API_KEY!,
});
const { data, meta } = await tinplate.call("/v1/invoice-validator", {
"invoice": {
"invoice_number": "INV-2026-0412",
"issue_date": "2026-11-14",
"currency": "EUR",
"seller": {
"name": "Acme GmbH",
"vat_number": "DE123456789",
"country_code": "DE"
},
"buyer": {
"name": "Client BV",
"vat_number": "NL123456782B01",
"country_code": "NL"
},
"line_items": [
{
"description": "Cloud API Pro",
"quantity": 2,
"unit_price": 50,
"net_amount": 100,
"vat_rate": 0,
"vat_amount": 0,
"gross_amount": 100
}
],
"subtotal_net": 100,
"total_vat": 0,
"total_gross": 100,
"reverse_charge": true
},
"check_en16931": true
});
console.log(`[${meta.ms} ms]`, data);import requests
response = requests.post(
"https://api.tinplate.dev/v1/invoice-validator",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_TINPLATE_KEY",
},
json={
"invoice": {
"invoice_number": "INV-2026-0412",
"issue_date": "2026-11-14",
"currency": "EUR",
"seller": {
"name": "Acme GmbH",
"vat_number": "DE123456789",
"country_code": "DE"
},
"buyer": {
"name": "Client BV",
"vat_number": "NL123456782B01",
"country_code": "NL"
},
"line_items": [
{
"description": "Cloud API Pro",
"quantity": 2,
"unit_price": 50,
"net_amount": 100,
"vat_rate": 0,
"vat_amount": 0,
"gross_amount": 100
}
],
"subtotal_net": 100,
"total_vat": 0,
"total_gross": 100,
"reverse_charge": true
},
"check_en16931": true
}
)
print(response.json())const response = await fetch("https://api.tinplate.dev/v1/invoice-validator", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_TINPLATE_KEY",
},
body: JSON.stringify({
"invoice": {
"invoice_number": "INV-2026-0412",
"issue_date": "2026-11-14",
"currency": "EUR",
"seller": {
"name": "Acme GmbH",
"vat_number": "DE123456789",
"country_code": "DE"
},
"buyer": {
"name": "Client BV",
"vat_number": "NL123456782B01",
"country_code": "NL"
},
"line_items": [
{
"description": "Cloud API Pro",
"quantity": 2,
"unit_price": 50,
"net_amount": 100,
"vat_rate": 0,
"vat_amount": 0,
"gross_amount": 100
}
],
"subtotal_net": 100,
"total_vat": 0,
"total_gross": 100,
"reverse_charge": true
},
"check_en16931": true
}),
});
const result = await response.json();
console.log(result);{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tinplate_invoice_validator",
"arguments": {
"invoice": {
"invoice_number": "INV-2026-0412",
"issue_date": "2026-11-14",
"currency": "EUR",
"seller": {
"name": "Acme GmbH",
"vat_number": "DE123456789",
"country_code": "DE"
},
"buyer": {
"name": "Client BV",
"vat_number": "NL123456782B01",
"country_code": "NL"
},
"line_items": [
{
"description": "Cloud API Pro",
"quantity": 2,
"unit_price": 50,
"net_amount": 100,
"vat_rate": 0,
"vat_amount": 0,
"gross_amount": 100
}
],
"subtotal_net": 100,
"total_vat": 0,
"total_gross": 100,
"reverse_charge": true
},
"check_en16931": true
}
}
}POST /v1/invoice-validator)| Parameter | Type & Constraints | Description |
|---|---|---|
invoice required |
object |
Field 'invoice' |
rounding_tolerance optional |
numbermin: 0, max: 1, default: 0.02 |
Allowed rounding difference per line or total in currency units (default 0.02). |
check_en16931 optional |
booleandefault: true |
Verify mandatory EN 16931 / Peppol BIS Billing 3.0 fields (BT-1..BT-115). |
data Object Fields (200 OK)| Field | Type | Description |
|---|---|---|
valid |
boolean |
Field 'valid' |
verdict |
"valid" | "warnings_only" | "invalid" |
Field 'verdict' |
math_valid |
boolean |
Field 'math_valid' |
en16931_conformant |
boolean |
Field 'en16931_conformant' |
computed_totals |
object |
Field 'computed_totals' |
issues |
object[] |
Field 'issues' |
Release: v1.0.39 ·
Verified: 16 November 2026 ·
Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) ·
See Full Portfolio Benchmarks →
Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev:
Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).
| Plan | Monthly Price | Included Requests | Rate Limit | Max Payload | Best For |
|---|---|---|---|---|---|
| BASIC | $0.00 / mo | 500 / month | 10 req / min | 64 KB | Evaluation & CI smoke tests |
| PRO | $9.99 / mo | 15,000 / month | 60 req / min | 128 KB | Solo devs & production apps |
| ULTRA | $29.99 / mo | 100,000 / month | 300 req / min | 256 KB | Growing SaaS & multi-agent pipelines |
| MEGA | $79.99 / mo | 500,000 / month | 1,000 req / min | 256 KB | High-volume enterprise workloads |
Vision LLMs and OCR models frequently misread a digit or hallucinate totals. Running deterministic math and EN 16931 checks catches extraction errors before ERP import.
Yes, you can configure rounding tolerance (default ±0.02) to distinguish rounding conventions from real arithmetic errors.
Yes, it validates supplier and customer VAT IDs and payment IBANs automatically.
Stateless in-memory invoice verification. Zero financial data is logged or retained.
Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.
Validate IBANs, BIC/SWIFT codes, and EU/UK VAT numbers with live EU VIES lookup.
Validate Hungarian adószám, cégjegyzékszám, GIRO bank accounts, and NAV invoice rules.
Normalize messy EU/US prices, dates, percentages, and measurements into structured JSON.