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