Существенно расширена линейка методов NewDB: добавлены проверки водительских удостоверений (driver_license) и авто по VIN (vin_check) через Госуслуги, статус самозанятых (self_employed), реестр дисквалифицированных лиц (disqual), маркеры недостоверности ЕГРЮЛ (egrul_untrusted), массовые руководители и учредители ФНС, реестр недобросовестных поставщиков (rnp), договоры лизинга на Федресурсе (leasing_fedresurs), финансовая отчетность ГИР БО (fns_bo) и AI-агрегатор арбитражных задолженностей (arbitr_debt_sum).
Перейти к документации APIНалоговая задолженность физлица по ИНН
Подключаем госреестры и коммерческие источники, пишем веб-роботов и автоматизируем ваши процессы.
Что нового
Метод nalog_debt позволяет проверить задолженность физического лица по налогам по ИНН через API NEWDB. Страница ориентирована на запросы налоговая задолженность физлица по ИНН API, ГИС ГМП долги по налогам API, проверить долги физлица по налогам. Метод возвращает сведения о налоговой задолженности, отправленных параметрах формы и технических деталях проверки.
Что проверяет API ГИС ГМП
NEWDB выполняет проверку налоговой задолженности физического лица по ИНН, получает сведения о сумме долга, составе начислений и метаданных выполнения запроса. Такой сценарий подходит для скоринга, KYC, антифрода, проверки клиентов и внутренних сервисов взыскания.
Что структурирует NEWDB
В процессе сбора NEWDB выделяет итоговую сумму задолженности, список начислений, данные формы, HTTP-статус, сетевые метаданные и сведения об источнике в отдельные поля. Это упрощает обработку налоговых долгов физлица в CRM, аналитике, скоринговых моделях и отчётах.
Что возвращает метод nalog_debt
Задолженность
Общая сумма долга и список найденных начислений в поле debt.
Параметры формы
ИНН физического лица.
Пример API-запроса налоговой задолженности физлица
Content-Type: application/json X-API-KEY: <your_token>
POST https://api.newdb.net/v2
JSON-запрос
{
"params": {
"inn": "770000000000",
"country": "ru",
"method": "nalog_debt"
},
"webhook": "https://your.host/webhook",
"requestId": "a5962f88-2916-4779-b59d-43c023faa899"
}
HTTP-пример
POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: YOUR_TOKEN
{
"params": {
"inn": "770000000000",
"country": "ru",
"method": "nalog_debt"
},
"requestId": "a5962f88-2916-4779-b59d-43c023faa899"
}
Пример ответа API
В ответе NEWDB возвращает результат проверки налоговой задолженности по ИНН физического лица. Если долгов нет, в debt.total будет 0.00, а список items останется пустым.
{
"params": {
"inn": "770000000000",
"country": "ru",
"method": "nalog_debt"
},
"requestId": "a5962f88-2916-4779-b59d-43c023faa899",
"datecreated": "2026-03-15 23:15:44",
"state": "complete",
"tasks": 1,
"is_repeat": false,
"results": {
"nalog_debt": {
"taskId": "nalog-debt-local-task",
"dateupdated": "2026-03-15 23:15:59",
"result": {
"status": 200,
"data": [
{
"amount": {
"text": "56844,49 ₽",
"value": 56844.49,
"currency": "RUB"
}
}
]
}
}
},
"finished": 1
}
Основные поля результата
| Поле | Описание |
|---|---|
| results.nalog_debt.result.status | HTTP-статус выполнения проверки. |
| debt | Сведения о задолженности, включая итоговую сумму и список начислений. |
| form | Данные, переданные в форму проверки: ИНН. |
| http | Технические сведения HTTP-запроса. |
| network | Сетевые метаданные выполнения проверки. |
| page | Сведения о странице или источнике результата. |
| request | Параметры исполненного запроса. |
Где используется проверка налоговых долгов
- Проверка клиентов и заёмщиков на налоговые долги по ИНН.
- Встроенные проверки в KYC, anti-fraud и скоринговые системы.
- Оценка платёжной дисциплины физлица перед сделкой или оказанием услуги.
- Автоматизация внутренних проверок для коллекторских, финтех- и страховых сервисов.
- Мониторинг задолженностей в CRM и аналитических отчётах.
Смежные проверки
Исполнительные производства, долги у приставов и статусы взыскания.
Банкротство физического лицаПроверка публикаций о банкротстве и сообщений Федресурса.
Комплексная проверка по ИННОбъединяет долги, суды, ФССП, банкротство и другие источники в одном сценарии.
Пример ответа: долги не найдены
{
"state": "complete",
"results": {
"nalog_debt": {
"result": {
"status": 200,
"data": [
{
"debt": {
"total": "0.00",
"items": []
}
}
]
}
}
}
}
Если проверяется иностранный гражданин
Для проверки патента, РВП или ВНЖ используйте раздел «Иностранные граждане».
Иностранные гражданеAPI NewDB
Налоговая задолженность физлица по ИНН: что получает интеграция
Страница описывает практический сценарий метода gosdolg:
какие данные нужны на входе, как выглядит запрос к API и где использовать результат в рабочем процессе.
Формулировки здесь рассчитаны на продуктовую и юридическую оценку, а точная схема полей вынесена в техническую документацию.
Метод подходит для автоматических проверок по физическим лицам: скоринга, комплаенса, онбординга клиентов, мониторинга контрагентов и внутренних antifraud-процедур. Ответ приходит в JSON и может обрабатываться синхронно через API или асинхронно через webhook.
Входные данные
В запрос передаются только параметры, необходимые для выбранной проверки. Обычно это ИНН, паспортные данные, ФИО, дата рождения, номер дела, кадастровый номер или адрес объекта.
Результат
В ответе возвращаются найденные записи, статус проверки, идентификаторы запроса и служебные поля, по которым можно связать результат с вашей CRM, скоринговой системой или кабинетом клиента.
Ограничения
Данные берутся из доступных источников и носят информационный характер. Для решений с юридическими последствиями используйте результат вместе с внутренним регламентом проверки.
Пример API-запроса
Все методы вызываются через единый endpoint. В поле method указывается идентификатор проверки,
остальные параметры зависят от выбранного метода.
POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: ***
{
"params": {
"method": "gosdolg"
},
"requestId": "your-request-id",
"webhook": "https://example.com/newdb-webhook"
}
Если метод требует специальные поля, например ИНН, серию и номер документа или кадастровый номер, они описаны в документации метода и проверяются на стороне API до запуска задачи.
Как читать результат
| Поле | Значение |
|---|---|
requestId |
Идентификатор запроса на стороне клиента или NewDB |
state |
Состояние обработки: очередь, выполнение, завершение или ошибка |
results |
Блок с результатами метода, статусом источника и найденными данными |
Частые вопросы
Можно ли встроить метод в CRM?
Да. Передавайте свой requestId, сохраняйте его у себя и получайте результат по webhook или через GET-запрос к API.
Что делать с пустым ответом?
Пустой массив обычно означает, что источник не нашел подходящих записей. Это не равно юридическому заключению.
Есть ли повторные проверки?
Для мониторинга используйте webhook и сохраняйте идентификаторы. Повторный запуск можно связать с тем же объектом в вашей системе.
Где смотреть точную схему?
Откройте техническую документацию метода. Там указаны обязательные поля, формат ответа и дополнительные ограничения.
Техническая документация API
На этой странице описан сценарий и применение метода. Подробная техническая спецификация, параметры запроса, JSON-схемы и примеры ответов доступны в developer docs.
Цены и доступ
Базовая единица тарификации API: 1 источник данных = 2 ₽. Комплексные проверки зависят от набора входных данных и найденных связанных лиц.
API для интеграции
На период внедрения и тестирования выдаём 100 запросов к API без абонентской платы.
- Быстрая проверка интеграции
- Помощь с методами и схемой запросов
- Поддержка в Telegram
Базовый тариф API
- • Базовый запрос: 1 источник, 2 ₽
- • Полный доступ ко всем методам API
- • Овердрафт: +50 запросов сверх лимита
- • Уведомления о расходе
Разовая проверка паспорта
за одну проверку
Оплата картой через ЮKassa. Результат проверки отправим на ваш email.
Заказать проверкуСнижение риска мошенничества
Проверяйте подлинность документов перед выдачей оборудования, арендой, услугами или оформлением сделки.
Усиление KYC / AML-процессов
Интегрируйте автоматическую проверку личности в свои процессы идентификации клиентов и антифрод-системы.
Проверка сотрудников и исполнителей
Подходит для курьеров, водителей, логистов и работников с доступом к ценностям или оборудованию.