Помогает человеку быстро ввести реквизиты организации на веб-форме или в приложении.

Ищет компании и индивидуальных предпринимателей:

  • по ИНН, ОГРН и КПП;
  • названию (полному и краткому);
  • ФИО (для индивидуальных предпринимателей);
  • ФИО руководителя компании;
  • адресу до улицы (с ограничениями).

Что умеет:

✔️ Ищет по комбинации ИНН, названия и адреса в одном запросе («7736050003 Газ» → «ПАО Газпром», «вавилова сбер» → «ПАО Сбербанк»).

✔️ Находит конкретный филиал, если указать в запросе КПП («сбербанк 540602001» → «Сибирский банк ПАО Сбербанк»).

✔️ Понимает слитное и раздельное написание («альфабанк» = «Альфа-Банк»).

✔️ Ищет по частичному совпадению в ИНН / ОГРН («77094209» → «ООО Акварель») и названиях («росне» → «ПАО «НК «Роснефть»).

✔️ Подсказывает только организации или только ИП, или и тех и других. Умеет искать только в действующих или ликвидированных компаниях. Может ограничить подсказки конкретным регионом России.

✔️ Учитывает, где вы находитесь (в связке с методом город по IP-адресу).

✔️ Возвращает основные реквизиты компании из ЕГРЮЛ: краткое и полное название, ОПФ, адрес, ОГРН, ИНН, КПП, ОКВЭД, статус организации, ФИО и должность руководителя.

✔️ В связке с методом организация по ИНН возвращает вагон дополнительной информации: количество сотрудников, все коды ОКВЭД, сведения о налоговой, ПФР и ФСС, документы и лицензии, учредители и руководители, финансовые показатели, реестр малого и среднего бизнеса.

❌ Налоговая сообщает КПП для 75% филиалов. Остальные филиалы можно найти по ИНН, городу и улице филиала. Например, «7724261610 москва мясницкая» → «Филиал ФГУП "Почта России" (г Москва)».

Запрос

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "Сбербанк" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/party

Заголовки

ЗаголовокОписание

Content-Type

Тип данных в запросе: application/json или application/xml

Accept

Тип данных в ответе: application/json или application/xml

Authorization

API-ключ в формате: Token ВАШ_КЛЮЧ

Только для пользователей подсказок DaData.ru

Параметры

ПараметрОбязательный?Описание
queryдаЗапрос, для которого нужно получить подсказки.
Можно искать по:
  • названию компании (либо ФИО для ИП);
  • ИНН;
  • КПП (с версии 19.4);
  • ОГРН;
  • адресу до улицы;
  • ФИО руководителей компании (с версии 19.10) 
count
нет
Количество возвращаемых подсказок (по умолчанию — 10, максимум — 20).
status
нетОграничение по статусу организации
type
нетОграничение по типу организации
locations
нет

Ограничение по региону

locations_boost
нетПриоритет города при ранжировании

Ответ

Возвращается список объектов организации:

ПолеТип данныхОписание
valuestring(1000)Краткое наименование организации (data.name.short_with_opf). Если краткое наименование не указано — полное наименование (data.name.full_with_opf)
unrestricted_valuestring(1000)= value

data.address


Адрес
└ valuestring(1000)

— адрес одной строкой:

  • адрес организации для юридических лиц;
  • город проживания для индивидуальных предпринимателей.

стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ

└ unrestricted_value

string(1000)

— адрес одной строкой (полный, от региона)
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ

└ data

— гранулярный адрес

└ data.source

string(1000)

— исходный адрес одной строкой как в ЕГРЮЛ

└ data.qcstring(10)

— код качества адреса (19.1+)

  • 0 – Адрес распознан уверенно
  • 1 – Остались «лишние» части. 
  • 3 – Есть альтернативные варианты.
data.branch_countunsignedShortКоличество филиалов
data.branch_typestring(50)

Тип подразделения

  • MAIN — головная организация
  • BRANCH — филиал

data.fio

└ surname

└ name

└ patronymic

└ gender

└ source

└ qc


string(100)

string(100)

string(100)

Имя ИП ( 21.3+)

— фамилия

— имя 

— отчество

не заполняется 

не заполняется 

не заполняется 

data.innstring(20)ИНН
data.kppstring(10)КПП
data.ogrnstring(20)ОГРН
Для представительств иностранных компаний — номер записи об аккредитаци
data.ogrn_datelongДата выдачи ОГРН
data.hidstring(100)Внутренний идентификатор

data.management

└ name

└ post

└ disqualified


string(200)

string(500)

boolean

Руководитель

— ФИО руководителя

— должность руководителя

— true, если в состав руководства входят дисквалифицированные лица (19.7+)

data.name

└ full_with_opf

└ short_with_opf

└ full


└ short
 

└ latin


string(1000)

string(1000)

string(1000)

string(1000)

Наименование

— полное наименование

— краткое наименование

— полное наименование без ОПФ
генерируется на основе full_with_opf, может содержать ошибки

— краткое наименование без ОПФ
генерируется на основе short_with_opf, может содержать ошибки

— не заполняется

data.okatostring(20)Код ОКАТО (20.9+)
data.oktmostring(20)Код ОКТМО (20.9+)
data.okpostring(10)Код ОКПО
data.okogustring(10)Код ОКОГУ (20.9+)
data.okfsstring(10)Код ОКФС (20.9+)

data.finance

└ tax_system

└ income

└ expense


└ debt

└ penalty

└ year


string(50)

decimal

decimal


decimal

decimal

int

Финансовая информация (19.7+)

— Система налогообложения организации

— доходы по данным бухгалтерской отчетности (за позапрошлый год, если не заполнено year)

— расходы по данным бухгалтерской отчетности (за позапрошлый год, если не заполнено year)

— задолженность по налоговым платежам за позапрошлый год

— наложенные штрафы за позапрошлый год

— год финансовой отчетности (21.3+)

data.okvedstring(10)Код ОКВЭД
data.okved_typestring(10)

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

data.opf

└ code

└ full

└ short

└ type


string(10)

string(1000)

string(1000)

string(10)

Организационно-правовая форма

— код ОКОПФ

— полное название ОПФ

— краткое название ОПФ

— версия справочника ОКОПФ

data.state

└ actuality_date

└ registration_date

└ liquidation_date

└ code

└ status


long

long

long

string(10)

string(50)

Состояние

— дата актуальности сведений

— дата регистрации

— дата ликвидации

— детальный статус (c декабря 2020)

— статус организации

ACTIVE        действующая
LIQUIDATING   ликвидируется
LIQUIDATED    ликвидирована
REORGANIZING  в процессе присоединения к другому юрлицу,
              с последующей ликвидацией
BANKRUPT      банкрот (с февраля 2021)
data.typestring(50)

Тип организации

LEGAL       юридическое лицо
INDIVIDUAL  индивидуальный предприниматель
data.employee_countintКоличество сотрудников (19.7+)
Дополнительные поля, заполняются в зависимости от тарифа «Дадаты» *
Заполняются при выборе конкретной подсказки в jQuery плагине или через метод API  findById . До этого они пустые.
Тарифы «Расширенный» и «Максимальный»

data.okveds[ ]

└ main

└ type

└ code

└ name


boolean

string(10)

string(10)

string(1000)

Коды ОКВЭД дополнительных видов деятельности

— основной или нет (true / false)

— версия справочника ОКВЭД (2001 или 2014)

— код по справочнику

— наименование по справочнику

data.authorities


Сведения о налоговой, ПФР и ФСС

data.authorities.fts_registration

└ type

└ code

└ name

└ address


string(50)

string(20)

string(500)

string(500)

ИФНС регистрации

— код гос. органа

— код отделения

— наименование отделения

— адрес отделения одной строкой

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


unsignedShort

string(10)

string(1000)

string(1000)

Гражданство ИП

— числовой код страны по ОКСМ

— трехбуквенный код страны по ОКСМ

— полное наименование страны

— краткое наименование страны

Тариф «Максимальный»
data.address.invalidityobject— недостоверность сведений об адресе

data.founders[ ]

└ ogrn

└ inn

└ name

└ fio

└ hid

└ type

└ invalidity


string(20)

string(20)

string(1000)

object

string(100)

string(50)

object

Учредители компании

— ОГРН учредителя (для юрлиц)

— ИНН учредителя

— наименование учредителя (для юрлиц)

— ФИО учредителя (для физлиц)

— внутренний идентификатор

— тип учредителя (LEGAL / PHYSICAL)

— недостоверность сведений об учредителе

data.founders[ ].share

└ type

└ value

└ numerator

└ denominator


string(50)

decimal

long

long

Доля учредителя (справочники от 05.06.2020 и новее):

— тип значения (PERCENT / DECIMAL / FRACTION)

— значение (для type = PERCENT и type = DECIMAL)

— числитель дроби (для type = FRACTION)

— знаменатель дроби (для type = FRACTION)

типы:

PERCENT   процент (46)
DECIMAL   десятичная дробь (3.14)
FRACTION  обычная дробь (3/4)

data.managers[ ]

└ ogrn

└ inn

└ name

└ fio

└ post

└ hid

└ type

└ invalidity


string(20)

string(20)

string(1000)

object

string(500)

string(100)

string(50)

object

Руководители компании

— ОГРН руководителя (для юрлиц)

— ИНН руководителя

— наименование руководителя (для юрлиц)

— ФИО руководителя (для физлиц)

— должность руководителя (для физлиц)

— внутренний идентификатор

— тип руководителя

— недостоверность сведений о руководителе

типы:

EMPLOYEE   сотрудник
FOREIGNER  иностранный гражданин
LEGAL      юрлицо

data.predecessors[]

└ ogrn

└ inn

└ name


string(20)

string(20)

string(1000)

Правопредшественники, только для юрлиц (20.10+)

— ОГРН предшественника

— ИНН предшественники

— наименование предшественника

data.successors[]

└ ogrn

└ inn

└ name


string(20)

string(20)

string(1000)

Правопреемники, только для юрлиц (20.10+)

— ОГРН преемника

— ИНН преемника

— наименование преемника

data.capital

└ type

└ value


string(50)

decimal

Уставной капитал компании

— тип капитала

— размер капитала



Документы

data.documents.fts_registration

└ type

└ series

└ number

└ issue_date

└ issue_authority


string(50)

string(20)

string(20)

long

string(500)

Свидетельство о регистрации в налоговой

— тип документа (= FTS_REGISTRATION)

— серия документа

— номер документа

— дата выдачи

— код подразделения

data.documents.fts_report
Сведения об учете в налоговом органе, структура аналогична fts_registration (21.7+)

data.documents.pf_registration


Свидетельство о регистрации в Пенсионном фонде, структура аналогична fts_registration

data.documents.sif_registration


Свидетельство о регистрации в Фонде соц. страхования, структура аналогична fts_registration

data.documents.smb

└ type

└ category

└ issue_date


string(50)

string(50)

long

Запись в реестре малого и среднего предпринимательства (19.6+)

— тип документа (= SMB)

— категория (MICRO, SMALL, MEDIUM)

— дата включения организации в реестр

категории: 

MICRO   микро-предприятие
SMALL   малое предприятие
MEDIUM  среднее предприятие

data.licenses[ ]

└ series

└ number

└ issue_date

└ issue_authority

└ suspend_date

└ suspend_authority

└ valid_from

└ valid_to

└ activities[ ]

└ addresses[ ]


string(100)

string(100)

long

string(1000)

long

string(1000)

long

long

string[](1000)

string[](1000)

Лицензии

— серия документа

— номер документа

— дата выдачи

— название выдавшего органа

— дата приостановки

— название приостановившего органа

— дата начала действия

— дата окончания действия

— перечень лицензируемых видов деятельности

— перечень адресов, по которым действует лицензия

data.phones[ ]

└ value

└ unrestricted_value


string(1000)

string(1000)

Телефоны

— телефон одной строкой

— телефон одной строкой

data.phones[ ]. data.contact

└ type

└ name


string(50)

string(1000)

Контактное лицо

— тип

— имя

типы:

MANAGING_PARTY     управляющая организация
TRUSTED_EMPLOYEE   сотрудник
TRUSTED_FOREIGNER  иностранный гражданин

data.phones[ ]. data

└ source

└ type

└ number 

└ extension

└ provider

└ country

└ region

└ city

└ timezone

└ country_code

└ city_code

└ qc_conflict

└ qc


string(250)

string(50)

string(10)

string(10)

string(100)

string(50)

string(100)

string(100)

string(50)

string(10)

string(10)

Гранулярные поля телефона

— телефон, указанный в ЕГРЮЛ

— тип телефона

— локальный номер телефона

— добавочный номер 

— оператор связи (только для России) 

— страна

— регион (только для России) 

— город (только для стационарных телефонов)

— часовой пояс города для России, часовой пояс страны — для иностранных телефонов 

— код страны  

— код города  

не заполняется 

не заполняется

типы телефонов:

Мобильный         +7 911 243-45-68
Стационарный      +7 495 456-55-77
Прямой мобильный  +7 495 243-45-68
Колл-центр        8 800 222-12-22
Неизвестный       +7 333 1111112

data.emails[ ]

└ value

└ unrestricted_value


string(1000)

string(1000)

Адреса эл. почты

—  адрес эл. почты одной строкой

—  адрес эл. почты одной строкой

data.emails[ ].data

└ local

└ domain

└ source

└ type

└ qc


string(100)

string(100)

string(250)

Гранулярные поля  эл. почты

— именная часть

— доменная часть

— адрес эл. почты , указанный в ЕГРЮЛ

не заполняется 

не заполняется 

data.invalidbooleanНедостоверность сведений о компании
Не используются
data.source

data.qc

* Для «коробки» возвращаются все дополнительные поля.

Недостоверные сведения об организации

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

data.founders[ ].invalidity
data.managers[ ].invalidity
data.address[ ].invalidity

Поле invalidity — это объект с такими свойствами:

ПолеТип данныхОписание
codestring(50)

код причины недостоверности

  PARTY  — обращение лица или организации
  FTS    — проверка налоговой
  COURT  — решение суда
  OTHER  — прочие причины

decision

└ court_name

└ number

└ date

object

string(100)

string(255)

long

решение суда (только для code = COURT)

— наименование суда

— номер судебного решения

— дата судебного решения

Если хотя бы один учредитель, руководитель или адрес организации признан недостоверным, «Подсказки» вернут для организации в целом маркер data.invalid = true. Если недостоверных данных нет — будет data.invalid = null.

Формат даты

Даты регистрации и ликвидации — количество миллисекунд от 01.01.1970. Хранится в UTC.

Для JavaScript преобразуется в дату так:

var ticks = 989784000000;
var date = new Date(ticks);

Для PHP:

$ticks = 989784000000;
$sec = $ticks / 1000;
echo date("d.m.Y", $sec);

Для Java:

long ticks = 989784000000;
Calendar cal = Calendar.getInstance();
cal.setTimeInMillis(ticks);

Для C#:

long ticks = 989784000000;
DateTime date = (new DateTime(1970, 1, 1)).AddMilliseconds(ticks);

Примеры

Поиск по названию компании

Запрос (JSON):

{
  "query": "Сбербанк" 
}
"suggestions": [
        {
            "value": "ПАО СБЕРБАНК",
            "unrestricted_value": "ПАО СБЕРБАНК",
            "data": {
                "kpp": "775001001",
                "management": {
                    "name": "Греф Герман Оскарович",
                    "post": "Президент-председатель правления"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12247",
                    "full": "Публичное акционерное общество",
                    "short": "ПАО"
                },
                "name": {
                    "full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
                    "short_with_opf": "ПАО СБЕРБАНК",
                    "latin": null,
                    "full": "СБЕРБАНК РОССИИ",
                    "short": "СБЕРБАНК"
                },
                "inn": "7707083893",
                "ogrn": "1027700132195",
                "okpo": null,
                "okved": null,
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1443312000000,
                    "registration_date": 677376000000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Москва, ул Вавилова, д 19",
                    "unrestricted_value": "г Москва, ул Вавилова, д 19",
                    "data": {
						...
                    }
                }
            }
        ]

Запрос (XML):

<req>
  <query>Сбербанк</query>
</req>
<SuggestResponse>
    <suggestions>
        <value>ПАО СБЕРБАНК</value>
        <unrestricted_value>ПАО СБЕРБАНК</unrestricted_value>
        <data>
            <kpp>775001001</kpp>
            <management>
                <name>Греф Герман Оскарович</name>
                <post>Президент-председатель правления</post>
            </management>
            <branch_type>MAIN</branch_type>
            <branch_count>1</branch_count>
            <type>LEGAL</type>
            <opf>
                <code>12247</code>
                <full>Публичное акционерное общество</full>
                <short>ПАО</short>
            </opf>
            <name>
                <full_with_opf>ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"</full_with_opf>
                <short_with_opf>ПАО СБЕРБАНК</short_with_opf>
                <latin/>
                <full>СБЕРБАНК РОССИИ</full>
                <short>СБЕРБАНК</short>
            </name>
            <inn>7707083893</inn>
            <ogrn>1027700132195</ogrn>
            <okpo/>
            <okved/>
            <state>
                <status>ACTIVE</status>
                <actuality_date>1443312000000</actuality_date>
                <registration_date>677376000000</registration_date>
                <liquidation_date/>
            </state>
            <address>
                <value>г Москва, ул Вавилова, д 19</value>
                <unrestricted_value>г Москва, ул Вавилова, д 19</unrestricted_value>
                <data>
				...
                </data>
            </address>
        </data>
    </suggestions>
</SuggestResponse>

По ИНН

Запрос:

{
  "query": "2222808138" 
}
{
    "suggestions": [
        {
            "value": "ООО \"РОМАШКА\"",
            "unrestricted_value": "ООО \"РОМАШКА\"",
            "data": {
                "kpp": "222201001",
                "management": {
                    "name": "Миронов Вячеслав Леонидович",
                    "post": "Директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12300",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",
                    "short_with_opf": "ООО \"РОМАШКА\"",
                    "latin": null,
                    "full": "РОМАШКА",
                    "short": "РОМАШКА"
                },
                "inn": "2222808138",
                "ogrn": "1122223013120",
                "okpo": null,
                "okved": "52.3",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1440806400000,
                    "registration_date": 1350950400000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "data": {
					...
                    }
                }
            }
        }
    ]
}

По ФИО руководителя

Запрос:

{
  "query": "Коварский Станислав Альбертович" 
}
{
    "suggestions": [
        {
            "value": "ООО \"ВЕГА\"",
            "unrestricted_value": "ООО \"ВЕГА\"",
            "data": {
                "kpp": "781401001",
                "management": {
                    "name": "Коварский Станислав Альбертович",
                    "post": "Генеральный директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12300",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВЕГА\"",
                    "short_with_opf": "ООО \"ВЕГА\"",
                    "latin": null,
                    "full": "ВЕГА",
                    "short": "ВЕГА"
                },
                "inn": "7814255120",
                "ogrn": "1157847228307",
                "okpo": null,
                "okved": "52.50.1",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1440806400000,
                    "registration_date": 1435795200000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н",
                    "unrestricted_value": "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н",
                    "data": {
					...
                    }
                }
            }
        }
  • No labels