Компании и ИП
POST/v1/suggest/party
В разработке. Метод пока недоступен в рабочем API. Ниже приведён планируемый формат запроса и ответа.
Поиск организаций и ИП по ИНН, ОГРН или названию. Вернёт реквизиты, руководителя, статус и юридический адрес из ЕГРЮЛ/ЕГРИП.
POST /v1/suggest/party // подсказки: название, ИНН или ОГРН
{ "query": "яндекс", "count": 5 }
POST /v1/find/party // одна запись: точный ИНН или ОГРН
{ "query": "7840109172" }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| result | array | Массив найденных организаций и индивидуальных предпринимателей, отсортированный по релевантности запросу. |
| result.inn | string | ИНН: 10 цифр для организации, 12 цифр для ИП. |
| result.ogrn | string | Основной государственный регистрационный номер: ОГРН (13 цифр) для организации, ОГРНИП (15 цифр) для ИП. |
| result.name_short | string | Краткое наименование организации; для ИП — ФИО предпринимателя. |
| result.management | string | ФИО руководителя — лица, действующего от имени организации без доверенности. Может отсутствовать (например, у ИП). |
| result.status | string | Текущее состояние в реестре. Значения: ACTIVE — действующая; LIQUIDATING — в процессе ликвидации; LIQUIDATED — ликвидирована; REORGANIZING — в процессе реорганизации; BANKRUPT — в процедуре банкротства. |
| result.address | string | Адрес места нахождения (для ИП — место жительства) одной строкой, с почтовым индексом. |
Банк
POST/v1/suggest/bank
Поиск банка по БИК, SWIFT или названию. Возвращает наименование, SWIFT, корреспондентский счёт и адрес.
POST /v1/suggest/bank
{ "query": "044525225" }Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| suggestions | array | Массив найденных банков, отсортированных по релевантности запросу. |
| suggestions[].value | string | Наименование банка (например, «ПАО Сбербанк»). |
| suggestions[].bic | string | Банковский идентификационный код (БИК), 9 цифр. |
| suggestions[].swift | string | Код SWIFT для международных переводов; null, если у банка его нет. |
| suggestions[].correspondent_account | string | Корреспондентский счёт банка, 20 цифр; нужен для платёжного поручения. |
| suggestions[].registration_number | string | Регистрационный номер банка в Банке России. |
| suggestions[].participant_type | string | Тип участника платёжной системы (например, branch — филиал, head — головной). |
| suggestions[].city | string | Город банка. |
| suggestions[].address | string | Адрес банка. |
| suggestions[].status | string | Статус в реестре ЦБ: ACTIVE — действующий; LIQUIDATED — исключён из реестра. |