Данные юридических лиц и ИП

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

Формат запроса

Используются POST- или GET-запросы следующего вида

https://business.ofdata.ru/entity?key=API-ключ&параметры запроса

Параметр запроса	Описание
db	Обязательный параметр Наименование запрашиваемой базы данных (реестра), может принимать значения "EGRUL" или "EGRIP".
version	Обязательный параметр Версия реестра ЕГРЮЛ или ЕГРИП. На текущий момент доступны следующие версии: 4.06 (рекомендуемая версия) и 4.07 для ЕГРЮЛ, 4.05 (рекомендуемая версия) и 4.06 для ЕГРИП.
ogrn	Обязательный параметр ОГРН юридического лица или ОГРНИП предпринимателя. В одном запросе вы можете указать до 100 номеров ОГРН или ОГРНИП, номера должны быть разделены запятой. В случае использования POST-запросов — вы можете передать массив строк.

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

https://business.ofdata.ru/entity?key=API-ключ&db=EGRUL&version=4.06&ogrn=1027700198767

https://business.ofdata.ru/entity?key=API-ключ&db=EGRUL&version=4.06&ogrn=1046206002149,1047855060978,1050201496718,1052457058807,1053701126632

https://business.ofdata.ru/entity?key=API-ключ&db=EGRIP&version=4.05&ogrn=310402910200035

Документация ФНС по формату данных

Структура XML-файлов ЕГРЮЛ версии 4.06 и версии 4.07
Структура XML-файлов ЕГРИП версии 4.05 и версии 4.06
XSD-схемы последней версии

Примечания

Вы можете использовать как защищенное https:// SSL-соединение, так и незащищенное http:// соединение. Например, если при интеграции с 1С вы получаете "Ошибка инициализации SSL-соединения", воспользуйтесь незащищенным соединением через 80-й порт.
Рекомендуемая версия реестра ЕГРЮЛ в 2023 году: 4.06. В настоящее время ФНС переходит на версию 4.07, с 2024 года станет возможно полноценное использование этой новой версии.
Рекомендуемая версия реестра ЕГРИП в 2023 году: 4.05. В настоящее время ФНС переходит на версию 4.06, с 2024 года станет возможно полноценное использование этой новой версии.

Формат ответа

{  data: [ { 
Массив данных, основная информация ответа
data: {
      ... 
Данные юридического лица или ИП
    }, 

      update_info: { 
Информация о выгрузке данных ФНС, из которой были получены данные
      БД: <STRING>, 
База данных (реестр), к которому производился запрос
      Версия: <STRING>, 
Версия ЕГРЮЛ или ЕГРИП
      ДатаЗаписи: <STRING>, 
Дата обновления записи
      ДатаВыгрузки: <STRING>, 
Дата выгрузки, в которой содержится файл с записью
      Файл: <STRING>, 
Имя файла, в котором содержится запись
      ФайлMD5: <STRING> 
MD5-хэш файла, в котором содержится запись

    }
  }, ... ], 

  meta: { 
Информация о результате запроса
    status: <STRING>, 
Статус ответа, принимает значения "OK", "NOT FOUND" или "ERROR"
    message: <STRING> 
Сообщение, поясняющее результат запроса, отсутствует в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
  } 
}