API подсказок по организациям
Ищет компании и индивидуальных предпринимателей:
Что умеет
✔️ Ищет по комбинации ИНН, названия и адреса в одном запросе («7736050003 Газ» → «ПАО Газпром», «вавилова сбер» → «ПАО Сбербанк»).
✔️ Находит конкретный филиал, если указать в запросе КПП («сбербанк 540602001» → «Сибирский банк ПАО Сбербанк»).
✔️ Понимает слитное и раздельное написание («альфабанк» = «Альфа-Банк»).
✔️ Ищет по частичному совпадению в ИНН / ОГРН («77094209» → «ООО Акварель») и названиях («росне» → «ПАО «НК «Роснефть»).
✔️ Подсказывает только организации или только ИП, или и тех и других. Умеет искать только в действующих или ликвидированных компаниях. Может ограничить подсказки кодом ОКВЭД или конкретным регионом России.
✔️ Учитывает, где вы находитесь (в связке с методом город по IP-адресу).
✔️ Возвращает основные реквизиты компании из ЕГРЮЛ: краткое и полное название, ОПФ, адрес, ОГРН, ИНН, КПП, ОКВЭД, статус организации, ФИО и должность руководителя.
✔️ В связке с методом организация по ИНН возвращает вагон дополнительной информации: количество сотрудников, все коды ОКВЭД, сведения о налоговой, ПФР и ФСС, документы и лицензии, учредители и руководители, финансовые показатели, реестр малого и среднего бизнеса.
❌ Для 50% компаний налоговая служба пока не сообщает КПП филиалов. Такие филиалы можно найти по ИНН, городу и улице филиала. Например, «7724261610 москва мясницкая» → «Филиал ФГУП «Почта России» (г Москва)».
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Укажите при вызове:
Параметры запроса
| Название | Тип | Обяз.? | По умолч. | Описание |
|---|---|---|---|---|
| query | string | ✓ | Текст запроса | |
| count | number | 10 | Количество результатов (максимум — 20) | |
| status | array [string] | Ограничение по статусу организации | ||
| type | string | Ограничение по типу организации | ||
| locations | array [object] | Ограничение по региону или городу | ||
| locations_boost | array [object] | Приоритет города при ранжировании |
Что в ответе
Объект с массивом подсказок в поле suggestions :
Коды ответа на запрос
| HTTP-код ответа | Описание |
|---|---|
| 200 | Запрос успешно обработан |
| 400 | Некорректный запрос (невалидный JSON или XML) |
| 401 | В запросе отсутствует API-ключ |
| 403 | В запросе указан несуществующий API-ключ Или не подтверждена почта Или исчерпан дневной лимит по количеству запросов |
| 405 | Запрос сделан с методом, отличным от POST |
| 413 | Слишком большая длина запроса или слишком много условий |
| 429 | Слишком много запросов в секунду или новых соединений в минуту |
| 5xx | Произошла внутренняя ошибка сервиса |
Примеры вызова
Ограничения
Количество условий в параметрах locations и locations_boost — не более 10.
Длина запроса (параметр query ) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 20 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Частые вопросы
По мере поступления обновлений от налоговой службы. Отставание от сайта налоговой (egrul.nalog.ru) не более 3 дней.
Почему не находится организация? Я точно знаю, она должна быть
Скорее всего, организация недавно зарегистрирована в ФНС, и мы еще не успели получить информацию о ней из налоговой. Отставание Дадаты от сайта налоговой (egrul.nalog.ru) не более 3 дней, так что организация скоро появится.
Подсказки не работают: ошибка 403 Forbidden (Feature SUGGESTIONS disabled for token)
Подсказки перестанут подсказывать ツ До начала нового дня, затем снова заработают.
10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки, емейлы.
Стоимость
Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.
Организация по ИНН или ОГРН
Находит компанию или ИП по ИНН или ОГРН. Возвращает все доступные сведения о компании, в отличие от метода suggest, который возвращает только базовые поля.
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Параметры запроса
| Название | Тип | Обяз.? | По умолч. | Описание |
|---|---|---|---|---|
| query | string | ✓ | ИНН или ОГРН | |
| count | number | 10 | Количество результатов (максимум — 300) | |
| kpp | string | КПП для поиска по филиалам, см. пример | ||
| branch_type | string | Головная организация ( MAIN ) или филиал ( BRANCH ), см. пример | ||
| type | string | Юрлицо ( LEGAL ) или индивидуальный предприниматель ( INDIVIDUAL ), см. пример |
Головные организации и филиалы
Если у компании есть филиалы, запрос вернёт несколько объектов. Если нужна только головная организация, укажите дополнительный параметр branch_type :
Чтобы найти конкретный филиал, укажите дополнительный параметр kpp :
К сожалению, для 50% компаний налоговая служба пока не сообщает КПП филиалов. Такие филиалы с помощью данного метода найти не получится.
Юрлица и индивидуальные предприниматели
Чтобы искать только среди юрлиц, либо только среди индивидуальных предпринимателей, укажите параметр type :
Что в ответе
Примеры вызова
Ограничения
Длина запроса (параметр query ) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 20 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Стоимость
Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.
Api информация по инн
Федеральная налоговая служба. API доступ к базе данных ФНС.
— Проверь себя и контрагента. Доступ к ЕГРЮЛ и ЕГРИП. Сведения о государственной регистрации юридических лиц, индивидуальных предпринимателей, крестьянских (фермерских) хозяйств (получение сведений из ЕГРЮЛ и ЕГРИП в электронном виде)
— Узнать ИНН. Сведения об ИНН физических лиц
— Сведения о действительных ИНН юридических лиц, недействительных свидетельствах ИНН, недействительных ИНН физических и юридических лиц
— Единый реестр субъектов малого и среднего предпринимательства
— Открытые и общедоступные сведения ЕГРН об иностранных организациях
— Поиск сведений в реестре дисквалифицированных лиц
— Система информирования банков о состоянии обработки электронных документов (311-П, 440-П)
— Сведения о физических лицах, являющихся руководителями или учредителями (участниками) нескольких юридических лиц
— Адреса, указанные при государственной регистрации в качестве места нахождения несколькими юридическими лицами
— Сведения о юридических лицах, имеющих задолженность по уплате налогов и/или не представляющих налоговую отчетность более года
— Сведения о юридических лицах и индивидуальных предпринимателях, в отношении которых представлены документы для государственной регистрации
— Запрос о направлении информации о факте представления в налоговый орган документов при государственной регистрации юридического лица или индивидуального предпринимателя
— Сведения о лицах, в отношении которых факт невозможности участия (осуществления руководства) в организации установлен (подтвержден) в судебном порядке
— Юридические лица, в состав исполнительных органов которых входят дисквалифицированные лица
Описание API-ФНС
С помощью сервиса вы сможете автоматизировать заполнение реквизитов компаний, поиска компаний по различным параметрам, проявить должную осмотрительность, отслеживать изменения в параметрах ваших контрагентов.
Для выбора методов и ввода параметров можно использовать единый адрес входа: https://api-fns.ru/api
API состоит из нескольких программных интерфейсов:
| Название метода | Команда | Описание |
|---|---|---|
| Поиск компаний | search | Позволяет получить список компаний, соответствующих указанному запросу |
| Получение данных о компании | egr | Позволяет получить все актуальные и исторические данные из ЕГРЮЛ о юридическом лице (ЮЛ), или из ЕГРИП для индивидуального предпринимателя (ИП) |
| Реквизиты группы компаний | multinfo | Позволяет получить базовые данные сразу о нескольких юридических лиц или индивидуальных предпринимателей |
| Проверка группы компаний | multcheck | Позволяет провести базовую (упрощенную) проверку нескольких юридических лиц или индивидуальных предпринимателей |
| Проверка контрагента (признаки недобросовестности) | check | Позволяет получать информацию о том, попало ли юридическое лицо в различные негативные реестры ФНС, отметки о недостоверных данных, признаки «массового» директора, учредителя, решений о ликвидации, реорганизации и прочие |
| Проверка блокировок счета | nalogbi | Запрос полной информации о действующих решениях ФНС о приостановлении операций по счетам |
| Проверка блокировок счета в виде файла | nalogbi_file | Вывод полной информации о действующих решениях ФНС о приостановлении операций по счетам в виде файла zip с подписью ФНС |
| Отслеживание изменений параметров компании | changes | Позволяет получить те параметры компании, которые изменились, начиная с указанной даты |
| Мониторинг изменений по списку компаний | mon | Формирование списка компаний для мониторинга и отслеживание изменений в ЕГРЮЛ/ЕГРИП по этому списку |
| Выписка из ЕГРЮЛ | vyp | Позволяет получить заверенную выписку ФНС из ЕГРЮЛ или ЕГРИП |
| Бухгалтерская отчетность | bo | Бухгалтерская отчетность организации по данным ФНС |
| Бухгалтерская отчетность в виде файла | bo_file | Бухгалтерская отчетность организации в виде файла zip или pdf, заверенного подписью ФНС |
| Узнать ИНН по паспортным данным | innfl | Возвращает ИНН физического лица на основании введенных паспортных данных |
| Проверка паспорта на недействительность | mvdpass | Проверяет серию и номер паспорта по списку недействительных российских паспортов |
| Статусы физического лица | fl_status | Проверяет статус самозанятого, является ли физическое лицо индивидуальным предпринимателем, банкротство физического лица, недействительность ИНН |
| Лицензии ФСРАР | fsrar | Возвращает информацию о лицензиях по данным ФСРАР |
| Статистика запросов (использования ключа) | stat | Возвращает информацию статистику о количестве использованных и доступных запросов по каждому из методов |
Поиск компаний
Позволяет получить список компаний по указанному запросу.
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| q | string q=Гордиенко Василий | Поисковая строка. Если указать q=any, то будут выведены все организации, соответствующие параметру filter |
| page | integer page=2 | Страница поиска (поиск выдает только первые 100 найденных значений, если их больше используйте page для отображения следующей порции найденных значений) |
Необязательное поле
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий список найденных организаций.
Поля возвращаемого документа:
Примеры запросов.
https://api-fns.ru/api/search?q=Борунов Алексей Владимирович&key=
Данные о компании
Позволяет получить все данные из ЕГРЮЛ или ЕГРИП (включая исторические) о компании.
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req=1026605606620 | ОГРН или ИНН искомой компании (юридического лица или ИП) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию из ЕГРЮЛ (ЕГРИП).
Поля возвращаемого документа:
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
«тильда»)
YYYY-MM-DD (начальная и конечная даты, разделенные знаком
Готовые решения для просмотра информации из ЕГРЮЛ и ЕГРИП
На текущий момент API-ФНС используется в двух наших программных продуктах:
| Продукт | Стоимость | Ссылка |
|---|---|---|
| Excel-файл проверки контрагентов | Бесплатно | Скачать XLS-файл |
| Система проверки контрагентов ДаМИА-СПК | От 10 тыс. руб. в год | Перейти на сайт ДаМИА-СПК |
Excel-файл проверки контрагентов
Для просмотра информации из ЕГРЮЛ и ЕГРИП (из базы данных ФНС и других сервисов) мы разработали специальную рабочую книгу Excel.
Файл можно использовать как для просмотра информации, так и для изучения возможностей API-ФНС, чтобы встраивание в собственные разработки происходило быстрее.
После отрытия книги появляется лист:
Для использования необходимо ввести полученный вами 40-значный ключ к API в листе «Настройки»:
Нажмите кнопку «Поиск» (на листе «Помощь» или в ленте «ДаМИА») для поиска компаний в ЕГРЮЛ или ЕГРИП. Введите искомую строку:
Появится лист с результатами поиска (используется API-метод search):
Далее можно встать на строке с искомой компанией и нажать кнопку «Данные из ЕГРЮЛ и ЕГРИП» (кнопка находится в ленте «ДаМИА»). Можно ввести любой ИНН или ОГРН (по умолчанию выводится ОГРН из таблицы поиска, на строке, в которой вы стоите):
Появится лист с карточкой компании (используется API-метод egr):
Внизу страницы можно увидеть данные о проверке компании (используется API-метод check). Приведем пример для компании с ОГРН 1111837001418:
Система проверки контрагентов ДаМИА-СПК
Мы используем единую систему регистрации с сайтом damia.ru. Если Вы зарегистрированы на нашем сайте, то будете уже зарегистрированы и на сайте damia.ru (или наоборот).
После регистрации есть также возможность бесплатно протестировать систему, подключившись в разделе «Мои тарифы» к тарифу «СПК-старт».
После входа в систему введите поисковую строку (ИНН, ОГРН, название, ФИО директора, учредителя, адрес и др.). Будут отображены результаты поиска, например:
Перейдя на карточку искомой компании, Вы увидите полную информацию о компании, включая исторические данные, например:
В соответствующих разделах Вы увидите информацию об отчетности:
Проверках на позитивные и негативные факторы (факторы риска), как нефинансовые:
Есть хронология изменений данных компании, включая поданные заявления (иногда еще не отображенные в ЕГРЮЛ):
Связи компании (предположительно, аффилированные компании) выявляются по директору, учредителям, адресу. Можно задать не все, а только актуальные связи (действующие директор или учредители), по действующим компаниям, совпадения по ИНН (или ФИО без ИНН), а также компании в том же регионе (для ФИО без ИНН).