ПолеТип данныхОписание
valuestring(1000)

Для банков (opf.type = BANK): краткое наименование (data.name.short). Если краткое наименование не указано — платежное наименование (data.name.payment).

Для всех остальных: платежное наименование (data.name.payment).

unrestricted_valuestring(1000)= value
data.bicstring(10)БИК
data.swiftstring(20)SWIFT
data.innstring(20)ИНН (начиная с версии 20.3)
data.kppstring(10)КПП (начиная с версии 20.3)
data.correspondent_accountstring(20)Корреспондентский счет
data.treasury_accounts[]string[](20)Казначейские счета территориального ОФК (21.2+)
data.registration_numberstring(10)Регистрационный номер

data.name

└ payment

└ full

└ short


string(200)


string(1000)

Наименование:

— платежное

— не заполняется

— краткое

data.payment_citystring(50)Город для платежного поручения (поля справочника Tnp + Nnp) (начиная с версии 19.7)
data.opf
Тип кредитной организации
└ typestring(50)

Код типа

  • CBR — главное управление Банка России (21.2+)
  • BANK — банк
  • BANK_BRANCH — филиал банка
  • NKO — небанковская кредитная организация (НКО)
  • NKO_BRANCH — филиал НКО
  • RKC — расчетно-кассовый центр
  • TREASURY — территориальный орган Федерального казначейства (21.2+)
  • OTHER — другой
└ full
не заполняется
└ short
не заполняется
data.cbrobject

Управление Банка России, к которому относится банк. Заполняется только при вызове через метод API findById (21.2+)

В поле возвращается Объект банка без заполнения гранулярных полей адреса.

data.address
Адрес регистрации
└ valuestring(1000)— адрес банка одной строкой (краткий)
Стандартизован, поэтому может отличаться от записанного в справочнике БИК.
└ unrestricted_valuestring(1000)— адрес банка одной строкой (полный)
└ data

— гранулярный адрес

└ data.sourcestring(1000)

— адрес одной строкой как в справочнике БИК

└ data.qcstring(10)

— код качества адреса (начиная с версии 19.1)

  • 0 — адрес распознан уверенно

  • 1 или 3 — требуется ручная проверка

data.state
Состояние
└ actuality_datelong— дата актуальности сведений
└ registration_datelong— дата регистрации
└ liquidation_date long— дата ликвидации
└ statusstring(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));