POST AI agent ready /v1/validate/iban

IBAN Validator API - Check & Parse Bank Account Numbers

Submit an IBAN string and get back whether it passes structural and checksum validation, along with the country code, bank identifier code, and check digits. Supports IBANs from over 80 countries. The IBAN is processed server-side and never stored.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/validate/iban \
  -H "Content-Type: application/json" \
  -d '{"iban":"DE89370400440532013000"}'

When to use this API

Validate bank details before initiating SEPA transfers

Check the IBAN at the point of entry in your payment form. Catching invalid IBANs before submitting to your bank avoids failed transfers, return fees, and delayed payouts to vendors or employees.

Auto-detect the country for international invoicing

Extract the country code from a validated IBAN to automatically set the correct currency, tax rules, and bank transfer routing for cross-border invoices.

Clean up bulk supplier payment files

Validate every IBAN in a batch payment CSV before uploading it to your banking portal. Flag invalid entries so your finance team can correct them before the batch runs.

Frequently asked questions

How many countries does the IBAN validation support?

Over 80 countries that have adopted the IBAN standard, including all EU/EEA member states, the UK, Switzerland, Saudi Arabia, and Brazil. The full list follows the SWIFT IBAN registry.

Does this API verify that the bank account exists?

No. It validates the IBAN structure and checksum to confirm the number is correctly formatted. It does not contact any bank or confirm that the account is open or funded.

Is the IBAN I send stored anywhere?

No. The IBAN is validated in memory and discarded immediately. Nothing is logged or persisted.

Can I send an IBAN with spaces?

Yes. Spaces are stripped before validation. "DE89 3704 0044 0532 0130 00" and "DE89370400440532013000" both work.

What does a failed validation return?

The response includes valid: false along with a reason field explaining the failure, such as "Invalid check digits" or "Unknown country code".

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.