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-ключом за сегодняшний день
  }
}


Примечания



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

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

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



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