Поиск банка по идентификатору

Работает в «Подсказках» 19.3+

Находит банк по любому из идентификаторов: БИК, SWIFT, ИНН, ИНН + КПП (для филиалов), рег. номеру, присвоенному Банком России. Возвращает реквизиты банка, корр. счёт, адрес и статус (действующий / на ликвидации).

Запрос

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "044525545" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/findById/bank

Заголовки

Заголовок Описание

Content-Type

Тип данных в запросе: application/json или application/xml

Accept

Тип данных в ответе: application/json или application/xml

Authorization

API-ключ в формате: Token ВАШ_КЛЮЧ

Только для пользователей подсказок DaData.ru

Параметры

Параметр	Обязательный?	Описание
query	да	БИК, SWIFT, регистрационный номер, ИНН или КПП (ИНН и КПП начиная с версиии подсказок 20.3)
kpp	нет	КПП банка (начиная с версии подсказок 20.3)

Ответ

Возвращает объект банка, который соответствует указанному коду:

Поле	Тип данных	Описание
value	string(1000)	Для банков (`opf.type = BANK`): краткое наименование (`data.name.short`). Если краткое наименование не указано — платежное наименование (`data.name.payment`). Для всех остальных: платежное наименование (`data.name.payment`).
unrestricted_value	string(1000)	= value
data.bic	string(10)	БИК
data.swift	string(20)	SWIFT
data.inn	string(20)	ИНН (начиная с версии 20.3)
data.kpp	string(10)	КПП (начиная с версии 20.3)
data.correspondent_account	string(20)	Корреспондентский счет
data.treasury_accounts[]	string[](20)	Казначейские счета территориального ОФК (21.2+)
data.registration_number	string(10)	Регистрационный номер
data.name └ payment └ full └ short	string(200) string(1000)	Наименование: — платежное — не заполняется — краткое
data.payment_city	string(50)	Город для платежного поручения (поля справочника Tnp + Nnp) (начиная с версии 19.7)
data.opf		Тип кредитной организации
└ type	string(50)	Код типа CBR — главное управление Банка России (21.2+) BANK — банк BANK_BRANCH — филиал банка NKO — небанковская кредитная организация (НКО) NKO_BRANCH — филиал НКО RKC — расчетно-кассовый центр TREASURY — территориальный орган Федерального казначейства (21.2+) OTHER — другой
└ full		не заполняется
└ short		не заполняется
data.cbr	object	Управление Банка России, к которому относится банк. Заполняется только при вызове через метод API findById (21.2+) В поле возвращается Объект банка без заполнения гранулярных полей адреса.
data.address		Адрес регистрации
└ value	string(1000)	— адрес банка одной строкой (краткий) Стандартизован, поэтому может отличаться от записанного в справочнике БИК.
└ unrestricted_value	string(1000)	— адрес банка одной строкой (полный)
└ data		— гранулярный адрес
└ data.source	string(1000)	— адрес одной строкой как в справочнике БИК
└ data.qc	string(10)	— код качества адреса (начиная с версии 19.1) 0 — адрес распознан уверенно 1 или 3 — требуется ручная проверка
data.state		Состояние
└ actuality_date	long	— дата актуальности сведений
└ registration_date	long	— дата регистрации
└ liquidation_date	long	— дата ликвидации
└ status	string(50)	— статус ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована Статус LIQUIDATED в реальных данных не встречается, потому что Банк России не возвращает информацию о ликвидированных финансовых организациях.
data.okpo		не заполняется
data.phone		не заполняется
data.rkc		не заполняется

Формат даты

Даты регистрации и ликвидации — количество миллисекунд от 01.01.1970. Хранится в UTC.

Для JavaScript преобразуется в дату так:

var ticks = 989784000000,
    date = new Date(ticks);

Для PHP:

$ticks = 989784000000;
$sec = $ticks / 1000;
echo date("d.m.Y", $sec);

Для Java:

long ticks = 989784000000;
Calendar cal = Calendar.getInstance();
cal.setTimeInMillis(ticks);

Для C#:

long ticks = 989784000000;
DateTime date = new DateTime(long.Parse(ticks));

Примеры

Запрос по БИК:

{
  "query": "042520607" 
}

Запрос по SWIFT:

{
  "query": "SABRRU66XXX" 
}

Запрос по регистрационному номеру:

{
  "query": "1481/422" 
}

Запрос по ИНН:

{
  "query": "7707083893" 
}

Запрос по ИНН и КПП (для поиска филиала банка):

{
  "query":"7707083893", 
  "kpp":"380843001" 
}

{
    "suggestions": [
        {
            "value": "БАЙКАЛЬСКИЙ БАНК ПАО СБЕРБАНК",
            "unrestricted_value": "БАЙКАЛЬСКИЙ БАНК ПАО СБЕРБАНК",
            "data": {
                "opf": {
                    "type": "BANK_BRANCH",
                    "full": null,
                    "short": null
                },
                "name": {
                    "payment": "БАЙКАЛЬСКИЙ БАНК ПАО СБЕРБАНК",
                    "full": null,
                    "short": null
                },
                "bic": "042520607",
                "swift": "SABRRU66XXX",
                "inn": "7707083893",
                "kpp": "380843001",
                "okpo": null,
                "correspondent_account": "30101810900000000607",
                "registration_number": "1481/422",
                "payment_city": "г. Иркутск",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1583280000000,
                    "registration_date": null,
                    "liquidation_date": null
                },
                "rkc": null,
                "address": {
                    "value": "г Иркутск, ул Нижняя Набережная, д 10",
                    "unrestricted_value": "664011, Иркутская обл, г Иркутск, Кировский р-н, ул Нижняя Набережная, д 10",
                    "data": {
                        "postal_code": "664011",
                        "country": "Россия",
                        "country_iso_code": "RU",
                        "federal_district": "Сибирский",
                        "region_fias_id": "6466c988-7ce3-45e5-8b97-90ae16cb1249",
                        "region_kladr_id": "3800000000000",
                        "region_iso_code": "RU-IRK",
                        "region_with_type": "Иркутская обл",
                        "region_type": "обл",
                        "region_type_full": "область",
                        "region": "Иркутская",
                        "area_fias_id": null,
                        "area_kladr_id": null,
                        "area_with_type": null,
                        "area_type": null,
                        "area_type_full": null,
                        "area": null,
                        "city_fias_id": "8eeed222-72e7-47c3-ab3a-9a553c31cf72",
                        "city_kladr_id": "3800000300000",
                        "city_with_type": "г Иркутск",
                        "city_type": "г",
                        "city_type_full": "город",
                        "city": "Иркутск",
                        "city_area": null,
                        "city_district_fias_id": null,
                        "city_district_kladr_id": null,
                        "city_district_with_type": "Кировский р-н",
                        "city_district_type": "р-н",
                        "city_district_type_full": "район",
                        "city_district": "Кировский",
                        "settlement_fias_id": null,
                        "settlement_kladr_id": null,
                        "settlement_with_type": null,
                        "settlement_type": null,
                        "settlement_type_full": null,
                        "settlement": null,
                        "street_fias_id": "241f2f43-5a67-4d79-b440-fda4a700ad45",
                        "street_kladr_id": "38000003000038000",
                        "street_with_type": "ул Нижняя Набережная",
                        "street_type": "ул",
                        "street_type_full": "улица",
                        "street": "Нижняя Набережная",
                        "house_fias_id": "9332c1e4-555c-478c-90cd-08a3e4454ef9",
                        "house_kladr_id": "3800000300003800001",
                        "house_type": "д",
                        "house_type_full": "дом",
                        "house": "10",
                        "block_type": null,
                        "block_type_full": null,
                        "block": null,
                        "flat_type": null,
                        "flat_type_full": null,
                        "flat": null,
                        "flat_area": null,
                        "square_meter_price": null,
                        "flat_price": null,
                        "postal_box": null,
                        "fias_id": "9332c1e4-555c-478c-90cd-08a3e4454ef9",
                        "fias_code": "38000003000000003800001",
                        "fias_level": "8",
                        "fias_actuality_state": "0",
                        "kladr_id": "3800000300003800001",
                        "geoname_id": null,
                        "capital_marker": "2",
                        "okato": "25401365000",
                        "oktmo": "25701000001",
                        "tax_office": "3808",
                        "tax_office_legal": "3808",
                        "timezone": "UTC+8",
                        "geo_lat": "52.2928747",
                        "geo_lon": "104.2875056",
                        "beltway_hit": null,
                        "beltway_distance": null,
                        "metro": null,
                        "qc_geo": "0",
                        "qc_complete": "5",
                        "qc_house": "2",
                        "history_values": null,
                        "unparsed_parts": null,
                        "source": "664011, г. Иркутск, ул Н. Набережная, 10",
                        "qc": "0"
                    }
                },
                "phones": null
            }
        }
    ]
}

Дерево страниц