Данные юридических лиц и ИП
Получение данных юридических лиц и ИП по номеру ОГРН или ОГРНИП. Основной метод получения данных из Единого государственного реестра юридических лиц и Единого государственного реестра индивидуальных предпринимателей.
Формат запроса
Используются 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.07&ogrn=1027700198767
https://business.ofdata.ru/entity?key=API-ключ&db=EGRUL&version=4.07&ogrn=1046206002149,1047855060978,1050201496718,1052457058807,1053701126632
https://business.ofdata.ru/entity?key=API-ключ&db=EGRIP&version=4.06&ogrn=310402910200035
Документация ФНС по формату данных
- Структура XML-файлов ЕГРЮЛ версии 4.06 и версии 4.07
- Структура XML-файлов ЕГРИП версии 4.05 и версии 4.06
- XSD-схемы последней версии
Примечания
- Вы можете использовать как защищенное https:// SSL-соединение, так и незащищенное http:// соединение. Например, если при интеграции с 1С вы получаете "Ошибка инициализации SSL-соединения", воспользуйтесь незащищенным соединением через 80-й порт.
- Рекомендуемая версия реестра ЕГРЮЛ в 2024–2025 годах: 4.07. В настоящее время ФНС уже перешла на версию 4.07, с 2025 года использование предыдущей версии станет невозможным.
- Рекомендуемая версия реестра ЕГРИП в 2024–2025 годах: 4.06. В настоящее время ФНС уже перешла на версию 4.06, с 2025 года использование предыдущей версии станет невозможным.
Формат ответа
{
data: {
}
}
data: [ {
Массив данных, основная информация ответа
...
Данные юридического лица или ИП
},
update_info: {
Информация о выгрузке данных ФНС, из которой были получены данные
БД: <STRING>,
База данных (реестр), к которому производился запрос
Версия: <STRING>,
Версия ЕГРЮЛ или ЕГРИП
ДатаЗаписи: <STRING>,
Дата обновления записи
ДатаВыгрузки: <STRING>,
Дата выгрузки, в которой содержится файл с записью
Файл: <STRING>,
Имя файла, в котором содержится запись
ФайлMD5: <STRING>
MD5-хэш файла, в котором содержится запись
}, ... ],
meta: {
Информация о результате запроса
status: <STRING>,
Статус ответа, принимает значения "OK", "NOT FOUND" или "ERROR"
message: <STRING>
Сообщение, поясняющее результат запроса, отсутствует в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
}