BANK API
IBAN validation
The iban endpoint validates International Bank Account Numbers with comprehensive country-specific validation, format checking, and detailed structural information for financial applications.
GET
Проверить IBAN
Getting started
Base URL
Validation endpoint
Theiban endpoint requires your API key and an IBAN parameter to perform comprehensive validation of International Bank Account Numbers.
Request parameters
Your unique API key. Note that each user has unique API keys for each of
Cleariflow APIs, so your Bank Validation API key will not work for your Exchange
Rates API, for example.
The International Bank Account Number to validate. Spaces are allowed and will be automatically removed during processing. The IBAN should follow the ISO 13616 standard format.
Response parameters
The API response is returned in a universal and lightweight JSON format.Overall validation result indicating whether the IBAN is valid according to all validation rules.
A visual representation of the IBAN structure using B (Bank), S (Sort), C (Customer), and K (Key) placeholders.
Examples
Valid German IBAN
Request:Valid French IBAN
Request:Invalid IBAN
Request:Error handling
Missing IBAN parameter
Request:Missing API key
Request:IBAN Structure
The IBAN consists of several components:- Country Code (2 characters): ISO 3166-1 alpha-2 country code
- Check Digits (2 characters): MOD-97 algorithm validation
- Bank Identifier: Country-specific bank code
- Account Number: Customer account identifier
Country-specific formats
Different countries have varying IBAN structures:- Germany (DE): 22 characters -
BBBB BBBB BBBB BBBB BB - France (FR): 27 characters -
BBBB BSSS SSCC CCCC CCCC CCC KK - Italy (IT): 27 characters -
CAAA AABB BBSS CCCC CCCC CCX - United Kingdom (GB): 22 characters -
BBBB SSSS SSCC CCCC CC - Spain (ES): 24 characters -
BBBB SSSS DDCC CCCC CCCC CC
- B = Bank code
- S = Sort code
- C = Customer account number
- K = Key/Check digit
- A = Account type
- D = Control digit
Validation Rules
The API performs comprehensive validation including:- Format Validation: Checks if the IBAN follows the expected structure for the country
- Length Validation: Verifies the IBAN length matches the country standard
- Checksum Validation: Performs MOD-97 algorithm validation
- Country Code Validation: Ensures the country code is supported
- Character Validation: Checks for valid alphanumeric characters
Supported Countries
The API supports IBAN validation for 50+ countries including:- Europe: Germany, France, Italy, Spain, Netherlands, Belgium, Austria, Switzerland, UK, Poland
- Asia: UAE, Bahrain, Israel, Jordan, Kazakhstan, Kuwait
- Americas: Brazil, Costa Rica, Dominican Republic, Guatemala
- Africa: Mauritania, Mauritius, Tunisia