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