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

} 

Примечания

Некоторые элементы данных в определенных случаях могут отсутствовать
Все даты указаны в формате "YYYY-MM-DD"

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