> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Перевірка BIC
> Ендпоінт `bic` перевіряє банківські ідентифікаційні коди (BIC) і надає детальну розбивку банківських кодів, інформації про країну та типів установ для міжнародних банківських операцій.
## Початок роботи
### Базовий URL
```
https://bankvalidation.cleariflow.com/v1/bic/
```
### Ендпоінт перевірки
Ендпоінт `bic` потребує API-ключа та параметра BIC для комплексної перевірки банківських ідентифікаційних кодів.
```
https://bankvalidation.cleariflow.com/v1/bic/
? api_key = YOUR_UNIQUE_API_KEY
& bic = DEUTDEFF500
```
Цей успішний запит перевіряє німецький BIC і повертає детальну інформацію:
```json theme={"system"}
{
"bic": "DEUTDEFF500",
"is_valid": true,
"country_code": "DE",
"country_name": "Germany",
"bank_code": "DEUT",
"bank_name": "Bank information not available",
"location_code": "F",
"branch_code": "500",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### Параметри запиту
Ваш унікальний API-ключ. Зверніть увагу: у кожного користувача є унікальні API-ключі *для кожного з
API Cleariflow*, тому ключ Bank Validation API не працюватиме для Exchange
Rates API, наприклад.
BIC для перевірки. Пробіли дозволені та автоматично видаляються. BIC має відповідати ISO 9362.
### Параметри відповіді
Відповідь API повертається у універсальному та легкому форматі [JSON](https://www.json.org/json-en.html).
Нормалізований BIC без пробілів у верхньому регістрі.
Загальний результат перевірки дійсності BIC.
Дволітерний ISO-код країни (наприклад, DE — Німеччина, US — США).
Повна назва країни, пов'язаної з BIC.
4-символьний код банку (наприклад, DEUT для Deutsche Bank).
The name of the bank (currently shows "Bank information not available").
2-символьний код локації — місто або регіон (наприклад, FF — Frankfurt).
3-символьний код відділення (необов'язковий, може бути порожнім для 8-символьних BIC).
Додаткова інформація про тип і статус BIC.
Тип ідентифікатора (зазвичай «BIC»).
Чи BIC наразі активний і використовується.
Тип фінансової установи (наприклад, «Bank», «Credit Union»).
## Приклади
### Дійсний німецький BIC (8 символів)
**Запит:**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF
```
**Відповідь:**
```json theme={"system"}
{
"bic": "DEUTDEFF",
"is_valid": true,
"country_code": "DE",
"country_name": "Germany",
"bank_code": "DEUT",
"bank_name": "Bank information not available",
"location_code": "FF",
"branch_code": "",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### Дійсний німецький BIC (11 символів з відділенням)
**Запит:**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF500
```
**Відповідь:**
```json theme={"system"}
{
"bic": "DEUTDEFF500",
"is_valid": true,
"country_code": "DE",
"country_name": "Germany",
"bank_code": "DEUT",
"bank_name": "Bank information not available",
"location_code": "FF",
"branch_code": "500",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### Дійсний BIC США
**Запит:**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=CHASUS33
```
**Відповідь:**
```json theme={"system"}
{
"bic": "CHASUS33",
"is_valid": true,
"country_code": "US",
"country_name": "United States",
"bank_code": "CHAS",
"bank_name": "Bank information not available",
"location_code": "33",
"branch_code": "",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### Дійсний BIC Великої Британії
**Запит:**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=NWBKGB2L
```
**Відповідь:**
```json theme={"system"}
{
"bic": "NWBKGB2L",
"is_valid": true,
"country_code": "GB",
"country_name": "United Kingdom",
"bank_code": "NWBK",
"bank_name": "Bank information not available",
"location_code": "2L",
"branch_code": "",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### Недійсний BIC
**Запит:**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=INVALID
```
**Відповідь:**
```json theme={"system"}
{
"bic": "INVALID",
"is_valid": false,
"country_code": "",
"country_name": "",
"bank_code": "",
"bank_name": "Bank information not available",
"location_code": "",
"branch_code": "",
"details": {
"type": "BIC",
"active": true
}
}
```
## Обробка помилок
### Відсутній параметр BIC
**Запит:**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY
```
**Відповідь:**
```json theme={"system"}
{
"error": {
"message": "Missing bic",
"code": "missing_bic"
}
}
```
### Відсутній API-ключ
**Запит:**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?bic=DEUTDEFF500
```
**Відповідь:**
```json theme={"system"}
{
"error": {
"message": "API key is required",
"code": "missing_api_key"
}
}
```
## Структура BIC
BIC складається з кількох компонентів:
1. **Код банку (4 символи)**: унікальний ідентифікатор установи
2. **Код країни (2 символи)**: ISO 3166-1 alpha-2
3. **Код локації (2 символи)**: ідентифікатор міста або регіону
4. **Код відділення (3 символи)**: необов'язковий (XXX для головного офісу)
### Приклади форматів
* **8-символьний BIC**: `DEUTDEFF` (Deutsche Bank, Німеччина, Frankfurt)
* **11-символьний BIC**: `DEUTDEFF500` (Deutsche Bank, Німеччина, Frankfurt, відділення 500)
### Поширені коди локацій
* **FF**: Frankfurt, Німеччина
* **33**: Нью-Йорк, США
* **2L**: Лондон, Велика Британія
* **PP**: Париж, Франція
* **MM**: Мілан, Італія
## Правила перевірки
API виконує комплексну перевірку:
1. **Перевірка довжини**: чи BIC має 8 або 11 символів
2. **Перевірка формату**: чи BIC відповідає ISO 9362
3. **Перевірка символів**: лише буквено-цифрові символи
4. **Перевірка коду країни**: формат коду країни
5. **Перевірка коду банку**: формат ідентифікатора банку
### Вимоги до формату BIC
* **Код банку**: 4 буквено-цифрові символи
* **Код країни**: 2 літери (ISO 3166-1)
* **Код локації**: 2 буквено-цифрові символи
* **Код відділення**: 3 буквено-цифрові символи (необов'язково)
## BIC vs SWIFT
BIC (Business Identifier Code) і SWIFT часто використовують як синоніми:
* **BIC**: офіційна назва стандарту ISO 9362
* **SWIFT**: мережева система, що популяризувала код
* **SWIFT Code**: альтернативна назва BIC
Усі BIC можна використовувати для SWIFT, але не всі SWIFT-коди є дійсними BIC.
## Підтримувані країни
API підтримує перевірку BIC для 50+ країн, включаючи:
* **Європа**: Німеччина, Франція, Італія, Іспанія, Нідерланди, Бельгія, Австрія, Швейцарія, UK, Польща
* **Америка**: США, Канада, Бразилія, Мексика
* **Азія**: Японія, Сінгапур, Гонконг, Австралія
* **Африка**: ПАР, Єгипет, Нігерія
Повний список — на сторінці [Підтримувані країни](/bank-validation/countries).
## Сценарії використання
Перевірка BIC необхідна для:
1. **Міжнародних переказів**: точної маршрутизації
2. **SEPA-платежів**: вимог європейської платіжної системи
3. **Банківських застосунків**: перевірки рахунків клієнтів
4. **Фінансової відповідності**: регуляторної звітності
5. **Обробки платежів**: e-commerce і fintech