↑ Все API
{ "query": "044525225" }
Банк по БИК, SWIFT, ИНН или регистрационному номеру
Находит банк по любому из идентификаторов:
- БИК,
- SWIFT,
- ИНН,
- ИНН + КПП (для филиалов),
- регистрационному номеру, присвоенному Банком России.
Ищет только по точному совпадению, для частичного совпадения используйте метод suggest.
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Примеры запросов по разным параметрам:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "044525225" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/bank
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "SABRRUMM012" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/bank
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "7728168971" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/bank
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "7728168971", "kpp": "667102002" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/bank
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "1481" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/bank
Примеры запросов на разных языках программирования:
// https://github.com/hflabs/dadata-csharp var token = "${API_KEY}"; var api = new SuggestClientAsync(token); var result = await api.FindBank("044525225");
var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/bank"; var token = "${API_KEY}"; var query = "044525225"; var options = { method: "POST", mode: "cors", headers: { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Token " + token }, body: JSON.stringify({query: query}) } fetch(url, options) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log("error", error));
// https://github.com/hflabs/dadata-php $token = "${API_KEY}"; $dadata = new \Dadata\DadataClient($token, null); $result = $dadata->findById("bank", "044525225", 1);
# https://github.com/hflabs/dadata-py from dadata import Dadata token = "${API_KEY}" dadata = Dadata(token) result = dadata.find_by_id("bank", "044525225")
Что в ответе
Пример ответа
{ "suggestions": [ { "value": "ПАО Сбербанк", "unrestricted_value": "ПАО Сбербанк", "data": { "opf": { "type": "BANK", "full": null, "short": null }, "name": { "payment": "ПАО СБЕРБАНК", "full": null, "short": "ПАО Сбербанк" }, "bic": "044525225", "swift": "SABRRUMM012", "inn": "7707083893", "kpp": "773601001", "okpo": null, "correspondent_account": "30101810400000000225", "treasury_accounts": null, "registration_number": "1481", "payment_city": "г. Москва", "state": { "status": "ACTIVE", "actuality_date": 1564532138000, "registration_date": 677376000000, "liquidation_date": null }, "rkc": null, "cbr": { ... "name": { "payment": "ГУ БАНКА РОССИИ ПО ЦФО", "full": null, "short": null }, "bic": "044525000", ... "address": { "value": "115035, г Москва 35, ул Балчуг, 2", "unrestricted_value": "115035, г Москва 35, ул Балчуг, 2", "data": null }, "phones": null }, "address": { "value": "г Москва, ул Вавилова, д 19", ... }, "phones": null } }, ... ] }
Название | Описание |
---|---|
value | Наименование банка |
unrestricted_value | = value |
data.bic | Банковский идентификационный код (БИК) ЦБ РФ |
data.swift | Банковский идентификационный код в системе SWIFT |
data.inn | ИНН |
data.kpp | КПП |
data.registration_number | Регистрационный номер в ЦБ РФ |
data.correspondent_account | Корреспондентский счет в ЦБ РФ |
data.treasury_accounts | Казначейские счета (для УФК) |
data.name | Наименование |
└ payment | — платежное наименование |
└ full | — не заполняется |
└ short | — краткое наименование |
data.payment_city | Город для платежного поручения (поля справочника Tnp + Nnp). |
data.opf | Тип кредитной организации |
└ type | — код типа:
BANK — банк BANK_BRANCH — филиал банка NKO — небанковская кредитная организация (НКО) NKO_BRANCH — филиал НКО RKC — расчетно-кассовый центр CBR - управление ЦБ РФ (март 2021) TREASURY - управление Казначейства (март 2021) OTHER — другой |
└ full | — не заполняется |
└ short | — не заполняется |
data.cbr | Управление ЦБ РФ, к которому относится банк |
└ name.payment | — наименование управления ЦБ РФ |
└ bic | — БИК управления ЦБ РФ |
└ address.value | — адрес управления ЦБ РФ |
data.address | Адрес регистрации |
└ value | — адрес одной строкой стандартизован, поэтому может отличаться от записанного в справочнике БИК. |
└ unrestricted_value | — адрес одной строкой (полный, с индексом) стандартизован, поэтому может отличаться от записанного в справочнике БИК. |
└ data | — гранулярный адрес |
└ data.source | — адрес одной строкой как в справочнике БИК |
└ data.qc | — код проверки адреса
0 — адрес распознан уверенно 1 или 3 — требуется ручная проверка |
data.state | Состояние |
└ actuality_date | — дата актуальности сведений |
└ registration_date | — дата регистрации |
└ liquidation_date | — дата ликвидации |
└ status | — статус организации
ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована |
data.okpo | Не заполняется |
data.phone | Не заполняется |
data.rkc | Не заполняется |
Источники данных:
- Справочник БИК Банка России
- Справочник по кредитным организациям
Примеры вызова
Ограничения
Длина запроса (параметр query
) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 30 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Стоимость
Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.