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

Что умеет

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

Как вызвать

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

URL:

https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party

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

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

Или:

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

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

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

Однозначно найти конкретный филиал с помощью этого метода не получится, так как у филиалов нет уникальных идентификаторов.

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

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

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

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

{
    "suggestions": [
        {
            "value": "ПАО СБЕРБАНК",
            "unrestricted_value": "ПАО СБЕРБАНК",
            "data": {
                "kpp": "773601001",
                "capital": {
                    "type": "УСТАВНЫЙ КАПИТАЛ",
                    "value": 67760844000
                },
                "management": {
                    "name": "Греф Герман Оскарович",
                    "post": "Президент, председатель правления"
                },
                "founders": [
                    {
                        "ogrn": null,
                        "inn": "7702235133",
                        "name": "ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ",
                        "hid": "33b78a80c782d847d02a7e7a53d3aa17a5dff9a1cb5ec73d0311423dcc065a89",
                        "type": "LEGAL",
                        "share": null
                    }
                ],
                "managers": [
                    {
                        "inn": "770303580308",
                        "fio": {
                            "surname": "Греф",
                            "name": "Герман",
                            "patronymic": "Оскарович",
                            "gender": "MALE",
                            "source": "ГРЕФ ГЕРМАН ОСКАРОВИЧ",
                            "qc": null
                        },
                        "post": "Президент, председатель правления",
                        "hid": "8aca73ef155e20b8ba6687d23521630e8fbe9b505b388cb9cb12eb1c43b68253",
                        "type": "EMPLOYEE"
                    }
                ],
                "branch_type": "MAIN",
                "branch_count": 93,
                "source": null,
                "qc": null,
                "hid": "145a83ab38c9ad95889a7b894ce57a97cf6f6d5f42932a71331ff18606edecc6",
                "type": "LEGAL",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1521590400000,
                    "registration_date": 677376000000,
                    "liquidation_date": null
                },
                "opf": {
                    "type": "2014",
                    "code": "12247",
                    "full": "Публичное акционерное общество",
                    "short": "ПАО"
                },
                "name": {
                    "full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
                    "short_with_opf": "ПАО СБЕРБАНК",
                    "latin": null,
                    "full": "СБЕРБАНК РОССИИ",
                    "short": "СБЕРБАНК"
                },
                "inn": "7707083893",
                "ogrn": "1027700132195",
                "okpo": null,
                "okved": "64.19",
                "okveds": [
                    {
                        "main": true,
                        "type": "2014",
                        "code": "64.19",
                        "name": "Денежное посредничество прочее"
                    }
                ],
                "authorities": {
                    "fts_registration": {
                        "type": "FEDERAL_TAX_SERVICE",
                        "code": "7700",
                        "name": "Управление Федеральной налоговой службы по г.Москве",
                        "address": "125284, г.Москва, Хорошевское ш., 12А"
                    },
                    "fts_report": {
                        "type": "FEDERAL_TAX_SERVICE",
                        "code": "7736",
                        "name": "Инспекция Федеральной налоговой службы № 36 по г.Москве",
                        "address": null
                    },
                    "pf": {
                        "type": "PENSION_FUND",
                        "code": "087705",
                        "name": "Государственное учреждение - Главное Управление Пенсионного фонда РФ №4 Управление №1 по г. Москве и Московской области муниципальный район Гагаринский г.Москвы",
                        "address": null
                    },
                    "sif": {
                        "type": "SOCIAL_INSURANCE_FUND",
                        "code": "7706",
                        "name": "Филиал №6 Государственного учреждения - Московского регионального отделения Фонда социального страхования Российской Федерации",
                        "address": null
                    }
                },
                "documents": {
                    "fts_registration": {
                        "type": "FTS_REGISTRATION",
                        "series": "77",
                        "number": "4856976",
                        "issue_date": 1029456000000,
                        "issue_authority": "7700"
                    },
                    "pf_registration": {
                        "type": "PF_REGISTRATION",
                        "series": null,
                        "number": "087705007215",
                        "issue_date": 1283472000000,
                        "issue_authority": "087705"
                    },
                    "sif_registration": {
                        "type": "SIF_REGISTRATION",
                        "series": null,
                        "number": "770600307277061",
                        "issue_date": 978566400000,
                        "issue_authority": "7706"
                    }
                },
                "licenses": [
                    {
                        "series": null,
                        "number": "045-02894-100000",
                        "issue_date": 975283200000,
                        "issue_authority": "Центральный банк Российской Федерации",
                        "suspend_date": null,
                        "suspend_authority": null,
                        "valid_from": 1444089600000,
                        "valid_to": null,
                        "activities": [
                            "Брокерская деятельность"
                        ],
                        "addresses": [
                            "Г. МОСКВА"
                        ]
                    },
                    ...
                ],
                "address": {
                    "value": "г Москва, ул Вавилова, д 19",
                    "unrestricted_value": "г Москва, Академический р-н, ул Вавилова, д 19",
                    "data": { ... }
                },
                "phones": null,
                "emails": null,
                "ogrn_date": 1029456000000,
                "okved_type": "2014"
            }
        },
        ...
    ]
}

Поля в ответе

Название Описание
Базовые поля, заполняются для всех тарифов
value Наименование компании одной строкой (как показывается в списке подсказок)
unrestricted_value Наименование компании одной строкой (полное)
data.address Адрес
└ value — адрес одной строкой:
  • адрес организации для юридических лиц;
  • город проживания для индивидуальных предпринимателей.
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ unrestricted_value — адрес одной строкой (полный, от региона)
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ data — гранулярный адрес
└ data.source — адрес одной строкой как в ЕГРЮЛ
└ data.qc — код проверки адреса 
  0        — адрес распознан уверенно
  1 или 3  — требуется ручная проверка
data.branch_count Количество филиалов
data.branch_type Тип подразделения 
  MAIN   — головная организация
  BRANCH — филиал
data.inn ИНН
data.kpp КПП
data.ogrn ОГРН
data.ogrn_date Дата выдачи ОГРН
data.hid Уникальный идентификатор в Дадате
data.management Руководитель
└ name — ФИО руководителя
└ post — должность руководителя
data.name Наименование
└ full_with_opf — полное наименование с ОПФ
└ short_with_opf — краткое наименование с ОПФ
└ latin — наименование на латинице (не заполняется)
└ full — полное наименование
└ short — краткое наименование
data.okpo Код ОКПО (не заполняется)
data.okved Код ОКВЭД
data.okved_type Версия справочника ОКВЭД (2001 или 2014)
data.opf Организационно-правовая форма
└ code — код ОКОПФ
└ full — полное название ОПФ
└ short — краткое название ОПФ
└ type — версия справочника ОКВЭД (2001 или 2014)
data.state Состояние
└ actuality_date — дата актуальности сведений
└ registration_date — дата регистрации
└ liquidation_date — дата ликвидации
└ status — статус организации 
  ACTIVE       — действующая
  LIQUIDATING  — ликвидируется
  LIQUIDATED   — ликвидирована
  REORGANIZING — в процессе присоединения к другому юрлицу,
                 с последующей ликвидацией
data.type Тип организации 
  LEGAL      — юридическое лицо
  INDIVIDUAL — индивидуальный предприниматель
Дополнительные поля, заполняются в зависимости от тарифа
Заполняются при выборе конкретной подсказки. До этого они пустые.
Тарифы «Расширенный» и «Всё включено»
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.managers[ ] Руководители компании
└ ogrn — ОГРН руководителя (для юрлиц)
└ inn — ИНН руководителя
└ name — наименование руководителя (для юрлиц)
└ fio — ФИО руководителя (для физлиц)
└ post — должность руководителя (для физлиц)
└ hid — внутренний идентификатор
└ type — тип руководителя 
  EMPLOYEE  — сотрудник
  FOREIGNER — иностранный гражданин
  LEGAL     — юрлицо
data.capital Уставной капитал компании
└ type — тип капитала
└ value — размер капитала
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.licenses[ ] Лицензии
└ series — серия документа
└ number — номер документа
└ issue_date — дата выдачи
└ issue_authority — название выдавшего органа
└ suspend_date — дата приостановки
└ suspend_authority — название приостановившего органа
└ valid_from — дата начала действия
└ valid_to — дата окончания действия
└ activities[ ] — перечень лицензируемых видов деятельности
└ addresses[ ] — перечень адресов, по которым действует лицензия
Не используются
data.founders[ ].share
data.phones[ ]
data.emails[ ]
data.source
data.qc

Стоимость

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

ajax-spinner

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

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

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

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

Уже зарегистрированы? Войти
Забыли пароль?

Укажите свой адрес электронной почты, и мы отправим на него инструкции по восстановлению пароля.