API – Проверки

Проверки — или контрольно-надзорные мероприятия — в отношении организаций и индивидуальных предпринмателей по данным ФГИС "Единый реестр проверок" Генеральной прокуратуры РФ.




Формат запроса

Используются GET- или POST-запросы следующего вида

https://api.ofdata.ru/alpha/json
  ?object=ins
  &key={ваш API-ключ}
  &ogrn={ОГРН/ОГРНИП организации или ИП}
  &inn={ИНН организации}
  &kpp={КПП организации}
  &limit={лимит записей}
  &offset={смещение}
  &sort={сортировка}


Параметр запроса Описание
object
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение
ins
.
key
Обязательный параметр, ваш API-ключ. Получается автоматически после регистрации.
ogrn
Рекомендуемый параметр, ОГРН организации или ОГРНИП индивидуального предпринимателя. Служит уникальным идентификатором для всех организаций и ИП.
inn
Если вы не указали ОГРН или ОГРНИП, вы можете указать ИНН организации или индивидуального предпринимателя. В случае определения нескольких юридческих лиц или ИП с указанным ИНН, будет возвращена информация по наиболее актуальному совпадению.
kpp
Если вы указали ИНН организации, вы можете указать и ее КПП. Связка ИНН + КПП является уникальной и позволяет точно определить организацию.
limit
Ограничение количества записей о проверках в ответе, необязательный параметр. Значение по умолчанию:
100
, максимальное значение параметра:
100
.
offset
Смещение выборки записей о проверках в ответе, необязательный параметр. Обычно используется совместно с параметром
limit
. Значение по умолчанию:
0
.
sort
Указывает, как должна осуществляться сортировка записей о проверках в ответе, необязательный параметр. По умолчанию, записи сортируются по ключу
date_start
по возрастанию. Чтобы отсортировать записи по убыванию, укажите
sort=-date_start
.



Формат ответа

{
  "data": {
Основная информация ответа
    "inspections": [ {
Проверки
      "number": <STRING>,
Учетный номер проверки
      "is_completed": <BOOLEAN>,
Признак завершенности проверки
      "chedule_type": <STRING>,
Тип проверки
      "carry_out_type": <STRING>,
Форма проведения проверки
      "risk_type": <STRING>,
Категория риска
      "date_start": <STRING>,
Дата начала проверки
      "date_finish": <STRING>,
Дата окончания проверки
      "subject":{
Субъект проверки
        "ogrn": <STRING>,
ОГРН или ОГРНИП
        "inn": <STRING>,
ИНН
        "name": <STRING>
Наименование организации или Ф. И. О. индивидуального предпринимателя
      },
      "purpose": <STRING>,
Цель проверки
      "reason": <STRING>,
Правовое основание проведения проверки
      "reason_date": <STRING>,
Дата, характеризующая один из вариантов основания проведения проверки как основание проведения
      "authority": {
Орган контроля (надзора) из Федерального реестра государственных и муниципальных услуг (ФРГУ), проводящий проверку
        "ogrn": <STRING>
ОГРН
        "name": <STRING>,
Наименование органа контроля (надзора)
        "function": <STRING>
Наименование контрольно-надзорной функции из Федерального реестра государственных и муниципальных услуг
      },
      "inspectors": [ {
Должностные лица, уполномоченные на проведение проверки
        "name": <STRING>,
Ф. И. О. должностного лица
        "position": <STRING>,
Должность должностного лица
        "type": <STRING>
Тип должностного лица
      }, ... ],
      "objects": [ {
Объекты проверки
        "address": <STRING>,
Адрес объекта проверки
        "result": {
Результат проведения проверки
          "act_date": <STRING>,
Дата составления акта о проведении проверки
          "representative": {
Руководитель или уполномоченный представитель организации или ИП, присутствовавший при проведении проверки
            "name": <STRING>,
Ф. И. О.
            "position": <STRING>
Должность
          },
          "info": [ {
Информация о результатах проведения проверки
            "type": <STRING>,
Тип информации
            "text": <STRING>
Содержание
          }, ... ]
          "violations": [ {
Нарушения, связанные с результатами проверки
            "text": <STRING>,
Сведения о выявленных нарушениях
            "lawsuits": [ {
Судебные сведения о выявленных нарушениях
              "type": <STRING>,
Тип сведений
              "text": <STRING>
Содержание
            }, ... ],
            "injunctions": [ {
Сведения о выданных предписаниях об устранении выявленных нарушений
              "code": <STRING>,
Реквизиты предписания
              "text": <STRING>,
Содержание предписания
              "deadline_date": <STRING>
Срок выполнения предписания
            }, ... ]
          }, ... ]
        }
      }, ... ]
    }, ... ],
    "entity": {
Организация, определенная по ОГРН или ИНН
      "ogrn": <STRING>,
ОГРН
      "inn": <STRING>,
ИНН
      "kpp": <STRING>,
КПП
      "name": <STRING>,
Сокращенное наименование
      "full_name": <STRING>,
Полное наименование
      "region_code": <STRING>,
Код региона
      "legal_address": <STRING>,
Юридический адрес
      "ogrn_date": <STRING>,
Дата присвоения ОГРН
      "liquidation_date": <STRING>
Дата ликвидации юридического лица
    },
    "entrepreneur": {
Индивидуальный предприниматель, определенный по ОГРНИП или ИНН
      "ogrn": <STRING>,
ОГРНИП
      "inn": <STRING>,
ИНН
      "name": <STRING>,
Ф. И. О.
      "business_type": <STRING>,
Вид индивидуального предпринимателя
      "region_code": <STRING>,
Код региона
      "ogrn_date": <STRING>,
Дата присвоения ОГРНИП
      "liquidation_date": <STRING>
Дата прекращения деятельности
    }
  },
  "meta": {
Информация о результате запроса
    "status": <STRING>,
Статус ответа, принимает значения
ok
или
error
    "message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
    "today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
  }
}


Примечания


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