API – Связи юридических лиц

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




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

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

https://api.ofdata.ru/alpha/json
  ?object=cnn
  &key={ваш API-ключ}
  &ogrn={ОГРН организации}
  &inn={ИНН организации}
  &kpp={КПП организации}


Параметр запроса Описание
object
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение
cnn
.
key
Обязательный параметр, ваш API-ключ. Получается автоматически после регистрации.
ogrn
Рекомендуемый параметр, ОГРН организации, 13 цифр. Служит уникальным идентификатором для всех организаций.
inn
Если вы не указали ОГРН, вы можете указать ИНН организации. В случае определения нескольких юридических лиц с указанным ИНН (такое бывает, например, если у организации есть филиалы), будет возвращена информация по головной организации.
kpp
Если вы указали ИНН организации, вы можете указать и ее КПП. Связка ИНН + КПП является уникальной и позволяет точно определить организацию.



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

{
  "data": {
Основная информация ответа
    "entity": {
Организация, определенная по ОГРН или ИНН
      "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>
Дата ликвидации юридического лица
    },
    "connections": {
Данные о связях с другими юридическими лицами
      "with_founders": [ {
Связи через учредителей
        "entity_ogrn": <STRING>,
ОГРН учредителя, через которого найдена связь, указывается, если учредитель — юридическое лицо
        "person_inn": <STRING>,
ИНН учредителя, через которого найдена связь, указывается, если учредитель — физическое лицо
        "connected_entity": {
Связанное юридическое лицо
          "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>,
Дата ликвидации юридического лица
          "is_founder_organization": <BOOLEAN>,
Признак того, что у юридических лиц есть общий учредитель (юридическое лицо)
          "is_founder_person": <BOOLEAN>,
Признак того, что у юридических лиц есть общий учредитель (физическое лицо)
          "is_founder_fund_management_entity": <BOOLEAN>,
Признак того, что у юридических лиц есть общая управляющая организация ПИФа-учредителя
          "is_founder_state_entity_exercising_rights": <BOOLEAN>,
Признак того, что у юридических лиц есть общее юридическое лицо, осуществляющее права учредителя
          "is_founder_state_person_exercising_rights": <BOOLEAN>,
Признак того, что у юридических лиц есть общее физическое лицо, осуществляющее права учредителя
          "is_leader": <BOOLEAN>,
Признак того, что у юридических лиц есть общий руководитель
          "is_managed_by_the_same_entity": <BOOLEAN>
Признак того, что юридические лица управляются одной организацией
        }
      }, ... ],
      "with_leaders": [ {
Связи через руководителей
        "person_inn": <STRING>,
ИНН руководителя, через которого найдена связь
        "connected_entity": {
Связанное юридическое лицо
          "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>,
Дата ликвидации юридического лица
          "is_founder_person": <BOOLEAN>,
Признак того, что у юридических лиц есть общий учредитель (физическое лицо)
          "is_founder_state_person_exercising_rights": <BOOLEAN>,
Признак того, что у юридических лиц есть общее физическое лицо, осуществляющее права учредителя
          "is_leader": <BOOLEAN>
Признак того, что у юридических лиц есть общий руководитель
        }
      }, ... ],
      "with_management_entity": [ {
Связи через управляющую организацию
        "entity_ogrn": <STRING>,
ОГРН управляющей организации, через которую найдена связь
        "connected_entity": {
Связанное юридическое лицо
          "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>,
Дата ликвидации юридического лица
          "is_founder_organization": <BOOLEAN>,
Признак того, что у юридических лиц есть общий учредитель (юридическое лицо)
          "is_founder_fund_management_entity": <BOOLEAN>,
Признак того, что у юридических лиц есть общая управляющая организация ПИФа-учредителя
          "is_founder_state_entity_exercising_rights": <BOOLEAN>,
Признак того, что у юридических лиц есть общее юридическое лицо, осуществляющее права учредителя
          "is_managed_by_the_same_entity": <BOOLEAN>
Признак того, что юридические лица управляются одной организацией
        }
      }, ... ]
    }
  },
  "meta": {
Информация о результате запроса
    "status": <STRING>,
Статус ответа, принимает значения
ok
или
error
    "message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
    "today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
  }
}


Примечания


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