UNunirateapi
IBAN

Validate an IBAN

Validate an International Bank Account Number and split it according to the country's registered IBAN structure (bank code, branch code, account number). Available on the Free plan; each call counts against your normal daily request quota.

Spaces, hyphens and lowercase letters are accepted and normalised, so both the electronic form (DE89370400440532013000) and the print form (DE89 3704 0044 0532 0130 00) work.

An invalid IBAN is not an HTTP error: the response is 200 with valid: false and a machine-readable failure_code:

  • invalid_characters – anything other than A-Z / 0-9 after normalisation
  • invalid_format – does not start with a 2-letter country code + 2 check digits
  • unknown_country – the country does not use IBAN (e.g. US)
  • invalid_length – wrong length for that country (see expected_length)
  • invalid_structure – the BBAN does not match the country's format
  • invalid_checksum – the ISO 7064 mod 97-10 check digits do not match

Validation is structural and mathematical only. It confirms the IBAN is well-formed; it cannot confirm the account exists or is open. Bank names and BICs are not returned.

get/api/iban/validate

Request

Query parameters

api_keystring required

API key for authentication

ibanstring required

The IBAN to validate (max 64 characters; spaces and hyphens are ignored)

format'json' | 'xml' | 'csv' | 'tsv'

The format of the response (optional).

callbackstring

The name of the JSONP callback function (optional). Only used when format is 'json'. Must be alphanumeric with underscores.

Response

Validation result. Check the valid field — invalid IBANs also return 200.

ibanstring

Input after removing spaces/hyphens and upper-casing

validboolean
electronic_formatstring

Canonical form without spaces (null when invalid)

print_formatstring

Groups of four characters separated by spaces (null when invalid)

country_codestring
country_namestring
check_digitsstring
bbanstring

Basic Bank Account Number (the country-specific part)

bank_codestring
branch_codestring

Null for countries whose IBAN has no branch component

account_numberstring
national_check_digitsstring

Country-specific check digits inside the BBAN, where the structure defines them

sepaboolean

Whether the country is in the Single Euro Payments Area

expected_lengthinteger

Registered IBAN length for the country

lengthinteger
failure_codestring
failure_messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.