Компании, ИП и банки

Компании и ИП

Поиск организаций и ИП по названию, ИНН, ОГРН, КПП, адресу, почте и ФИО руководителя. Реестр ЕГРЮЛ и ЕГРИП целиком — 33,7 млн записей вместе с подразделениями, включая ликвидированные.

Опечатки и слитное написание допускаются: «сбирбанк» и «альфабанк» находят Сбербанк и Альфа-Банк. При равном совпадении по тексту выше стоит более крупная организация.

Параметры запроса

POST /v1/suggest/party                        // к нам
POST /suggestions/api/4_1/rs/suggest/party    // совместимо с DaData
{ "query": "сбер", "count": 5 }

// фильтры: только действующие юрлица, только головные
{ "query": "сбер", "count": 5,
  "type": "LEGAL", "status": ["ACTIVE"], "branch_type": "MAIN" }

Поля ответа

Часть полей есть только у компаний, часть — только у предпринимателей. У компании не бывает ФИО, гражданства и пола; у предпринимателя — КПП, уставного капитала, филиалов, учредителей и правопреемства. Таких полей в ответе просто нет.

Ниже — то, что приходит ИМЕННО в подсказке. Ключи полного досье (учредители с долями, лицензии, отчётность, контакты, правопреемство) в ответе тоже есть, но равны null: набор ключей у всех методов домена один и тот же, отличается наполнение. Их состав — в разделе по ИНН, ОГРН и КПП.

Что доступно на каком тарифе

Все четыре метода работают на любом тарифе — отдельной платы за метод нет. Различается только состав полей.

Закрытые тарифом поля приходят как null — запрос не отклоняется и код менять не нужно.

По ИНН, ОГРН и КПП

Точная запись по идентификатору, а не подсказка: возвращает организацию по ИНН, ОГРН или ОГРНИП. У организации с подразделениями вернёт несколько объектов — головную и филиалы; чтобы получить конкретный филиал, передайте kpp или ИНН и КПП одной строкой через слеш. ⚠️Примерно у четверти подразделений налоговая не публикует КПП — такие филиалы этим методом не найти, но они находятся обычным поиском по названию и адресу.

Параметры запроса

POST /v1/find/party                             // к нам: точная запись по ИНН или ОГРН
POST /suggestions/api/4_1/rs/findById/party    // совместимо с DaData
{ "query": "7707083893" }

// конкретный филиал по КПП
{ "query": "7707083893", "kpp": "540602001" }

// или ИНН/КПП одной строкой
{ "query": "7707083893/540602001" }

Поля ответа

Ответ — карточка организации целиком: реквизиты, состояние и статистика, плюс полное досье — учредители и руководители с именами и долями, отчётность за три года, лицензии, контакты, правопреемство при реорганизации. У организации с подразделениями головная запись и каждый филиал приходят отдельными объектами.

Что внутри составных полей досье

Поля-объекты и списки — по составу. Пустые значения приходят как null, пустые списки — как [].

Одни и те же данные приходят в двух раскладках. Заметные различия в названиях полей:

Связанные компании

Организации, где указанный ИНН значится учредителем или руководителем. Принимает ИНН как физического лица, так и организации. Необязательный scope сужает до одной роли: ["FOUNDERS"] или ["MANAGERS"].

Параметры запроса

POST /v1/find/party-affiliated                // к нам
POST /suggestions/api/4_1/rs/findAffiliated/party// совместимо с DaData
{ "query": "7707083893", "count": 10 }

// сузить до одной роли
{ "query": "7707083893", "scope": ["FOUNDERS"] }

Поля ответа

Каждая запись — организация, где указанный ИНН значится учредителем или руководителем, с полным набором полей: реквизиты и досье целиком.

Компания по email

Организация по адресу электронной почты из реестра. Почта берётся только из ЕГРЮЛ и ЕГРИП.

Параметры запроса

POST /v1/find/party-by-email                  // к нам
POST /suggestions/api/4_1/rs/findByEmail/company// совместимо с DaData
{ "query": "CFO_SPB@SBERBANK.RU", "count": 5 }

Поля ответа

Организация, к которой привязана указанная почта, с полным набором полей: реквизиты и досье целиком.

Банк

Поиск банка по БИК, SWIFT или названию. Возвращает наименование, SWIFT, корреспондентский счёт и адрес.

Параметры запроса

POST /v1/suggest/bank                         // к нам
POST /suggestions/api/4_1/rs/suggest/bank     // совместимо с DaData
{ "query": "044525225" }

Поля ответа