API – Связи физических лиц

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




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

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

https://api.ofdata.ru/alpha/json
  ?object=inv
  &key={ваш API-ключ}
  &inn={ИНН физлица}


Параметр запроса Описание
object
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение
inv
.
key
Обязательный параметр, ваш API-ключ. Получается автоматически после регистрации.
inn
Обязательный параметр, ИНН проверяемого физического лица, 12 цифр.



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

{
  "data": {
Основная информация ответа
    "entities": [ {
Организации, в состав учредителей или руководителей которых входит проверяемое физическое лицо
      "ogrn": <STRING>,
ОГРН
      "inn": <STRING>,
ИНН
      "kpp": <STRING>,
КПП
      "name": <STRING>,
Сокращенное наименование
      "full_name": <STRING>,
Полное наименование
      "region_code": <STRING>,
Код региона
      "legal_address": <STRING>,
Юридический адрес
      "ogrn_date": <STRING>,
Дата присвоения ОГРН
      "liquidation_date": <STRING>,
Дата ликвидации юридического лица
      "is_founder": <BOOLEAN>,
Признак того, что физлицо является учредителем этой организации
      "founder_name": <STRING>,
Ф. И. О. физлица как учредителя
      "is_leader": <BOOLEAN>,
Признак того, что физлицо является руководителем этой организации
      "leader_name": <STRING>
Ф. И. О. физлица как руководителя
    }, ... ]
  },
  "meta": {
Информация о результате запроса
    "status": <STRING>,
Статус ответа, принимает значения
ok
или
error
    "message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
    "today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
  }
}


Примечания


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