Перейти к содержанию

fns_block_person — Проверка блокировок счетов физлица (ФНС)

POST https://api.newdb.net/v2

Метод возвращает сведения о решениях ФНС по приостановлению операций по банковским счетам физического лица по ИНН.

Для запроса нужно передавать innfiz из 12 цифр.

Раздел: Физические лица

Связанные страницы

Когда использовать

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

Типовые кейсы

  • Проверка анкеты клиента перед onboarding или выдачей услуги
  • Автоматическая верификация паспорта, ИНН, задолженностей или ограничений
  • Обогащение внутренней карточки физлица данными из внешнего источника

Заголовки

Content-Type: application/json
X-API-KEY: <your_token>

Входная схема (request)

{
  "params": {
    "innfiz": "string (ИНН физлица, 12 цифр)",
    "country": "string (ru)",
    "method": "fns_block_person"
  },
  "webhook": "https://your.host/whook",
  "requestId": "optional-string"
}

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

POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: YOUR_TOKEN

{
  "params": {
    "innfiz": "132620072012",
    "country": "ru",
    "method": "fns_block_person"
  },
  "webhook": "https://newer.net/whook",
  "requestId": "81862f18-2316-4779-b59d-45c011faa898"
}

Пример ответа

{
  "params": {
    "innfiz": "132620072012",
    "country": "ru",
    "method": "fns_block_person",
    "newdb_qid": "EKgiIKn56YPJMygD"
  },
  "webhook": "https://newer.net/whook",
  "requestId": "81862f18-2316-4779-b59d-45c011faa898",
  "datecreated": "2026-02-24 19:27:51",
  "state": "complete",
  "balance": 9778,
  "tasks": 1,
  "is_repeat": false,
  "results": {
    "fns_block": {
      "taskId": "c3311e4f-36ae-4d6d-9610-73bf41662782",
      "dateupdated": "2026-02-24 19:28:01",
      "result": {
        "status": 200,
        "data": [
          {
            "DATASTART": "03.03.2022",
            "NOMER": "990",
            "DATA": "03.03.2022",
            "KODOSNOV": "02",
            "SALDO": "(Отсутствует значение)",
            "IFNS": "1326",
            "BIK": "048952615",
            "DATABI": "06.03.2022 04:06:09"
          },
          {
            "DATASTART": "01.07.2022",
            "NOMER": "786",
            "DATA": "01.07.2022",
            "KODOSNOV": "02",
            "SALDO": "(Отсутствует значение)",
            "IFNS": "1300",
            "BIK": "048952615",
            "DATABI": "06.07.2022 21:45:00"
          }
        ],
        "query": {
          "inn": "1326200720",
          "bik": "442455546"
        }
      }
    }
  }
}

Особенность ответа

Несмотря на метод fns_block_person, данные в ответе приходят в блоке results.fns_block.

Поля результата results.fns_block.result.data[]

Поле Описание
DATASTART Дата начала действия решения о приостановлении операций
NOMER Номер решения
DATA Дата решения
KODOSNOV Код основания
SALDO Остаток/сальдо, может отсутствовать
IFNS Код налогового органа
BIK БИК банка
DATABI Дата и время публикации записи

AI Summary

Компактные метаданные для AI и агентных систем
{
  "method": "fns_block_person",
  "intent": "Проверка блокировки счета физического лица по данным ФНС",
  "endpoint": "POST https://api.newdb.net/v2",
  "required_headers": ["X-API-KEY"],
  "required_fields": ["innfiz", "method", "country"],
  "returns": ["state", "results.fns_block_person.result.status", "results.fns_block_person.result.data"]
}