API – Юридические лица
Подробная информация о российских организациях (юридических лицах), содержащаяся в справочнике ЕГРЮЛ и других базах данных от Федеральной Налоговой Службы.
Формат запроса
Используются GET- или POST-запросы следующего вида
https://api.ofdata.ru/alpha/json
?object=ent
&key={ваш API-ключ}
&ogrn={ОГРН организации}
&inn={ИНН организации}
&kpp={КПП организации}
&source=primary
Параметр запроса | Описание |
---|---|
object |
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение ent . |
key |
Обязательный параметр, ваш API-ключ. Получается автоматически после регистрации. |
ogrn |
Рекомендуемый параметр, ОГРН организации, 13 цифр. Служит уникальным идентификатором для всех организаций. |
inn |
Если вы не указали ОГРН, вы можете указать ИНН организации. В случае определения нескольких юридических лиц с указанным ИНН (такое бывает, например, если у организации есть филиалы), будет возвращена информация по головной организации. |
kpp |
Если вы указали ИНН организации, вы можете указать и ее КПП. Связка ИНН + КПП является уникальной и позволяет точно определить организацию. |
source |
При применении параметра source=primary вы получите ответ, содержащий оригинальный немодифицированный набор данных из ЕГРЮЛ. Подробнее об этом формате читайте ниже. |
Формат ответа
{
"data": {
Основная информация ответа
"type": "ОРГАНИЗАЦИЯ",
Тип результата, принимает значения
ОРГАНИЗАЦИЯ
или ИП
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"kpp": <STRING>,
КПП
"reg_date": <STRING>,
Дата регистрации организации
"report_date": <STRING>,
Дата последнего изменения записи об организации в ЕГРЮЛ
"status": {
Особое состояние (статус) юридического лица
"code": <STRING>,
Код статуса по справочнику СЮЛСТ
"reason": <STRING>
Причина применения статуса
},
"liquidation": {
Ликвидация юридического лица
"date": <STRING>,
Дата ликвидации
"reason": <STRING>
Причина ликвидации
},
"name": <STRING>,
Сокращенное наименование
"full_name": <STRING>,
Полное наименование
"location": {
Месторасположение организации
"region_code": <STRING>,
Код региона
"locality": <STRING>,
Локация
"legal_address": <STRING>,
Юридический адрес
"legal_address_untrust": <BOOLEAN>,
Признак недостоверности сведений о юридическом адресе
"legal_address_untrust_reason": <STRING>,
Причина признания сведений о юридическом адресе недостоверными
"kladr_code": <STRING>
Код КЛАДР
},
"okved": {
Основной вид экономической деятельности
"code": <STRING>,
Код ОКВЭД
"name": <STRING>,
Наименование вида деятельности согласно ОКВЭД
"version": <STRING>"
Версия справочника ОКВЭД, принимает значения
2001
или 2014
},
"okved_extra": [ {
Дополнительные виды экономической деятельности
"code": <STRING>,
Код ОКВЭД
"name": <STRING>,
Наименование вида деятельности согласно ОКВЭД
"version": <STRING>"
Версия справочника ОКВЭД
}, ... ],
"opf": {
Организационно-правовая форма
"code": <STRING>",
Код ОПФ
"name": <STRING>",
Наименование ОПФ
"directory": {
Используемый справочник
"name": <STRING>",
Наименование справочника, принимает значения
КОПФ
или ОКОПФ
"version": <STRING>"
Версия справочника ОКОПФ, принимает значения
99
или 2012
}
},
"tax_service": {
Постановка на учет в налоговом органе
"ogrn_date": <STRING>,
Дата присвоения ОГРН
"code": <STRING>,
Код налогового органа
"name": <STRING>,
Наименование налогового органа
"address": <STRING>
Адрес налогового органа
},
"state_funds": {
Регистрация во внебюджетных фондах
"pfr": {
ПФР
"reg_date": <STRING>,
Дата регистрации
"reg_number": <STRING>,
Регистрационный номер
"code": <STRING>,
Код территориального органа ПФР
"name": <STRING>
Наименование территориального органа ПФР
},
"fss": {
ФСС
"reg_date": <STRING>,
Дата регистрации
"reg_number": <STRING>,
Регистрационный номер
"code": <STRING>,
Код территориального органа ФСС
"name": <STRING>
Наименование территориального органа ФСС
}
},
"capital": {
Уставный капитал
"type": <STRING>,
Тип капитала, принимает значения
УСТАВНЫЙ КАПИТАЛ
, СКЛАДОЧНЫЙ КАПИТАЛ
, УСТАВНЫЙ ФОНД
, ПАЕВЫЕ ВЗНОСЫ
или ПАЕВОЙ ФОНД
"amount": <INTEGER>
Размер капитала, руб.
},
"management_entity": {
Управляющая организация
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>,
Полное наименование
"foreign_entity_country": <STRING>,
Страна, в том случае, если управляющая организация является иностранной
"foreign_entity_address": <STRING>,
Адрес, в том случае, если управляющая организация является иностранной
"foreign_entity_reg_number": <STRING>,
Регистрационный номер, в том случае, если управляющая организация является иностранной
"foreign_entity_reg_date": <STRING>,
Дата регистрации, в том случае, если управляющая организация является иностранной
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
},
"leaders": [ {
Лица, имеющие право действовать без доверенности, т. е. в большинстве случаев – руководители
"name": <STRING>,
Ф. И. О.
"inn": <STRING>,
ИНН
"post": <STRING>,
Должность
"post_type": <STRING>,
Тип должности
"untrust": <BOOLEAN>,
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
}, ... ],
"founders": {
Учредители (участники)
"people": [ {
Физические лица
"name": <STRING>,
Ф. И. О.
"inn": <STRING>,
ИНН
"untrust": <BOOLEAN>,
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
},
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
}, ... ]
"russian_entities": [ {
Российские юридические лица
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>,
Полное наименование
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
},
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
}, ... ],
"foreign_entities": [ {
Иностранные юридические лица
"full_name": <STRING>,
Полное наименование
"country": <STRING>,
Страна
"address": <STRING>,
Адрес
"reg_number": <STRING>,
Регистрационный номер
"reg_date": <STRING>,
Дата регистрации
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
},
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
}, ... ],
"funds": [ {
Паевые инвестиционные фонды
"name": <STRING>,
Наименование ПИФа
"management_entity": {
Управляющая компания
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>,
Полное наименование
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
},
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
},
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
}, ... ],
"state": [ {
Российская Федерация, субъекты РФ и муниципальные образования
"type": <STRING>,
Тип учредителя, принимает значения
РОССИЙСКАЯ ФЕДЕРАЦИЯ
, СУБЪЕКТ РФ
или МУНИЦИПАЛЬНОЕ ОБРАЗОВАНИЕ
"region_code": <STRING>,
Код региона
"region_name": <STRING>,
Наименование региона
"municipality_name": <STRING>,
Наименование муниципального образования
"entity_exercising_rights": {
Орган или юридическое лицо, осуществляющее права учредителя
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>,
Полное наименование
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
},
"person_exercising_rights": {
Физическое лицо, осуществляющее права учредителя
"name": <STRING>,
Ф. И. О.
"inn": <STRING>,
ИНН
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
},
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
},
"record_date": <STRING>
Дата внесения записи в ЕГРЮЛ
}, ... ]
},
"shareholders_register_holder": {
Держатель реестра акционеров
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>,
Полное наименование
},
"licenses": [ {
Полученные лицензии
"number": <STRING>,
Номер лицензии
"issue_date": <STRING>,
Дата выдачи
"licensing_entity": <STRING>,
Орган, выдавший лицензию
"activities": [ <STRING>, ... ],
Виды лицензируемой деятельности
"locations": [ <STRING>, ... ],
Адреса мест осуществления лицензируемой деятельности
"date_start": <STRING>,
Дата начала действия лицензии
"date_finish": <STRING>
Дата окончания действия лицензии
}, ... ],
"subdivisions": {
Подразделения организации
"branches": [ {
Филиалы
"full_name": <STRING>,
Полное наименование
"kpp": <STRING>,
КПП
"address": <STRING>,
Российский адрес
"country": <STRING>,
Страна
"foreign_address": <STRING>
Иностранный адрес
}, ... ],
"representatives": [ {
Представительства организации
"full_name": <STRING>,
Полное наименование
"kpp": <STRING>,
КПП
"address": <STRING>,
Российский адрес
"country": <STRING>,
Страна
"foreign_address": <STRING>
Иностранный адрес
}, ... ]
},
"predecessors": [ {
Правопредшественники
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>
Полное наименование
}, ... ],
"successors": [ {
Правопреемники
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>
Полное наименование
}, ... ],
"managed_entities": [ {
Юридические лица, находящиеся под управлением данной организации
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"kpp": <STRING>,
КПП
"okpo_code": <STRING>,
Код ОКПО
"name": <STRING>,
Сокращенное наименование
"full_name": <STRING>,
Полное наименование
"region_code": <STRING>,
Код региона
"legal_address": <STRING>,
Юридический адрес
"ogrn_date": <STRING>,
Дата присвоения ОГРН
"liquidation_date": <STRING>,
Дата ликвидации юридического лица
}, ... ],
"founded_entities": [ {
Юридические лица, учрежденные данной организацией
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"kpp": <STRING>,
КПП
"okpo_code": <STRING>,
Код ОКПО
"name": <STRING>,
Сокращенное наименование
"full_name": <STRING>,
Полное наименование
"region_code": <STRING>,
Код региона
"legal_address": <STRING>,
Юридический адрес
"ogrn_date": <STRING>,
Дата присвоения ОГРН
"liquidation_date": <STRING>,
Дата ликвидации юридического лица
}, ... ]
},
"meta": {
Информация о результате запроса
"status": <STRING>,
Статус ответа, принимает значения
ok
или error
"message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
"today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
}
}
Примечания
- Некоторые элементы данных в определенных случаях могут отсутствовать, например, объект liquidationне указывается для всех действующих организаций
- Все даты указаны в формате "YYYY-MM-DD"
Формат ответа при запросе оригинальных данных
При добавлении в запрос параметра source=primary вы получите ответ, содержащий оригинальный немодифицированный набор данных из ЕГРЮЛ. Эти данные являются точной копией XML-данных, поставляемых ФНС, конвертированных в формат JSON. Для удобства, названия ключей переведены в нижний регистр.
Вы можете скачать официальную документацию, описывающую структуру исходных XML-данных по следующим ссылкам
Если у вас есть идеи по улучшению API или какие-либо вопросы — пишите нам на [email protected] или оставьте сообщение через форму обратной связи. Мы постоянно совершенствуем наши сервисы и с удовольствием рассмотрим все ваши предложения.