API – Проверки
Подробная информация по проверкам — контрольно-надзорным мероприятиям — в отношении организаций и индивидуальных предпринимателей. На основании данных ФГИС "Единый реестр проверок" Генеральной прокуратуры РФ.
Формат запроса
Используются GET-запросы следующего вида
https://api.checko.ru/json?object=inspections
&key={ваш API-ключ}
&ogrn={ОГРН/ОГРНИП организации или ИП}
&inn={ИНН организации или ИП}
&kpp={КПП организации}
&limit={лимит записей}
&offset={смещение}
&sort={сортировка}
Параметр запроса | Описание |
---|---|
object |
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение inspections . |
ogrn |
Рекомендуемый параметр, ОГРН организации или ОГРНИП индивидуального предпринимателя. Служит уникальным идентификатором для всех организаций и ИП. |
inn |
Если вы не указали ОГРН или ОГРНИП, вы можете указать ИНН организации или индивидуального предпринимателя. В случае определения нескольких юридических лиц или ИП с указанным ИНН, будет возвращена информация по наиболее актуальному совпадению. |
kpp |
Если вы указали ИНН организации, вы можете указать и ее КПП. Связка ИНН + КПП является уникальной и позволяет точно определить организацию. |
limit |
Ограничение количества записей о проверках в ответе, необязательный параметр. Значение по умолчанию: 100 , максимальное значение параметра: 100 . |
offset |
Смещение выборки записей о проверках в ответе, необязательный параметр. Обычно используется совместно с параметром limit . Значение по умолчанию: 0 . |
sort |
Указывает, как должна осуществляться сортировка записей о проверках в ответе, необязательный параметр. По умолчанию, записи сортируются по ключу start_date по возрастанию. Чтобы отсортировать записи по убыванию, укажите sort=-start_date . |
Формат ответа
{
"data": {
Основная информация ответа
"inspections": [ {
Проверки
"number": <STRING>,
Учетный номер проверки
"is_completed": <BOOLEAN>,
Признак завершенности проверки
"chedule_type": <STRING>,
Тип проверки
"carry_out_type": <STRING>,
Форма проведения проверки
"risk_type": <STRING>,
Категория риска
"start_date": <STRING>,
Дата начала проверки
"end_date": <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>
Срок выполнения предписания
}, ... ]
}, ... ]
}
}, ... ]
}, ... ],
"organization": {
Организация, определенная по ОГРН или ИНН
"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-ключом за сегодняшний день
}
}