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

Налоговая задолженность

Опубликованные суммы задолженности организации

Что передать

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

Что получите

Недоимка, пени, штрафы и общая сумма по каждому налогу на дату сведений.

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

POST /v1/checks · HTTPS · JSON

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

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

Поле	Тип	Обязательно	Описание
product	string	Да	tax_debt
inn	string	Да	ИНН компании (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": "tax_debt", "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",
  "found_in_snapshot": false,
  "records": []
}

В result.snapshot: dataset, url, published_on, imported_at, as_of_dates, sha256. records содержит записи набора; денежные суммы передаются строками. Отсутствие записи не подтверждает отсутствие обязательств.

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

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) · Общие правила подключения

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

Ответ строится по полному опубликованному набору ФНС. Даты публикации и состояния сведений указаны в результате. Отсутствие записи не означает отсутствие задолженности, нарушения или налогового режима. Если сведения ещё не загружены или устарели, проверка временно недоступна.

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

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

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