Поиск аффилированных компаний

Часто учредитель или директор не ограничивается участием в одном юрлице, а фигурирует в нескольких. Порой — в десятках разных компаний. Знать об этом полезно как для оценки надёжности контрагента, так и для более эффективного маркетинга и продаж. Чтобы облегчить поиск аффилированных компаний, «Дадата» находит организации по ИНН учредителей и руководителей.

Ищет по ИНН физлиц и юрлиц.

Как вызвать

Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.

В параметре query укажите ИНН учредителя или руководителя компании:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "7736207543" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findAffiliated/party

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

Название Тип Обяз.? По умолч. Описание
query string Текст запроса
count number 10 Количество результатов (максимум — 300)
scope array [string] FOUNDERS, MANAGERS Где искать — среди учредителей (FOUNDERS), руководителей (MANAGERS), или и тех, и других (по умолчанию). См. примеры

Ограничение области поиска

По умолчанию метод ищет как среди учредителей, так и среди руководителей. Если требуется искать только среди учредителей, укажите scope = FOUNDERS:

{
    "query": "7736207543",
    "scope": ["FOUNDERS"]
}

Аналогично — если требуется искать только среди руководителей:

{
    "query": "7736207543",
    "scope": ["MANAGERS"]
}

Что в ответе

Объект с массивом организаций в поле suggestions:

{
    "suggestions": [
        {
            "value": "ООО \"ДЗЕН.ПЛАТФОРМА\"",
            "unrestricted_value": "ООО \"ДЗЕН.ПЛАТФОРМА\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЕДАДИЛ\"",
            "unrestricted_value": "ООО \"ЕДАДИЛ\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЗНАНИЕ\"",
            "unrestricted_value": "ООО \"ЗНАНИЕ\"",
            "data": { ... }
        },
        {
            "value": "ООО \"НАПА\"",
            "unrestricted_value": "ООО \"НАПА\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЯНДЕКС.ДРАЙВ\"",
            "unrestricted_value": "ООО \"ЯНДЕКС.ДРАЙВ\"",
            "data": { ... }
        }
    ]
}

По каждой организации возвращается ограниченный набор полей:

Название Описание
value Наименование компании
unrestricted_value = value
data.inn ИНН
data.kpp КПП
data.ogrn ОГРН
data.hid Уникальный идентификатор в Дадате
data.type Тип организации
    LEGAL      — юридическое лицо
    INDIVIDUAL — индивидуальный предприниматель
data.okved Код ОКВЭД
data.okved_type Версия справочника ОКВЭД (2001 или 2014)
data.branch_count Количество филиалов
data.branch_type Тип подразделения
    MAIN   — головная организация
    BRANCH — филиал
data.address.value Aдрес одной строкой:
  • адрес организации для юридических лиц;
  • город проживания для индивидуальных предпринимателей.
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
data.state Состояние
└ actuality_date — дата актуальности сведений
└ registration_date — дата регистрации
└ liquidation_date — дата ликвидации
└ status — статус организации
    ACTIVE       — действующая
    LIQUIDATING  — ликвидируется
    LIQUIDATED   — ликвидирована
    REORGANIZING — в процессе присоединения к другому
                    юрлицу, с последующей ликвидацией

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

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 20 в секунду.

Максимальная частота создания новых соединений — 60 в минуту.

Стоимость

Входит в состав годовой подписки на тарифе «Максимальный». На остальных тарифах недоступен.

ajax-spinner

Зарегистрируйтесь, чтобы подключить API

до 10 тыс. запросов бесплатно

чтобы обращаться к вам в письмах

Регистрируясь, вы принимаете публичную оферту

Уже зарегистрированы? Войти