↑ Все API

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

Это документация для разработчиков. Узнать аффилированные компании в демоформе, посмотреть сценарии использования и варианты подключения сервиса можно на странице «Проверка аффилированности»

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

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

Как вызвать

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

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

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/findAffiliated/party
            
            
{ "query": "7736207543" }

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

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

НазваниеТипОбяз.? По умолч. Описание
querystringТекст запроса
countnumber 10 Количество результатов (максимум — 20)
scopearray [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.okatoКод ОКАТО
data.oktmoКод ОКТМО
data.okpoКод ОКПО
data.okoguКод ОКОГУ
data.okfsКод ОКФС
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   — ликвидирована
    BANKRUPT     — банкротство
    REORGANIZING — в процессе присоединения к другому
                    юрлицу, с последующей ликвидацией
└ codeдетальный статус
data.invalid Признак недостоверных сведений об организации (true/null)

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

Примеры вызова

Ограничения

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

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

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

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

Стоимость

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