x402AgentTools

๐ŸฆIBAN Validator

Validate an International Bank Account Number: country code, country-specific length and the ISO 7064 MOD 97-10 check digits โ€” with the pretty-printed grouping returned when valid.

Worked examples

Valid German IBAN

GET /api/v1/finance/iban-validator?iban=DE89%203704%200044%200532%200130%2000

Result: โœ“ Valid IBAN โ€” Germany

Valid UK IBAN

GET /api/v1/finance/iban-validator?iban=GB29%20NWBK%206016%201331%209268%2019

Result: โœ“ Valid IBAN โ€” United Kingdom

Bad checksum

GET /api/v1/finance/iban-validator?iban=DE89%203704%200044%200532%200130%2001

Result: โœ— Invalid IBAN

Machine API (x402)

$0.001 / call

This tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol โ€” no accounts, no API keys.

GET /api/v1/finance/iban-validator?iban=DE89%203704%200044%200532%200130%2000 HTTP/1.1
Host: agenttools-hub.vercel.app

โ†’ 402 (payment required, instructions in headers)
โ†’ 200 (after X-PAYMENT header; JSON body below)

{
  "tool": "finance/iban-validator",
  "input": {"iban":"DE89 3704 0044 0532 0130 00"},
  "result": { "value": 1, "answer": "โœ“ Valid IBAN โ€” Germany" }
}

Agent docs: /llms.txt ยท OpenAPI spec ยท integration guide

About this tool

Validation runs three checks: structural format, the country's official length (48 countries built in), and the ISO 7064 MOD 97-10 checksum that catches typos in account numbers. A valid result means well-formed โ€” it does not prove the account exists.

rearrange (BBAN + country + check digits) โ†’ letters A=10โ€ฆZ=35 โ†’ value mod 97 must equal 1

Frequently asked questions

Does a valid IBAN mean the account exists?

No. The checksum only detects typos. Whether the account is open and reachable requires a bank-side lookup or confirmation-of-payee service.

Why is my US account rejected?

The US has no IBAN system โ€” US banks use ABA routing + account numbers. Only ~90 countries participate in the IBAN registry.

Related tools