Перейти к основному содержанию
GET
/
v1
/
iban
Проверка IBAN
curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/iban/
{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

​
Начало работы

​
Базовый URL

https://bankvalidation.cleariflow.com/v1/iban/

​
Эндпоинт проверки

Эндпоинт iban требует ваш API-ключ и параметр IBAN для комплексной проверки международных банковских счётов. 
https://bankvalidation.cleariflow.com/v1/iban/
? api_key = YOUR_UNIQUE_API_KEY
& iban = DE89370400440532013000
Успешный запрос проверяет немецкий IBAN и возвращает подробную информацию: 
{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

​
Параметры запроса

​
api_key
String
обязательно
Ваш уникальный API-ключ. У каждого пользователя уникальные ключи для каждого API Cleariflow, поэтому ключ Bank Validation не будет работать, например, с API обменных курсов.
​
iban
String
обязательно
Международный банковский счёт для проверки. Пробелы допустимы и автоматически удаляются при обработке. IBAN должен соответствовать формату стандарта ISO 13616.

​
Параметры ответа

Ответ API возвращается в универсальном лёгком формате JSON.
​
iban
String
Нормализованный IBAN без пробелов в верхнем регистре.
​
is_valid
Boolean
Общий результат проверки — валиден ли IBAN по всем правилам.
​
country_code
String
Двухбуквенный ISO-код страны (например, DE для Германии, FR для Франции).
​
country_name
String
Полное название страны, связанной с IBAN.
​
bank_code
String
Банковский идентификатор, извлечённый из IBAN согласно формату конкретной страны.
​
account_number
String
Номер счёта в IBAN без кода страны, контрольных цифр и банковского кода.
​
length
Integer
Фактическая длина переданного IBAN.
​
expected_length
Integer
Ожидаемая длина IBAN для конкретной страны по стандарту ISO 13616.
​
checksum_valid
Boolean
Прошла ли проверка контрольной суммы IBAN по алгоритму MOD-97.
​
format_valid
Boolean
Соответствует ли формат IBAN ожидаемой структуре для страны.
​
details
Object
Дополнительная подробная информация о структуре и форматировании IBAN.
​
details.structure
String
Визуальное представление структуры IBAN с плейсхолдерами B (Bank), S (Sort), C (Customer) и K (Key).
​
details.example
String
Правильно отформатированный пример IBAN с пробелами для читаемости.
​
details.bank_name
String
Название банка (сейчас отображается «Bank information not available»).
​
details.bank_bic
String
BIC-код банка (сейчас отображается «BIC not available»).
​
details.account_type
String
Тип счёта (обычно «Bank Account»).
​
details.currency
String
Код валюты страны (например, EUR для еврозоны, GBP для Великобритании).

​
Примеры

​
Валидный немецкий IBAN

Запрос: 
GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=DE89370400440532013000
Ответ: 
{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

​
Валидный французский IBAN

Запрос: 
GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=FR1420041010050500013M02606
Ответ: 
{
  "iban": "FR1420041010050500013M02606",
  "is_valid": true,
  "country_code": "FR",
  "country_name": "France",
  "bank_code": "2004101005",
  "account_number": "0500013M02606",
  "length": 27,
  "expected_length": 27,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BSSS SSCC CCCC CCCC CCC KK",
    "example": "FR14 2004 1010 0505 0001 3M02 606",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

​
Невалидный IBAN

Запрос: 
GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=INVALID
Ответ: 
{
  "iban": "",
  "is_valid": false,
  "country_code": "",
  "country_name": "",
  "bank_code": "",
  "account_number": "",
  "length": 7,
  "expected_length": 0,
  "checksum_valid": false,
  "format_valid": false,
  "details": {
    "structure": "",
    "example": ""
  }
}

​
Обработка ошибок

​
Отсутствует параметр IBAN

Запрос: 
GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY
Ответ: 
{
  "error": {
    "message": "Missing iban",
    "code": "missing_iban"
  }
}

​
Отсутствует API-ключ

Запрос: 
GET https://bankvalidation.cleariflow.com/v1/iban/?iban=DE89370400440532013000
Ответ: 
{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key"
  }
}

​
Структура IBAN

IBAN состоит из нескольких компонентов:
  1. Код страны (2 символа): ISO 3166-1 alpha-2 код страны
  2. Контрольные цифры (2 символа): проверка по алгоритму MOD-97
  3. Банковский идентификатор: банковский код, специфичный для страны
  4. Номер счёта: идентификатор счёта клиента

​
Форматы по странам

В разных странах структура IBAN различается:
  • Германия (DE): 22 characters - BBBB BBBB BBBB BBBB BB
  • Франция (FR): 27 characters - BBBB BSSS SSCC CCCC CCCC CCC KK
  • Италия (IT): 27 characters - CAAA AABB BBSS CCCC CCCC CCX
  • Великобритания (GB): 22 characters - BBBB SSSS SSCC CCCC CC
  • Испания (ES): 24 characters - BBBB SSSS DDCC CCCC CCCC CC
Где:
  • B = банковский код
  • S = код сортировки
  • C = номер счёта клиента
  • K = ключевая/контрольная цифра
  • A = тип счёта
  • D = контрольная цифра

​
Правила проверки

API выполняет комплексную проверку, включая:
  1. Проверка формата: соответствует ли IBAN ожидаемой структуре для страны
  2. Проверка длины: соответствует ли длина IBAN стандарту страны
  3. Проверка контрольной суммы: валидация по алгоритму MOD-97
  4. Проверка кода страны: поддерживается ли код страны
  5. Проверка символов: допустимые буквенно-цифровые символы

​
Поддерживаемые страны

API поддерживает проверку IBAN для 50+ стран, включая:
  • Европа: Германия, Франция, Италия, Испания, Нидерланды, Бельгия, Австрия, Швейцария, Великобритания, Польша
  • Азия: ОАЭ, Бахрейн, Израиль, Иордания, Казахстан, Кувейт
  • Америка: Бразилия, Коста-Рика, Доминиканская Республика, Гватемала
  • Африка: Мавритания, Маврикий, Тунис
Полный список поддерживаемых стран см. на странице Поддерживаемые страны.