Документация по работе с API ФНС: Прозрачный бизнес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"}