parser / data.ru
← Каталог проверок
ФНС России · Доступно по API

Сводка открытых данных ФНС

Семь разделов сведений о компании в одном запросе.

Что передать

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

Что получите

МСП, налоговые режимы, задолженность, доходы и расходы, платежи, численность и штрафы. Каждый раздел содержит собственную дату сведений.

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

POST /v1/checks · HTTPS · JSON

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

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

ПолеТипОбязательноОписание
productstringДаcompany_snapshot
innstringДаИНН компании (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": "company_snapshot", "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",
  "complete": false,
  "sections": {
    "sme_registry": {
      "status": "failed",
      "error": {
        "code": "DATASET_NOT_READY"
      }
    }
  }
}

Пример сокращён: sections содержит семь разделов с их датами и статусами. complete=false означает частичный результат.

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

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

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

Сводка не является заключением о надёжности. При complete=false часть разделов не получена: ошибки указаны отдельно. Отсутствие записи в наборе не означает отсутствие обязательств. Это не проверка судов, ФССП или банкротства.

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

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

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