# Проверки ФНС через API Cloud

> Проверяйте ИНН физлица по паспортным данным, валидность ИНН или статус плательщика налога на профессиональный доход по ИНН.

- HTML: https://poapi.ru/api-cloud/api-federalnaya-nalogovaya-sluzhba
- Компания: API-CLOUD
- Страница компании: https://poapi.ru/company/api-cloud
- Категории: Госуслуги
- Сайт API: https://api-cloud.ru/nalog
- Документация: https://api-cloud.ru/nalog

## Подключение и ограничения
- Авторизация: Персональный токен API Cloud из настроек; параметр token или заголовок Token.
- Ограничения: Не путайте проверку ИНН (inn), недействительность номера (invalidinn) и статус НПД (npd). Передавайте минимум сведений, строго нужных выбранному методу.

```bash
# Задайте API_CLOUD_TOKEN; замените заполнители реквизитами своего запроса.
curl --silent --show-error --fail-with-body --get --max-time 120 'https://api-cloud.ru/api/nalog.php' \
  --data-urlencode 'type=npd' \
  --data-urlencode 'inn=12_ЦИФР_ИНН' \
  --header "Token: ${API_CLOUD_TOKEN:?Укажите токен API Cloud}"
```
- Результат: Для npd пример возвращает status, found, inn, date, NPD и message; NPD=1 означает статус плательщика НПД, NPD=0 — отсутствие этого статуса на указанную дату. Для invalidinn документированы invalid и date_invalid. В примерах провайдер также передаёт inquiry с price и техническими сведениями об обработке.
- Проверено по документации: 2026-11-02
- Источник: https://api-cloud.ru/nalog

## Описание
В API Cloud предусмотрены методы inn, invalidinn и npd. Первый сопоставляет персональные данные и реквизиты документа с ИНН; два других принимают 12 значный ИНН и возвращают сведения о проверке недействительности номера или статусе НПД. Это посреднические ответы по налоговым данным, применимость и актуальность ограничены конкретной операцией и источником.

## Когда использовать
- Если нужен статус НПД, вызывайте npd по ИНН; если требуется найти ИНН физлица, используйте отдельный inn с предусмотренными документом полями и обрабатывайте результат отдельно.
- Повторно запросить статус НПД по сохранённому ИНН и отобразить его вместе с датой из ответа.

## Порядок интеграции
1. Для статуса НПД вызовите npd с 12-значным ИНН; не отправляйте паспортные реквизиты в этом методе.
2. Прочитайте NPD вместе с date и inn; сохраните дату результата, так как она входит в ответ и показывает дату проверки.
3. Для проверки недействительного ИНН используйте отдельный invalidinn и трактуйте invalid/date_invalid по его собственной схеме.

## Что проверить перед запуском
- NPD=0 означает только отсутствие статуса НПД на дату, указанную в ответе; не трактуйте результат как постоянный статус или подтверждение иных налоговых сведений.

## Связанные API
- [Исполнительные производства ФССП через API Cloud](https://poapi.ru/api-cloud/api-fssp): Ищите исполнительные производства по физическому или юридическому лицу либо по номеру производства и получайте сведения о документе и подразделении.
- [Реестр иностранных агентов через API Cloud](https://poapi.ru/api-cloud/api-reestr-inostrannyh-agentov): Ищите записи по имени или наименованию и получайте опубликованные реквизиты записи, включая основания и даты решения Минюста.
