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] или оставьте сообщение через форму обратной связи. Мы постоянно совершенствуем наши сервисы и с удовольствием рассмотрим все ваши предложения.