HTTPS GET запрос: https://api-cloud.ru/api/pb_nalog.phpОбязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS. Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
type Обязательно |
Описание | Параметры в запросе Обязательно |
---|---|---|
В одном запросе возможно отправить только 1 тип | ||
search_ip | Поиск по Индивидуальным предпринимателям
🔑 ОГРНИП 🔑 ИНН 🔑 Основной ОКВЭД 🔑 ФИО 🔑 Дата регистрации 🔑 Статус регистрации 🔑 Участие в ЭДО |
Обязательные inn - ИНН ИП Разрешено: цифры (12 символов) token - персональный ключ API |
search_org | Поиск по Юридическим организациям
🔑 ОГРН 🔑 ИНН 🔑 КПП 🔑 Полное наименование 🔑 Сокращенное наименование 🔑 Регион 🔑 Адрес организации 🔑 Дата регистрации 🔑 Название налогового органа произведившего регистрацию 🔑 Статус регистрации 🔑 Участие в ЭДО 🔑 Сведения о лице, имеющем право без доверенности действовать от имени юридического лица 🔑 Сведения об учредителях (участниках, единственном акционере) юридического лица 🔑 Сведения о суммах недоимки и задолженности по пеням и штрафам 🔑 Уплаченные налоги и сборы 🔑 Основной ОКВЭД 🔑 Дополнительные ОКВЭД 🔑 Специальные налоговые режимы 🔑 Среднесписочная численность работников организации |
Обязательные inn - ИНН организации Разрешено: цифры (10 символов) token - персональный ключ API |
function get_rez($url) { $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER,true); curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ $res = curl_exec($ch); curl_close($ch); return $res; } $data = [ 'type' => 'Тип запроса (type)', ... Необходимы для запроса параметры ... 'token' => 'Токен', ]; // Структурированная ссылка для GET запроса $url = 'https://api-cloud.ru/api/pb_nalog.php?' . http_build_query($data); $data = get_rez($url); // Результат ответа (JSON)Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
https://api-cloud.ru/api/pb_nalog.php?type=search_ip&inn=233410953141&token=53ba1b7a55abbB014aa97eff3a522079
{ "status": 200, // Статус ответа "found": true, // Флаг успешности поиска "count": 2, // Количество данных // Массив с данными "data": [ { "ogrn": "322237500371357", // ОГРНИП "inn": "233410953141", // ИНН "okved": "62.09", // Основной ОКВЭД "okved_name": "Деятельность, связанная с использованием вычислительной техники и информационных технологий, прочая", // Расшифровка ОКВЭД "name": "КОЧУРА АЛЕКСАНДР ВАСИЛЬЕВИЧ", // ФИО "dateReg": "14.10.2022", // Дата регистрации "statusIP": 1, // Статус регистрации (1 - действующее ИП / 0 = деятельность прекращена) "statusIPDesc": "Действующий ИП", // Расшифровка статуса регистрации "edo": "Участник ЭДО" // Если участвует в ЭДО (в результате "Участник ЭДО") }, { "ogrn": "316237500033445", // ОГРНИП "inn": "233410953141", // ИНН "okved": "62.09", // Основной ОКВЭД "okved_name": "Деятельность, связанная с использованием вычислительной техники и информационных технологий, прочая", // Расшифровка ОКВЭД "name": "КОЧУРА АЛЕКСАНДР ВАСИЛЬЕВИЧ", // ФИО "dateReg": "29.06.2016", // Дата регистрации "statusIP": 0, // Статус регистрации (1 - действующее ИП / 0 = деятельность прекращена) "statusIPDesc": "Деятельность прекращена", // Расшифровка статуса регистрации "edo": "" // Если участвует в ЭДО (в результате "Участник ЭДО") } ], "inquiry": { "price": 0, "balance": 498.79, "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле) "speed": 1, "attempts": 1 } }
https://api-cloud.ru/api/pb_nalog.php?type=search_org&inn=2334109531&token=53ba1b7a55abbB014aa97eff3a522079
{ "status": 200, // Статус ответа "found": true, // Флаг успешности "count": 1, // Количество // Массив с результатами "data": [ { // Флаг сведения не достоверны (0 - достоверны / 1 - не достоверны) "invalid": "0", // ОГРН "ogrn": "1106234007021", // ИНН "inn": "6234083042", // КПП "kpp": "773101001", // Полное наименование "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \" АВТОМОЙКА № 1 \"", // Сокращенное наименование "abbreviated_name": "ООО \" АВТОМОЙКА № 1 \"", // Регион "region": "РЯЗАНСКАЯ ОБЛАСТЬ", // Адрес организации "adress": "665835, ИРКУТСКАЯ ОБЛАСТЬ, Г. АНГАРСК, МКР. 29, Д.7", // Дата регистрации "dateReg": "18.08.2010", // Название налогового органа произведившего регистрацию "noReg": "Межрайонная инспекция Федеральной налоговой службы № 21 по Иркутской области", // Статус регистрации 0 - Деятельность прекращена; 1 - Действующая организация; 2 - В процессе банкротства; 3 - Процесс исключения; 4 - Процесс реорганизации; 5 - Стадия ликвидации; "statusORG": 0, // Расшифровка статуса регистрации Деятельность прекращена; Действующая организация; В процессе банкротства; Процесс исключения; Процесс реорганизации; Стадия ликвидации; "statusORGDesc": "Деятельность прекращена", // Если участвует в ЭДО (в результате "Участник ЭДО") "edo": "", // Масcив Сведения о лице, имеющем право без доверенности действовать от имени юридического лица "masruk": [ { "name": "БЫКОВА ЕЛЕНА АЛЕКСАНДРОВНА", // ФИО / Название "inn": "380102834710", // ИНН "position": "ДИРЕКТОР", // Должность "cnt": "4" // Количество ЮЛ, в которых лицо является руководителем (уполномоченным представителем) } ], // Масcив Сведения об учредителях (участниках, единственном акционере) юридического лица "masuchr": [ { "name": "БЫКОВА ЕЛЕНА АЛЕКСАНДРОВНА", // ФИО / Название "inn": "380102834710", // ИНН "cnt": "4" // Количество ЮЛ, в которых лицо является учредителем (участником, единственным акционером) }, { "name": "БЫКОВА ЕЛЕНА АЛЕКСАНДРОВНА", "inn": "380102834710", "cnt": "4" } ], // Сведения о суммах недоимки и задолженности по пеням и штрафам "arrear": [ { // Год "year": 2025, // Месяц "period": 2, // КБК "kbk": "Ф.2.", // Расшифровка КБК "kbkname": "Налог на доходы физических лиц", // Сумма недоимки "arrearsum": 0, // Сумма пени "penaltysum": 0, // Сумма штрафа "finesum": 1924, // Общая сумма недоимки и задолженности по пеням и штрафам "totalsum": 1924, "empty": 0 }, { "year": 2025, "period": 2, "kbk": "НН", "kbkname": "Неналоговые доходы, администрируемые налоговыми органами", "arrearsum": 0, "penaltysum": 0, "finesum": 1138.5, "totalsum": 1138.5, "empty": 0 } ], // Уплаченные налоги и сборы "taxpay": [ { // Год "year": 2023, // Расшифровка КБК "kbk": "НН.3.", // КБК "kbkname": "Суммы пеней", // Сумма "taxsum": 0 }, { "year": 2023, "kbk": "СВЗ.2.", "kbkname": "Страховые и другие взносы на обязательное пенсионное страхование, зачисляемые в Пенсионный фонд Российской Федерации", "taxsum": 21200.8 } ], // Основной ОКВЭД "okved": "45.20", // Расшифровка основного ОКВЭД "okved_name": "Техническое обслуживание и ремонт автотранспортных средств", // Масcив c дополнительными ОКВЭД "okvedList": [ { // Номер ОКВЭД "okved": "02.30.12", // Значение "okvedName": "02.30.12 - Сбор и заготовка дикорастущих плодов, ягод" }, { "okved": "02.30.13", "okvedName": "02.30.13 - Сбор и заготовка дикорастущих орехов" }, { "okved": "46.18.1", "okvedName": "46.18.1 - Деятельность агентов, специализирующихся на оптовой торговле фармацевтической продукцией, изделиями, применяемыми в медицинских целях, парфюмерными и косметическими товарами, включая мыло, и чистящими средствами" } ], // Масcив Специальные налоговые режимы "taxlist": [ { "year": 2025, // Год "period": 3, // Месяц "taxCode": "envd", // Код налового режима // Варианты "taxCode" // envd - Единый налог на вмененный доход для отдельных видов деятельности // eshn - Единый сельскохозяйственный налог // spr - Налог на сверхприбыль // usn - Упрощенная система налогообложения // ausn - Автоматизированная упрощённая система налогообложения // empty - Специальный налоговый режим не применяется "taxName": "Единый налог на вмененный доход для отдельных видов деятельности"// Расшифровка кода налогово режима }, { "year": 2025, "period": 2, "taxCode": "empty", "taxName": "empty" }, ], // Масcив Среднесписочная численность работников организации // Для вычисления среднего количества сотрудников сложим все числа группы 'count' и разделим полученное значение на количество этих чисел "employeeslist": [ { // Год "year": 2024, // Число сотрудников "count": 4 }, { "year": 2023, "count": 6 }, { "year": 2022, "count": 4 } ] } ], "inquiry": { "price": 0.3, "balance": 496.94, "credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле) "speed": 1, "attempts": 1 } }
дата | что изменилось |
---|---|
06.04.2025 | Метод search_org: |
код (error) | Описание ошибки (message) |
---|---|
888 | ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы |
766 | MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры |
602 | TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса |
504 | TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой |
503 | TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе |
502 | MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token |
500 | MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type |
499 | WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа. |
498 | TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс. |
460 | NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры |
456 | MAX_LIMIT Превышено количество одновременных соединений (потоки) |
404 | TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже. |
332 | inn: parameter not passed Параметр ИНН не передан |
331 | inn: entered incorrectly ИНН передан некорректно |
123 | IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК |
111 | PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно. |
15 | DATE_ERROR Ошибка значения переданной даты |
5 | TEST_TIME_OFF Закончился период тестирования |
3 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
2 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
1 | API_SUSPENDED Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}