ФНС России · Доступно по API

Проверка недействительных ИНН

Узнайте, есть ли ИНН физлица или компании в списке недействительных ИНН ФНС.

Что передать

ИНН физлица (12 цифр) или компании (10 цифр).

Что получите

Наличие записи в списке и дата признания ИНН недействительным, если она указана.

Документация API

POST /v1/checks · HTTPS · JSON

Передавайте персональный ключ в заголовке X-API-Key. Все проверки выполняются через API вашей системы.

Параметры запроса

Поле	Тип	Обязательно	Описание
product	string	Да	invalid_inn
inn	string	Да	ИНН физлица (12 цифр) или компании (10 цифр).

Пример запроса

Значения приведены для иллюстрации формата; замените их своими данными.

curl -X POST 'https://parser-data.ru/v1/checks' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: UNIQUE_REQUEST_ID' \
  --data '{"product": "invalid_inn", "inn": "7801699601"}'

Создание задачи · HTTP 202

Ответ содержит id, product, status, input, created_at, updated_at, result и error. Сохраните id.

Получение результата

curl 'https://parser-data.ru/v1/checks/CHECK_ID' \
  -H 'X-API-Key: YOUR_API_KEY'

Ожидайте completed или failed; промежуточные состояния — queued и running. При успехе данные находятся в result.data. При ошибке код находится в error.code. История: GET /v1/checks.

Пример полей result.data

Иллюстрация структуры, не результат реальной проверки. Наличие записи в списке и дата признания ИНН недействительным, если она указана.

{
  "inn": "7801699601",
  "kind": "company",
  "listed_as_invalid": false,
  "invalid_since": null
}

Ошибки и ограничения

HTTP 401 — неверный ключ; 422 — некорректные параметры; 429 — лимит или занятый источник. Ошибка источника не является отрицательным результатом проверки.

HTTP 409 — конфликт Idempotency-Key. При сбое задача переходит в failed: возможны SOURCE_TIMEOUT, SOURCE_UNAVAILABLE, SOURCE_CAPTCHA_REQUIRED; для выгрузок — DATASET_NOT_READY, DATASET_STALE, DATASET_INVALID. Исправьте причину перед повторным запросом.

Справочник методов API · Схема OpenAPI (JSON) · Общие правила подключения

Источник и ограничения

Отсутствие в списке не подтверждает выдачу ИНН или личность его владельца. Проверка не заменяет сведения ЕГРЮЛ. Используется публичный интерфейс ФНС; при ошибке источника отрицательный результат не возвращается.

Перейти к источнику ФНС ↗

Автоматизация

Операция invalid_inn доступна через единый API. Описание подключения.