API – Организация
Подробная информация о юридическом лице по ОГРН или ИНН. Проверка на вхождение в реестр недобросовестных поставщиков, наличие связей с дисквалифицированными лицами, массовыми учредителями или руководителями.
Формат запроса
Используются GET-запросы следующего вида
https://api.checko.ru/json?object=organization
&key={ваш API-ключ}
&ogrn={ОГРН организации}
&inn={ИНН организации}
&kpp={КПП организации}
&source=true
| Параметр запроса | Описание |
|---|---|
object |
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение organization . |
key |
Обязательный параметр, ваш API-ключ. Вы получаете его автоматически после регистрации. |
ogrn |
Рекомендуемый параметр, ОГРН организации, 13 цифр. Служит уникальным идентификатором для всех организаций. |
inn |
Если вы не указали ОГРН, вы можете указать ИНН организации. В случае определения нескольких юридических лиц с указанным ИНН — такое бывает, например, если у организации есть филиалы — будет возвращена информация по головной организации. |
kpp |
Если вы указали ИНН организации, вы можете указать и ее КПП. Связка ИНН + КПП является уникальной и позволяет точно определить организацию. |
source |
При применении параметра source=true вы получите ответ с добавлением исходного набора данных из ЕГРЮЛ. Подробнее об этом наборе данных читайте ниже. |
Формат ответа
{
"data": {
Основная информация ответа
"type": "ОРГАНИЗАЦИЯ",
Тип результата, принимает значения
ОРГАНИЗАЦИЯ
или ИП
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"kpp": <STRING>,
КПП
"okpo": <STRING>,
ОКПО
"reg_date": <STRING>,
Дата регистрации организации
"report_date": <STRING>,
Дата последнего изменения записи об организации в ЕГРЮЛ
"status": {
Особое состояние (статус) юридического лица
"code": <STRING>,
Код статуса по справочнику СЮЛСТ
"reason": <STRING>
Причина применения статуса
},
"liquidation": {
Ликвидация юридического лица
"date": <STRING>,
Дата ликвидации
"reason": <STRING>
Причина ликвидации
},
"name": <STRING>,
Сокращенное наименование
"full_name": <STRING>,
Полное наименование
"location": {
Месторасположение организации
"region_code": <STRING>,
Код региона
"locality": <STRING>,
Локация
"legal_address": <STRING>,
Юридический адрес
"legal_address_untrust": <BOOLEAN>,
Признак недостоверности сведений о юридическом адресе
"legal_address_untrust_reason": <STRING>,
Причина признания сведений о юридическом адресе недостоверными
"kladr_code": <STRING>
Код КЛАДР
},
"okved": {
Основной вид экономической деятельности
"code": <STRING>,
Код ОКВЭД
"name": <STRING>,
Наименование вида деятельности согласно ОКВЭД
"version": <STRING>"
Версия справочника ОКВЭД, принимает значения
2001
или 2014
},
"okved_extra": [ {
Дополнительные виды экономической деятельности
"code": <STRING>,
Код ОКВЭД
"name": <STRING>,
Наименование вида деятельности согласно ОКВЭД
"version": <STRING>"
Версия справочника ОКВЭД
}, ... ],
"opf": {
Организационно-правовая форма
"code": <STRING>",
Код ОПФ
"name": <STRING>",
Наименование ОПФ
"directory": {
Используемый справочник
"name": <STRING>",
Наименование справочника, принимает значения
КОПФ
или ОКОПФ
"version": <STRING>"
Версия справочника ОКОПФ, принимает значения
99
или 2012
}
},
"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>
Наименование территориального органа ФСС
}
},
"capital": {
Уставный капитал
"type": <STRING>,
Тип капитала, принимает значения
УСТАВНЫЙ КАПИТАЛ
, СКЛАДОЧНЫЙ КАПИТАЛ
, УСТАВНЫЙ ФОНД
, ПАЕВЫЕ ВЗНОСЫ
или ПАЕВОЙ ФОНД
"amount": <INTEGER>
Размер капитала, руб.
},
"management_organization": {
Управляющая организация
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>,
Полное наименование
"foreign_organization_country": <STRING>,
Страна, в том случае, если управляющая организация является иностранной
"foreign_organization_address": <STRING>,
Адрес, в том случае, если управляющая организация является иностранной
"foreign_organization_reg_number": <STRING>,
Регистрационный номер, в том случае, если управляющая организация является иностранной
"foreign_organization_reg_date": <STRING>,
Дата регистрации, в том случае, если управляющая организация является иностранной
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>
Причина признания сведений недостоверными
},
"managed_organizations": [ {
Юридические лица, находящиеся под управлением данной организации
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"kpp": <STRING>,
КПП
"okpo_code": <STRING>,
Код ОКПО
"name": <STRING>,
Сокращенное наименование
"full_name": <STRING>,
Полное наименование
"region_code": <STRING>,
Код региона
"legal_address": <STRING>,
Юридический адрес
"ogrn_date": <STRING>,
Дата присвоения ОГРН
"liquidation_date": <STRING>,
Дата ликвидации юридического лица
}, ... ],
"leaders": [ {
Лица, имеющие право действовать без доверенности, т. е. в большинстве случаев – руководители
"name": <STRING>,
Ф. И. О.
"inn": <STRING>,
ИНН
"post": <STRING>,
Должность
"post_type": <STRING>,
Тип должности
"untrust": <BOOLEAN>,
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"is_mass_leader": <BOOLEAN>
Признак вхождения в списки массовых руководителей
}, ... ],
"founders": {
Учредители (участники)
"people": [ {
Физические лица
"name": <STRING>,
Ф. И. О.
"inn": <STRING>,
ИНН
"untrust": <BOOLEAN>,
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"is_mass_founder": <BOOLEAN>,
Признак вхождения в списки массовых учредителей
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
}
}, ... ]
"russian_organizations": [ {
Российские юридические лица
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>,
Полное наименование
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
}
}, ... ],
"foreign_organizations": [ {
Иностранные юридические лица
"full_name": <STRING>,
Полное наименование
"country": <STRING>,
Страна
"address": <STRING>,
Адрес
"reg_number": <STRING>,
Регистрационный номер
"reg_date": <STRING>,
Дата регистрации
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
}
}, ... ],
"funds": [ {
Паевые инвестиционные фонды
"name": <STRING>,
Наименование ПИФа
"management_company": {
Управляющая компания
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>
Полное наименование
},
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
}
}, ... ],
"state": [ {
Российская Федерация, субъекты РФ и муниципальные образования
"type": <STRING>,
Тип учредителя, принимает значения
РОССИЙСКАЯ ФЕДЕРАЦИЯ
, СУБЪЕКТ РФ
или МУНИЦИПАЛЬНОЕ ОБРАЗОВАНИЕ
"region_code": <STRING>,
Код региона
"region_name": <STRING>,
Наименование региона
"organization_exercising_rights": {
Орган или юридическое лицо, осуществляющее права учредителя
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>
Полное наименование
},
"person_exercising_rights": {
Физическое лицо, осуществляющее права учредителя
"name": <STRING>,
Ф. И. О.
"inn": <STRING>
ИНН
},
"untrust": {BOOLEAN},
Признак недостоверности сведений
"untrust_reason": <STRING>,
Причина признания сведений недостоверными
"share": {
Доля в уставном капитале
"nominal_value": <INTEGER>,
Номинальная стоимость доли, руб.
"percentage": <FLOAT>
Размер доли, процент
}
}, ... ]
},
"founded_organizations": [ {
Юридические лица, учрежденные данной организацией
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"kpp": <STRING>,
КПП
"okpo_code": <STRING>,
Код ОКПО
"name": <STRING>,
Сокращенное наименование
"full_name": <STRING>,
Полное наименование
"region_code": <STRING>,
Код региона
"legal_address": <STRING>,
Юридический адрес
"ogrn_date": <STRING>,
Дата присвоения ОГРН
"liquidation_date": <STRING>,
Дата ликвидации юридического лица
}, ... ],
"shareholders_register_holder": {
Держатель реестра акционеров
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>,
Полное наименование
},
"licenses": [ {
Полученные лицензии
"number": <STRING>,
Номер лицензии
"issue_date": <STRING>,
Дата выдачи
"licensing_organization": <STRING>,
Орган, выдавший лицензию
"activities": [ <STRING>, ... ],
Виды лицензируемой деятельности
"locations": [ <STRING>, ... ],
Адреса мест осуществления лицензируемой деятельности
"date_start": <STRING>,
Дата начала действия лицензии
"date_finish": <STRING>
Дата окончания действия лицензии
}, ... ],
"subdivisions": {
Подразделения организации
"branches": [ {
Филиалы
"full_name": <STRING>,
Полное наименование
"kpp": <STRING>,
КПП
"address": <STRING>,
Российский адрес
"country": <STRING>,
Страна
"foreign_address": <STRING>
Иностранный адрес
}, ... ],
"representatives": [ {
Представительства организации
"full_name": <STRING>,
Полное наименование
"kpp": <STRING>,
КПП
"address": <STRING>,
Российский адрес
"country": <STRING>,
Страна
"foreign_address": <STRING>
Иностранный адрес
}, ... ]
},
"predecessors": [ {
Правопредшественники
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>
Полное наименование
}, ... ],
"successors": [ {
Правопреемники
"ogrn": <STRING>,
ОГРН
"inn": <STRING>,
ИНН
"full_name": <STRING>
Полное наименование
}, ... ],
"is_unfair_supplier": <BOOLEAN>,
Признак вхождения в реестр недобросовестных поставщиков
"unfair_supplier_reasons": [ {
Записи реестра недобросовестных поставщиков
"registry_number": <STRING>,
Реестровый номер
"publish_date": <STRING>,
Дата публикации
"approve_date": <STRING>,
Дата утверждения
"customer_name": <STRING>,
Наименование заказчика
"customer_inn": <STRING>,
ИНН заказчика
"customer_кпп": <STRING>,
КПП заказчика
"purchase_number": <STRING>,
Номер закупки
"purchase_description": <STRING>,
Описание закупки
"contract_price": <INTEGER>
Цена контракта, руб.
}, ... ],
"has_disqualified_people": <BOOLEAN>,
Признак присутствия дисквалифицированных лиц в составе исполнительных органов
"has_mass_founders": <BOOLEAN>,
Признак присутствия массовых учредителей
"has_mass_leaders": <BOOLEAN>
Признак присутствия массовых руководителей
},
"source_data": {
Исходные данные ЕГРЮЛ
},
"meta": {
Информация о результате запроса
"status": <STRING>,
Статус ответа, принимает значения
ok
или error
"message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
"today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
}
}
Формат ответа при запросе исходных данных
При добавлении в запрос параметра source=true вы получите ответ с добавлением исходного набора данных из ЕГРЮЛ. Эти данные являются точной копией XML-данных, поставляемых ФНС, конвертированных в формат JSON. Для удобства, названия ключей переведены в нижний регистр.
Вы можете скачать официальную документацию, описывающую структуру исходных XML-данных по следующим ссылкам