↑ Все API

Организация по ИНН или ОГРН

Находит компанию или ИП по ИНН или ОГРН. Возвращает все доступные сведения о компании, в отличие от метода suggest, который возвращает только базовые поля.

Как вызвать

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

Пример запроса:

cURL

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

.NET

// https://github.com/hflabs/dadata-csharp

var token = "${API_KEY}";
var api = new SuggestClientAsync(token);
var result = await api.FindParty("7707083893");

JavaScript

var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party";
var token = "${API_KEY}";
var query = "7707083893";

var options = {
    method: "POST",
    mode: "cors",
    headers: {
        "Content-Type": "application/json",
        "Accept": "application/json",
        "Authorization": "Token " + token
    },
    body: JSON.stringify({query: query})
}

fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));

PHP

// https://github.com/hflabs/dadata-php

$token = "${API_KEY}";
$dadata = new \Dadata\DadataClient($token, null);
$result = $dadata->findById("party", "7707083893", 1);

Python

# https://github.com/hflabs/dadata-py

from dadata import DadataAsync
token = "${API_KEY}"
dadata = DadataAsync(token)
result = await dadata.find_by_id("party", "7707083893")

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

Название	Тип	Обяз.?	По умолч.	Описание
query	string	✓		ИНН или ОГРН
count	number		10	Количество результатов (максимум — 20)
kpp	string			КПП для поиска по филиалам, см. пример
branch_type	string			Головная организация (`MAIN`) или филиал (`BRANCH`), см. пример
type	string			Юрлицо (`LEGAL`) или индивидуальный предприниматель (`INDIVIDUAL`), см. пример

Головные организации и филиалы

Если у компании есть филиалы, запрос вернёт несколько объектов. Если нужна только головная организация, укажите дополнительный параметр branch_type:

{
    "query": "7707083893",
    "branch_type": "MAIN"
}

Чтобы найти конкретный филиал, укажите дополнительный параметр kpp:

{
    "query": "7707083893",
    "kpp": "540602001"
}

К сожалению, для 50% компаний налоговая служба пока не сообщает КПП филиалов. Такие филиалы с помощью данного метода найти не получится.

Юрлица и индивидуальные предприниматели

Чтобы искать только среди юрлиц, либо только среди индивидуальных предпринимателей, укажите параметр type:

# Юрлица
{
    "query": "7707083893",
    "type": "LEGAL"
}

# Индивидуальные предприниматели
{
    "query": "784806113663",
    "type": "INDIVIDUAL"
}

Что в ответе

Пример ответа

{
  "suggestions": [
    {
      "value": "ООО \"МОТОРИКА\"",
      "unrestricted_value": "ООО \"МОТОРИКА\"",
      "data": {
        "kpp": "402701001",
        "capital": {
          "type": "УСТАВНЫЙ КАПИТАЛ",
          "value": 12000
        },
        "management": {
          "name": "Алексеев Денис Сергеевич",
          "post": "ДИРЕКТОР",
          "disqualified": null
        },
        "founders": [
          {
            "inn": "402708415215",
            "fio": {
              "surname": "Алексеев",
              "name": "Денис",
              "patronymic": "Сергеевич",
              "gender": "MALE",
              "source": "АЛЕКСЕЕВ ДЕНИС СЕРГЕЕВИЧ",
              "qc": null
            },
            "hid": "e803b2ab9d94c7cc9b5d6a881ec811c25697cd00c220ca31d197ae0a855a5e79",
            "type": "PHYSICAL",
            "share": {
                "value": 100,
                "type": "PERCENT"
            }
          }
        ],
        "managers": [
          {
            "inn": "402708415215",
            "fio": {
              "surname": "Алексеев",
              "name": "Денис",
              "patronymic": "Сергеевич",
              "gender": "MALE",
              "source": "АЛЕКСЕЕВ ДЕНИС СЕРГЕЕВИЧ",
              "qc": null
            },
            "post": "ДИРЕКТОР",
            "hid": "6a82d08f1a055dbf026d664cf9db243392ed207d6ccc15345d7c3c52d7a8192e",
            "type": "EMPLOYEE"
          }
        ],
        "predecessors": null,
        "successors": null,
        "branch_type": "MAIN",
        "branch_count": 0,
        "source": null,
        "qc": null,
        "hid": "938542c99ff6853be22eee49e9344f3bf102dae0dd2e6dae17772b7048f8f5fa",
        "type": "LEGAL",
        "state": {
          "status": "ACTIVE",
          "actuality_date": 1559692800000,
          "registration_date": 1334880000000,
          "liquidation_date": null
        },
        "opf": {
          "type": "2014",
          "code": "12300",
          "full": "Общество с ограниченной ответственностью",
          "short": "ООО"
        },
        "name": {
          "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"МОТОРИКА\"",
          "short_with_opf": "ООО \"МОТОРИКА\"",
          "latin": null,
          "full": "МОТОРИКА",
          "short": "МОТОРИКА"
        },
        "inn": "4028051108",
        "ogrn": "1124028002273",
        "okato": "29401000000",
        "oktmo": "29701000001",
        "okpo": "37833858",
        "okogu": "4210014",
        "okfs": "16",
        "okved": "45.3",
        "okveds": [
          {
            "main": true,
            "type": "2014",
            "code": "45.3",
            "name": "Торговля автомобильными деталями, узлами и принадлежностями"
          },
          ...
        ],
        "authorities": {
          "fts_registration": {
            "type": "FEDERAL_TAX_SERVICE",
            "code": "4027",
            "name": "Инспекция Федеральной налоговой службы по Ленинскому округу г. Калуги",
            "address": "248600,г Калуга,пер Воскресенский,28,,,,,,"
          },
          "fts_report": {
            "type": "FEDERAL_TAX_SERVICE",
            "code": "4027",
            "name": "Инспекция Федеральной налоговой службы по Ленинскому округу г. Калуги",
            "address": null
          },
          "pf": {
            "type": "PENSION_FUND",
            "code": "050025",
            "name": "Управление Пенсионного фонда Российской Федерации по г.Калуга",
            "address": null
          },
          "sif": {
            "type": "SOCIAL_INSURANCE_FUND",
            "code": "4000",
            "name": "Государственное учреждение - Калужское региональное отделение Фонда социального страхования Российской Федерации",
            "address": null
          }
        },
        "documents": {
          "fts_registration": {
            "type": "FTS_REGISTRATION",
            "series": "40",
            "number": "001280927",
            "issue_date": 1334880000000,
            "issue_authority": "4028"
          },
          "pf_registration": {
            "type": "PF_REGISTRATION",
            "series": null,
            "number": "050025062068",
            "issue_date": 1342569600000,
            "issue_authority": "050025"
          },
          "sif_registration": {
            "type": "SIF_REGISTRATION",
            "series": null,
            "number": "400049189240001",
            "issue_date": 1342569600000,
            "issue_authority": "4000"
          },
          "smb": {
            "category": "MICRO",
            "type": "SMB",
            "series": null,
            "number": null,
            "issue_date": 1469998800000,
            "issue_authority": null
          }
        },
        "licenses": null,
        "finance": {
          "tax_system": "USN",
          "income": 0,
          "expense": 0,
          "debt": 12400,
          "penalty": null
        },
        "address": {
          "value": "г Калуга, ул Вишневского, д 17, кв 55",
          "unrestricted_value": "248007, Калужская обл, г Калуга, ул Вишневского, д 17, кв 55",
          "data": { ... }
        },
        "phones": null,
        "emails": null,
        "ogrn_date": 1334880000000,
        "okved_type": "2014",
        "employee_count": 0
      }
    }
  ]
}

Название	Описание
Базовые поля, заполняются для всех тарифов
value	Наименование компании
unrestricted_value	= value

data.inn	ИНН
data.kpp	КПП
data.ogrn	ОГРН
data.ogrn_date	Дата выдачи ОГРН
data.hid	Внутренний идентификатор в Дадате
data.type	Тип организации LEGAL — юридическое лицо INDIVIDUAL — индивидуальный предприниматель

data.name	Наименование
└ full_with_opf	— полное наименование
└ short_with_opf	— краткое наименование
└ latin	— не заполняется
└ full	— полное наименование без ОПФ ⚠️ будет удалено в 2021, используйте full_with_opf
└ short	— краткое наименование без ОПФ ⚠️ будет удалено в 2021, используйте short_with_opf

	Коды статистики (только для действующих головных организаций и ИП):
data.okato	Код ОКАТО
data.oktmo	Код ОКТМО
data.okpo	Код ОКПО
data.okogu	Код ОКОГУ
data.okfs	Код ОКФС

data.okved	Код ОКВЭД
data.okved_type	Версия справочника ОКВЭД (2001 или 2014)

data.opf	Организационно-правовая форма
└ code	— код ОКОПФ
└ full	— полное название ОПФ
└ short	— краткое название ОПФ
└ type	— версия справочника ОКОПФ (99, 2012 или 2014)

data.management	Руководитель
└ name	— ФИО руководителя
└ post	— должность руководителя

data.branch_count	Количество филиалов
data.branch_type	Тип подразделения MAIN — головная организация BRANCH — филиал

data.address	Адрес
└ value	— адрес одной строкой: адрес организации для юридических лиц; город проживания для индивидуальных предпринимателей. стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ unrestricted_value	— адрес одной строкой (полный, с индексом) стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ data	— гранулярный адрес
└ data.source	— адрес одной строкой как в ЕГРЮЛ
└ data.qc	— код проверки адреса 0 — адрес распознан уверенно 1 или 3 — требуется ручная проверка

data.state	Состояние
└ actuality_date	— дата актуальности сведений
└ registration_date	— дата регистрации
└ liquidation_date	— дата ликвидации
└ status	— статус организации ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована BANKRUPT — банкротство (февраль 2021) REORGANIZING — в процессе присоединения к другому юрлицу, с последующей ликвидацией
└ code (декабрь 2020)	— детальный статус

Дополнительные поля, заполняются в зависимости от тарифа Заполняются при выборе конкретной подсказки. До этого они пустые.
Тарифы «Расширенный» и «Максимальный»
data.employee_count	Среднесписочная численность работников
data.finance.tax_system	Система налогообложения ENVD — единый налог на вмененный доход (ЕНВД) ESHN — единый сельскохозяйственный налог (ЕСХН) SRP — система налогообложения при выполнении соглашений о разделе продукции (СРП) USN — упрощенная система налогообложения (УСН) ENVD_ESHN — ЕНВД + ЕСХН USN_ENVD — УСН + ЕНВД
data.okved	Код ОКВЭД
data.okveds[ ]	Коды ОКВЭД дополнительных видов деятельности
└ main	— основной или нет (true / false)
└ type	— версия справочника ОКВЭД (2001 или 2014)
└ code	— код по справочнику
└ name	— наименование по справочнику

data.authorities	Сведения о налоговой, ПФР и ФСС
data.authorities.fts_registration	ИФНС регистрации
└ type	— код гос. органа
└ code	— код отделения
└ name	— наименование отделения
└ address	— адрес отделения одной строкой
data.authorities.fts_report	ИФНС отчётности, структура аналогична fts_registration
data.authorities.pf	Отделение Пенсионного фонда, структура аналогична fts_registration
data.authorities.sif	Отделение Фонда соц. страхования, структура аналогична fts_registration

data.citizenship	Гражданство ИП
└ code.numeric	— числовой код страны по ОКСМ
└ code.alpha_3	— трехбуквенный код страны по ОКСМ
└ name.full	— полное наименование страны
└ name.short	— краткое наименование страны

Только «Максимальный»
data.founders[ ]	Учредители компании
└ ogrn	— ОГРН учредителя (для юрлиц)
└ inn	— ИНН учредителя
└ name	— наименование учредителя (для юрлиц)
└ fio	— ФИО учредителя (для физлиц)
└ hid	— внутренний идентификатор
└ type	— тип учредителя (LEGAL / PHYSICAL)
data.founders[ ].share	Доля учредителя
└ type	— тип значения (PERCENT / DECIMAL / FRACTION)
└ value	— значение (для type = PERCENT и type = DECIMAL)
└ numerator	— числитель дроби (для type = FRACTION)
└ denominator	— знаменатель дроби (для type = FRACTION)

data.management.disqualified	Наличие дисквалифицированных лиц в руководстве компании. Возвращает `true` при наличии, иначе `null`.
data.managers[ ]	Руководители компании
└ ogrn	— ОГРН руководителя (для юрлиц)
└ inn	— ИНН руководителя
└ name	— наименование руководителя (для юрлиц)
└ fio	— ФИО руководителя (для физлиц)
└ post	— должность руководителя (для физлиц)
└ hid	— внутренний идентификатор
└ type	— тип руководителя EMPLOYEE — сотрудник FOREIGNER — иностранный гражданин LEGAL — юрлицо

data.predecessors[ ]	Правопредшественники, только для юрлиц
└ ogrn	— ОГРН предшественника
└ inn	— ИНН предшественника
└ name	— наименование предшественника
data.successors[ ]	Правопреемники, только для юрлиц
└ ogrn	— ОГРН преемника
└ inn	— ИНН преемника
└ name	— наименование преемника

data.capital	Уставной капитал компании
└ type	— тип капитала
└ value	— размер капитала
data.finance	Финансовые показатели за год
└ income	— доходы по бух. отчетности
└ expense	— расходы по бух. отчетности
└ debt	— недоимки по налогам
└ penalty	— налоговые штрафы

data.documents	Документы
data.documents.fts_registration	Свидетельство о регистрации в налоговой
└ type	— тип документа (= FTS_REGISTRATION)
└ series	— серия документа
└ number	— номер документа
└ issue_date	— дата выдачи
└ issue_authority	— код подразделения
data.documents.pf_registration	Свидетельство о регистрации в Пенсионном фонде, структура аналогична fts_registration
data.documents.sif_registration	Свидетельство о регистрации в Фонде соц. страхования, структура аналогична fts_registration
data.documents.smb	Запись в реестре малого и среднего предпринимательства
└ type	— тип документа (= SMB)
└ category	— категория предприятия (MICRO, SMALL или MEDIUM)
└ issue_date	— дата регистрации в реестре

data.licenses[ ]	Лицензии
└ series	— серия документа
└ number	— номер документа
└ issue_date	— дата выдачи
└ issue_authority	— название выдавшего органа
└ suspend_date	— дата приостановки
└ suspend_authority	— название приостановившего органа
└ valid_from	— дата начала действия
└ valid_to	— дата окончания действия
└ activities[ ]	— перечень лицензируемых видов деятельности
└ addresses[ ]	— перечень адресов, по которым действует лицензия

Не заполняются
data.phones[ ]	Не заполняется
data.emails[ ]	Не заполняется
data.source	Не заполняется
data.qc	Не заполняется

Источники данных:

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

Ограничения

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

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

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

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

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.