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

NEWDB — REST API

Добро пожаловать в документацию NEWDB. Здесь вы найдёте описание REST API, примеры запросов/ответов, а также метаданные для AI-агентов (раздел x-ai в описаниях методов).

Базовый URL

https://api.newdb.net/v2

Swagger UI

Интерактивная OpenAPI-спецификация доступна по адресу https://newdb.net/swagger/. В Swagger можно посмотреть схемы запросов и ответов, а также выполнить тестовый запрос к https://api.newdb.net.

Аутентификация

Передавайте токен в заголовке:

X-API-KEY: <your_token>

API разработан для проведения комплексных проверок юридических и физических лиц. Для получения токена напишите письмо на access@newdb.net.

Проверка баланса

Для проверки текущего баланса используйте запрос:

GET https://api.newdb.net/v2/balance
Headers: 
X-API-KEY: <your_token>

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

{
  "token": "2f5c2f2d-7d46-4f5c-9c6f-1f4e8e7b9a31",
  "balance": 9696
}

Реестр методов

Физические лица

  • fssp_person — проверка исполнительных производств ФССП по ФИО, дате рождения и региону
  • passport_fns — проверка паспорта и получение ИНН через ФНС
  • passport_mvd — проверка паспорта РФ на действительность
  • complex_by_passport — комплексная проверка человека по паспорту
  • bankrot_person — проверка банкротства физлица или ИП через Федресурс
  • pledge_person — проверка залогов и обременений по физлицу
  • arbitr_person — арбитражные дела физлица в КАД
  • nalog_debt — налоговая задолженность физлица по ИНН
  • elmk_registry — статус электронной медицинской книжки
  • fns_block_person — блокировки счетов физлица по данным ФНС
  • egrul_ip — сведения ЕГРИП и статус ИП по innfiz
  • terrorist — проверка на причастность к терроризму, экстремизму и распространению ОМУ

Иностранные граждане

  • foreign_vng — проверка вида на жительство
  • foreign_patent — проверка патента
  • foreign_rvp_stamp — проверка РВП по штампу в паспорте
  • foreign_rvp_blank — проверка РВП по бланку
  • foreign_rnr — проверка разрешения на работу
  • rkl — проверка по реестру контролируемых лиц
  • patent_msk — патент для Москвы
  • patent_mo — патент для Московской области

Юридические лица

  • arbitr_legal — арбитражные дела юрлица в КАД
  • fns_block — блокировки счетов юрлица по данным ФНС
  • bankrot_legal — проверка банкротства юрлица через Федресурс
  • egrul — сведения ЕГРЮЛ и карточка компании из Прозрачного бизнеса
  • fssp_legal — исполнительные производства ФССП по ИНН юридического лица
  • pledge_legal — залоги, лизинг и обременения юрлица по ИНН

ГАС Правосудие

  • pravo_cases_details — получение деталей судебного дела по case_id
  • pravo_search — поиск судебных дел по участникам, номеру, судье, категории и тексту актов

Имущество

  • rosreestr — проверка объекта недвижимости по кадастровому номеру или адресу
  • pledge_property — проверка залога и обременений по идентификатору предмета
  • pledge_vin — проверка залога и обременений по VIN
  • nspd_cadastr — получение геоданных и характеристик объекта по кадастровому номеру
  • realty_price — оценка стоимости недвижимости для покупки или аренды

Общий формат запроса

Отправьте POST на https://api.newdb.net/v2:

{
  "params": { "...": "..." },
  "requestId": "3f1f9c4d-6b62-4d72-9c68-2f7b9d1e5a10",
  "webhook": "<url>"
}
Параметр Обязательный Описание
params Да Параметры запроса
params.country Да Код страны (2 буквы) — ISO 3166-1 alpha-2
params.method Да Метод API
requestId Нет UUIDv4 идентификатор запроса. При повторном использовании API вернёт старый результат без нового запроса
webhook Нет HTTPS URL, на который NEWDB отправит POST-уведомление при обновлении состояния запроса

Подробная логика синхронного вызова, polling по requestId и работы с webhook описана в разделе Примеры вызова API.

Разделы документации

Используйте левое меню или реестр методов выше для быстрого перехода к нужному методу.