API – Индивидуальные предприниматели
Подробная информация об индивидуальных предпринимателях, зарегистрированных в Российской Федерации, содержащаяся в справочнике ЕГРИП и других базах данных от Федеральной Налоговой Службы.
Формат запроса
Используются GET- или POST-запросы следующего вида
https://api.ofdata.ru/alpha/json
?object=ent
&key={ваш API-ключ}
&ogrn={ОГРНИП предпринимателя}
&inn={ИНН предпринимателя}
&source=primary
Параметр запроса | Описание |
---|---|
object |
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение ent . |
key |
Обязательный параметр, ваш API-ключ. Получается автоматически после регистрации. |
ogrn |
Рекомендуемый параметр, ОГРНИП индивидуального предпринимателя, 15 цифр. Служит уникальным идентификатором для всех ИП. |
inn |
Если вы не указали ОГРНИП, вы можете указать ИНН индивидуального предпринимателя. В случае определения нескольких ИП с указанным ИНН (такое часто бывает, когда физлицо прекращает предпринимательскую деятельность, а потом регистрируется как ИП еще раз), будет возвращена информация по последней актуальной записи. |
source |
При применении параметра source=primary вы получите ответ, содержащий оригинальный немодифицированный набор данных из ЕГРИП. Подробнее об этом формате читайте ниже. |
Формат ответа
{
"data": {
Основная информация ответа
"type": "ИП",
Тип результата, принимает значения
ОРГАНИЗАЦИЯ
или ИП
"ogrn": <STRING>,
ОГРНИП
"inn": <STRING>,
ИНН
"reg_date": <STRING>,
Дата регистрации индивидуального предпринимателя
"report_date": <STRING>,
Дата последнего изменения записи об индивидуальном предпринимателе в ЕГРЮЛ
"status": {
Особое состояние (статус) индивидуального предпринимателя
"code": <STRING>,
Код статуса по справочнику СИПСТ
"reason": <STRING>
Причина применения статуса
},
"liquidation": {
Прекращение деятельности индивидуального предпринимателя
"date": <STRING>,
Дата прекращения деятельности
"reason": <STRING>
Причина прекращения деятельности
},
"name": <STRING>,
Ф. И. О. индивидуального предпринимателя
"business_type": <STRING>,
Наименование вида индивидуального предпринимателя
"business_type_lite": <STRING>,
Сокращеное наименование вида индивидуального предпринимателя
"gender": <STRING>,
Пол индивидуального предпринимателя, принимает значения
М
или Ж
"location": {
Место регистрации индивидуального предпринимателя
"region_code": <STRING>,
Код региона
"locality": <STRING>
Локация
},
"okved": {
Основной вид экономической деятельности
"code": <STRING>,
Код ОКВЭД
"name": <STRING>,
Наименование вида деятельности согласно ОКВЭД
"version": <STRING>"
Версия справочника ОКВЭД, принимает значения
2001
или 2014
},
"okved_extra": [ {
Дополнительные виды экономической деятельности
"code": <STRING>,
Код ОКВЭД
"name": <STRING>,
Наименование вида деятельности согласно ОКВЭД
"version": <STRING>"
Версия справочника ОКВЭД
}, ... ],
"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>
Наименование территориального органа ФСС
}
},
"licenses": [ {
Полученные лицензии
"number": <STRING>,
Номер лицензии
"issue_date": <STRING>,
Дата выдачи
"licensing_entity": <STRING>,
Орган, выдавший лицензию
"activities": [ <STRING>, ... ],
Виды лицензируемой деятельности
"locations": [ <STRING>, ... ],
Адреса мест осуществления лицензируемой деятельности
"date_start": <STRING>,
Дата начала действия лицензии
"date_finish": <STRING>
Дата окончания действия лицензии
}, ... ]
},
"meta": {
Информация о результате запроса
"status": <STRING>,
Статус ответа, принимает значения
ok
или error
"message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
"today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
}
}
Примечания
- Некоторые элементы данных в определенных случаях могут отсутствовать, например, объект liquidationне указывается для всех действующих предпринимателей
- Все даты указаны в формате "YYYY-MM-DD"
Формат ответа при запросе оригинальных данных
При добавлении в запрос параметра source=primary вы получите ответ, содержащий оригинальный немодифицированный набор данных из ЕГРИП. Эти данные являются точной копией XML-данных, поставляемых ФНС, конвертированных в формат JSON. Для удобства, названия ключей переведены в нижний регистр.
Вы можете скачать официальную документацию, описывающую структуру исходных XML-данных по следующим ссылкам
Если у вас есть идеи по улучшению API или какие-либо вопросы — пишите нам на [email protected] или оставьте сообщение через форму обратной связи. Мы постоянно совершенствуем наши сервисы и с удовольствием рассмотрим все ваши предложения.