API Федеральная налоговая служба - API-CLOUD
Документация по работе с API Федеральная налоговая служба

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP GET на URL нашего API: https://api-cloud.ru/api/nalog.php с персональным ключом API и параметрами.
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON
Пример отправки GET запроса на PHP:
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/nalog.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)
История изменений/обновлений API
Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа

type (Метод) Описание Параметры в запросе
В одном запросе возможно отправить только 1 тип
inn Поиск ИНН физического лица Обязательные
lastname - Фамилия
Разрешено: кириллица, буквы (I,V), знак "-"
firstname - Имя
Разрешено: кириллица, буквы (I,V), знак "-"
birthdate - Дата рождения
Разрешено: цифры, знак "."
serianomer - Серия и номер паспорта (без пробелов)
Разрешено: цифры
token - персональный ключ API
Дополнительные
secondname - Отчество
Разрешено: кириллица, буквы (I,V), знак "-"
npd new! Проверить статус налогоплательщика налога на профессиональный доход (самозанятого) Обязательные
inn - ИНН физического лица (12 цифр)
Разрешено: цифры (валидация номера)
token - персональный ключ API
Дополнительные
date - Дата, на которую производить проверку (формат 15.02.2024). Если параметр не передан, то производим поиск на сегодняшний день.
Разрешено: цифры, знак "." (валидация корректной даты)
Примеры запросов

История изменений API Федеральная налоговая служба

дата что изменилось
16.02.2024

Появился новый тип запроса "npd".
Позволяет проверить статус налогоплательщика налога на профессиональный доход (самозанятого)
26.01.2024

Добавлен новый обработчик ошибки при некорректной передаче даты рождения.
В случае, если вы передаете некорректную дату рождения, не в задокументированном виде (например 12.01.1800 или обычные цифры и т.д.), то в ответ поступит ошибка:
{"error":"015","message":"DATE_ERROR"}
Если такое исключение необходимо, то примите его в работу.
17.08.2023

Адаптация под источник
15.03.2023

1. Скорректировали обязательные параметры запроса. Отчество исключено из обязательных.
2. В ответе добавлен признак found => true - найдено, found => false - не найдено, found => error - в случае ошибки в запросе.
3. Исправлены мелкие ошибки.
23.10.2022

В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса. 
14.06.2022

Поиск ИНН физического лица, пофиксили сбои в работе, ускорили работу.
06.04.2022

Переработан алгоритм получения ИНН
28.03.2022

Переработан алгоритм. Изменение вывода у первоисточника.
21.03.2022

В случае проведения технических работ на стороне ФНС или недоступности будет выведена ошибка
{"status":404,"message":"Сервис ФНС временно не доступен или ведутся технические работы"}
18.11.2021

Информация о запросе в массиве inquiry
Добавлен статус ответа, а так же информация о запросе: Тариф, скорость, количество попыток

Возможные коды ошибок

код (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
Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
123 IP_NOT_REGISTERED_IN_THE_SYSTEM
Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
115 MISSING_MANDATORY_PARAMETERS
Отсутствуют обязательные параметры
111 PARAMETER_CONFLICT
Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
102 MISSING_REQUIRED_secondname_PARAMETER
Неверно указан параметр lastname
101 MISSING_REQUIRED_lastname_PARAMETER
Отсутствует параметр lastname или указан неверно
100 MISSING_REQUIRED_firstname_PARAMETER
Отсутствует параметр firstname или указан неверно
015 DATE_ERROR
Ошибка значения переданной даты
012 MISSING_DATE_PARAMETER
Ошибка в переданном параметре date
011 MISSING_REQUIRED_inn_PARAMETER
Параметр inn передан с ошибками или не соответствует маске
010 MISSING_INN_PARAMETER
Отсутствует обязательный параметр inn
005 TEST_TIME_OFF
Закончился период тестирования
003 TOKEN_BLOCKED_BY_QUALITY_SERVICE
Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
002 TOKEN_TEHBLOCK
Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
001 API_SUSPENDED
Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.
Пример ответа с ошибкой 

{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}