> ## 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` проверяет банковские идентификационные коды, предоставляя детальную разбивку банковских кодов, информации о стране и типах учреждений для международных банковских операций.
## Начало работы
### Базовый 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 Cleariflow*, поэтому ключ Bank Validation не будет работать, например, с API обменных курсов.
Банковский идентификационный код для проверки. Пробелы допустимы и автоматически удаляются. BIC должен соответствовать формату стандарта ISO 9362.
### Параметры ответа
Ответ API возвращается в универсальном лёгком формате [JSON](https://www.json.org/json-en.html).
Нормализованный BIC без пробелов в верхнем регистре.
Общий результат проверки — валиден ли BIC по всем правилам.
Двухбуквенный ISO-код страны (например, DE для Германии, US для США).
Полное название страны, связанной с BIC.
4-символьный банковский идентификатор (например, DEUT для Deutsche Bank).
Название банка (сейчас отображается «Bank information not available»).
2-символьный код местоположения — город или регион (например, FF для Франкфурта).
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, Германия, Франкфурт)
* **11-символьный BIC**: `DEUTDEFF500` (Deutsche Bank, Германия, Франкфурт, филиал 500)
### Распространённые коды местоположения
* **FF**: Франкфурт, Германия
* **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 и SWIFT
BIC (Business Identifier Code) и SWIFT часто используются как синонимы:
* **BIC**: официальное название по стандарту ISO 9362
* **SWIFT**: сеть обмена сообщениями, популяризировавшая код
* **SWIFT Code**: альтернативное название BIC
Все BIC можно использовать для SWIFT-сообщений, но не все SWIFT-коды являются валидными BIC.
## Поддерживаемые страны
API поддерживает проверку BIC для 50+ стран, включая:
* **Европа**: Германия, Франция, Италия, Испания, Нидерланды, Бельгия, Австрия, Швейцария, Великобритания, Польша
* **Америка**: США, Канада, Бразилия, Мексика
* **Азия**: Япония, Сингапур, Гонконг, Австралия
* **Африка**: ЮАР, Египет, Нигерия
Полный список поддерживаемых стран см. на странице [Поддерживаемые страны](/bank-validation/countries).
## Сценарии использования
Проверка BIC необходима для:
1. **Международные переводы**: точная маршрутизация
2. **Платежи SEPA**: требования европейской платёжной системы
3. **Банковские приложения**: проверка счетов клиентов
4. **Финансовое соответствие**: требования регуляторной отчётности
5. **Обработка платежей**: e-commerce и fintech-приложения