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> 
Размер капитала, руб.
    }, 

    "leaders": [ { 
Лица, имеющие право действовать без доверенности, т. е. в большинстве случаев – руководители
      "name": <STRING>, 
Ф. И. О.
      "inn": <STRING>, 
ИНН
      "post": <STRING>, 
Должность
      "post_type": <STRING>, 
Тип должности
      "untrust": <BOOLEAN>, 
Признак недостоверности сведений
      "untrust_reason": <STRING> 
Причина признания сведений недостоверными
    }, ... ], 

    "founders": { 
Учредители (участники)
      "people": [ { 
Физические лица
        "name": <STRING>, 
Ф. И. О.
        "inn": <STRING>, 
ИНН
        "untrust": <BOOLEAN>, 
Признак недостоверности сведений
        "untrust_reason": <STRING>, 
Причина признания сведений недостоверными
        "share": { 
Доля в уставном капитале
          "nominal_value": <INTEGER>, 
Номинальная стоимость доли, руб.
          "percentage": <FLOAT> 
Размер доли, процент
        } 

      }, ... ] 

      "russian_entities": [ { 
Российские юридические лица
        "ogrn": <STRING>, 
ОГРН
        "inn": <STRING>, 
ИНН
        "full_name": <STRING>, 
Полное наименование
        "untrust": {BOOLEAN}, 
Признак недостоверности сведений
        "untrust_reason": <STRING>, 
Причина признания сведений недостоверными
        "share": { 
Доля в уставном капитале
          "nominal_value": <INTEGER>, 
Номинальная стоимость доли, руб.
          "percentage": <FLOAT> 
Размер доли, процент
        } 

      }, ... ], 

      "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> 
Размер доли, процент
        } 

      }, ... ], 

      "funds": [ { 
Паевые инвестиционные фонды
        "name": <STRING>, 
Наименование ПИФа
        "management_company": { 
Управляющая компания
          "ogrn": <STRING>, 
ОГРН
          "inn": <STRING>, 
ИНН
          "full_name": <STRING> 
Полное наименование
        }, 

        "untrust": {BOOLEAN}, 
Признак недостоверности сведений
        "untrust_reason": <STRING>, 
Причина признания сведений недостоверными
        "share": { 
Доля в уставном капитале
          "nominal_value": <INTEGER>, 
Номинальная стоимость доли, руб.
          "percentage": <FLOAT> 
Размер доли, процент
        } 

      }, ... ], 

      "state": [ { 
Российская Федерация, субъекты РФ и муниципальные образования
        "type": <STRING>, 
Тип учредителя, принимает значения РОССИЙСКАЯ ФЕДЕРАЦИЯ
, СУБЪЕКТ РФ
 или МУНИЦИПАЛЬНОЕ ОБРАЗОВАНИЕ
        "region_code": <STRING>, 
Код региона
        "region_name": <STRING>, 
Наименование региона
        "entity_exercising_rights": { 
Орган или юридическое лицо, осуществляющее права учредителя
          "ogrn": <STRING>, 
ОГРН
          "inn": <STRING>, 
ИНН
          "full_name": <STRING> 
Полное наименование
        }, 

        "person_exercising_rights": { 
Физическое лицо, осуществляющее права учредителя
          "name": <STRING>, 
Ф. И. О.
          "inn": <STRING> 
ИНН
        }, 

        "untrust": {BOOLEAN}, 
Признак недостоверности сведений
        "untrust_reason": <STRING>, 
Причина признания сведений недостоверными
        "share": { 
Доля в уставном капитале
          "nominal_value": <INTEGER>, 
Номинальная стоимость доли, руб.
          "percentage": <FLOAT> 
Размер доли, процент
        } 

      }, ... ] 

    }, 

    "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> 
Полное наименование
    }, ... ] 

  }, 

  "meta": { 
Информация о результате запроса
    "status": <STRING>, 
Статус ответа, принимает значения ok
 или error
    "message": <STRING>, 
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
    "today_request_count": <INTEGER> 
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
  } 

} 

Примечания

Некоторые элементы данных в определенных случаях могут отсутствовать, например, объект
liquidation
не указывается для всех действующих организаций
Все даты указаны в формате "YYYY-MM-DD"

Формат ответа при запросе оригинальных данных

При добавлении в запрос параметра source=primary вы получите ответ, содержащий оригинальный немодифицированный набор данных из ЕГРЮЛ. Эти данные являются точной копией XML-данных, поставляемых ФНС, конвертированных в формат JSON. Для удобства, названия ключей переведены в нижний регистр.

Вы можете скачать официальную документацию, описывающую структуру исходных XML-данных по следующим ссылкам

Если у вас есть идеи по улучшению API или какие-либо вопросы — пишите нам на [email protected] или оставьте сообщение через форму обратной связи. Мы постоянно совершенствуем наши сервисы и с удовольствием рассмотрим все ваши предложения.