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


Примечания



Формат ответа при запросе оригинальных данных

При добавлении в запрос параметра source=primary вы получите ответ, содержащий оригинальный немодифицированный набор данных из ЕГРИП. Эти данные являются точной копией XML-данных, поставляемых ФНС, конвертированных в формат JSON. Для удобства, названия ключей переведены в нижний регистр.

Вы можете скачать официальную документацию, описывающую структуру исходных XML-данных по следующим ссылкам



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