Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Compliance & Business Live on Hub

EU VAT VIES & IBAN/BIC Validation API — Verify Tax IDs & Bank Accounts

Validate IBANs, BIC/SWIFT codes, and EU/UK VAT numbers with live EU VIES lookup. Validate IBAN checksums (MOD 97-10) across 80+ countries, BIC/SWIFT codes, and EU + UK VAT numbers with optional live EU VIES verification.

Additional endpoints in this module: POST /v1/eu-vat-iban/vat

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/eu-vat-iban/ibaninput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "valid": true,
    "iban": "DE89370400440532013000",
    "formatted": "DE89 3704 0044 0532 0130 00",
    "country_code": "DE",
    "check_digits": "89",
    "bban": "370400440532013000",
    "length_valid": true,
    "checksum_valid": true,
    "bic_valid": true,
    "bic_country_match": true,
    "errors": []
  },
  "meta": {
    "request_id": "req_vat_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/eu-vat-iban/iban" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"iban":"DE89 3704 0044 0532 0130 00","bic":"COBADEFFXXX"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/eu-vat-iban/iban", {
  "iban": "DE89 3704 0044 0532 0130 00",
  "bic": "COBADEFFXXX"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/eu-vat-iban/iban",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "iban": "DE89 3704 0044 0532 0130 00",
  "bic": "COBADEFFXXX"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/eu-vat-iban/iban", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "iban": "DE89 3704 0044 0532 0130 00",
  "bic": "COBADEFFXXX"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_eu_vat_iban",
    "arguments": {
      "iban": "DE89 3704 0044 0532 0130 00",
      "bic": "COBADEFFXXX"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/eu-vat-iban/iban)

ParameterType & ConstraintsDescription
iban required string
minLen: 5, maxLen: 64
IBAN to validate (spaces allowed).
bic optional string
minLen: 4, maxLen: 16
Optional BIC/SWIFT code (8 or 11 characters) to validate and cross-check country.

Response data Object Fields (200 OK)

FieldTypeDescription
valid boolean Field 'valid'
iban string Field 'iban'
formatted string Field 'formatted'
country_code string Field 'country_code'
check_digits string Field 'check_digits'
bban string Field 'bban'
length_valid boolean Field 'length_valid'
checksum_valid boolean Field 'checksum_valid'
bic_valid boolean | null Field 'bic_valid'
bic_country_match boolean | null Field 'bic_country_match'
errors string[] Field 'errors'

What EU VAT & IBAN/BIC Validator API Detects & Validates

  • ISO 13616 IBAN length, country structure, and MOD 97-10 checksum across 80+ countries + SEPA membership flag
  • ISO 9362 BIC/SWIFT format and cross-check that the BIC country code matches the IBAN country
  • Offline syntax + check-digit validation for all 27 EU member states, Northern Ireland (XI), and UK (GB) VAT numbers
  • Optional live EU Commission VIES SOAP lookup (verify_vies: true) with 24-hour KV cache for company name & address
Honest Engineering Boundaries

Known Limitations & Test Verification

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 →

  • National VIES member-state databases occasionally experience maintenance downtime; when VIES is unreachable, the API still returns deterministic syntax & check-digit validation with vies_status: 'unavailable'.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

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).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Does it check whether the BIC country matches the IBAN country?

Yes, when both iban and bic are provided, it verifies ISO 3166 country alignment.

What happens if an EU country's national VIES database is temporarily offline?

You still get instant offline format and check-digit validation plus a clear vies_status field instead of a 500 error.

Does it support Hungarian, German, French, and UK VAT formats?

Yes, all 27 EU member states plus XI and GB are supported.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

IBAN numbers are validated purely in memory and never cached. Public EU VIES VAT company responses are cached for up to 24 hours in KV.

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.

Related Tinplate APIs

POST /v1/invoice-validator Tier 1

Invoice & EU EN 16931 / Peppol Validator API

Audit extracted invoices for line-item math errors, VAT mismatches, and Peppol compliance.

POST /v1/hu-business-validator Compliance & Business

Hungarian Business Document & NAV Validator API

Validate Hungarian adószám, cégjegyzékszám, GIRO bank accounts, and NAV invoice rules.

POST /v1/workday-holiday/between Compliance & Business

Workday & Holiday Calculator API

Calculate business days and SLA deadlines across 30+ countries including HU swap Saturdays.