complex_by_passport — Комплексная проверка по данным паспорта¶

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

Метод выполняет комплексную сквозную проверку физического лица по паспортным данным гражданина РФ (серия, номер, ФИО, дата рождения). В рамках одного запроса автоматически оркестрируются до 16 специализированных государственных и публичных проверок:

Действительность паспорта РФ (passport_mvd) — проверка по учетам МВД РФ на действительность, истечение срока действия или нахождение среди утраченных/недействительных бланков.
Поиск ИНН по паспорту (passport_fns) — установление идентификационного номера налогоплательщика в ФНС России (необходим для дальнейших налоговых проверок).
Исполнительные производства ФССП (fssp_person) — открытые производства, судебные взыскания, задолженности, запреты на выезд из РФ.
Банкротство физлиц (Федресурс) (bankrot_person) — сообщения о реструктуризации долгов, реализации имущества, завершении или прекращении процедуры банкротства в ЕФРСБ.
Арбитражные дела (arbitr_person) — участие гражданина в судебных спорах по Картотеке арбитражных дел (КАД Арбитр).
Суды общей юрисдикции (pravo_search) — поиск гражданских, административных и уголовных дел в федеральных судах и мировых судьях через ГАС «Правосудие».
Блокировки счетов ФНС (fns_block_person) — действующие решения налоговых органов о приостановлении операций по банковским счетам налогоплательщика.
Перечень террористов и экстремистов (terrorist) — нахождение в официальном реестре Росфинмониторинга (115-ФЗ).
Федеральный розыск МВД (mvd_wanted) — проверка по базе лиц, объявленных в розыск правоохранительными органами РФ.
Реестр иностранных агентов (inoagent) — проверка статуса иностранного агента по реестру Министерства юстиции РФ.
Залоги движимого имущества (pledge_person) — обременения транспортных средств, оборудования и долей по базе Федеральной нотариальной палаты (ФНП).
Статус индивидуального предпринимателя (ЕГРИП) (egrul_ip) — регистрация в качестве ИП, действующий статус, история, ОКВЭД.
Статус самозанятого (НПД) (self_employed) — подтверждение регистрации в качестве плательщика налога на профессиональный доход по данным ФНС РФ.
Реестр массовых руководителей (fns_mass_leaders) — факт включения ФИО/ИНН в реестр дисквалифицированных или массовых директоров ФНС РФ.
Реестр массовых учредителей (fns_mass_founders) — факт включения в реестр массовых участников/учредителей юридических лиц ФНС РФ.
Патенты и товарные знаки Роспатента (intellectual_property) — наличие зарегистрированных объектов интеллектуальной собственности (патенты на изобретения, товарные знаки, свидетельства ПО/БД) по базе ФИПС.

Состав шагов в steps и results оркестрируется динамически: на первом этапе параллельно запускаются проверки паспорта МВД, ФНС, ФССП, розыска, терроризма, иноагентов и судов. После определения ИНН автоматически инициируются подметоды проверки налоговых блокировок, банкротства, ИП, самозанятого, массовых руководителей и учредителей.

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

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

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

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

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

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

Заголовки¶

Content-Type: application/json X-API-KEY:

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

{
  "params": {
    "seria": "string (серия паспорта)",
    "number": "string (номер паспорта)",
    "firstname": "string (имя)",
    "lastname": "string (фамилия)",
    "secondname": "string (отчество, необязательно; если нет отчества — передайте null или пустую строку)",
    "dob": "string (дата рождения в формате YYYY-MM-DD или DD.MM.YYYY)",
    "country": "ru",
    "regioncode": "number | string (необязательно, код региона ФССП; по умолчанию 100 — поиск по всей России)",
    "method": "complex_by_passport"
  },
  "webhook": "https://your.host/whook",
  "requestId": "optional-string"
}

Параметр regioncode используется для проверки ФССП внутри комплексной проверки. Если regioncode не передан, по умолчанию применяется 100 (поиск по всем территориальным органам ФССП РФ). Отчество secondname является необязательным (поддерживаются граждане без отчества).

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

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

{
  "params": {
    "seria": "0000",
    "number": "000000",
    "method": "complex_by_passport",
    "firstname": "Иван",
    "secondname": "Иванович",
    "lastname": "Иванов",
    "dob": "1990-01-01",
    "country": "ru",
    "regioncode": 77
  },
  "requestId": "11111111-2222-3333-4444-555555555555"
}

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

{
  "params": {
    "seria": "0000",
    "number": "000000",
    "method": "complex_by_passport",
    "firstname": "Иван",
    "secondname": "Иванович",
    "lastname": "Иванов",
    "dob": "1990-01-01",
    "country": "ru",
    "regioncode": 77
  },
  "requestId": "11111111-2222-3333-4444-555555555555",
  "datecreated": "2026-03-17 12:00:00",
  "state": "complete",
  "balance": 9999,
  "steps": {
    "fssp_person": {
      "status": "complete",
      "error": null,
      "requestId": "aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb"
    },
    "passport_mvd": {
      "status": "complete",
      "error": null,
      "requestId": "cccccccc-1111-2222-3333-dddddddddddd"
    },
    "passport_fns": {
      "status": "complete",
      "error": null,
      "requestId": "eeeeeeee-1111-2222-3333-ffffffffffff"
    },
    "pledge_person": {
      "status": "complete",
      "error": null,
      "requestId": "12121212-3434-5656-7878-909090909090"
    },
    "egrul_ip": {
      "status": "complete",
      "error": null,
      "requestId": "abababab-cdcd-efef-0101-232323232323"
    }
  },
  "results": {
    "passport_fns": {
      "taskId": "99999999-8888-7777-6666-555555555555",
      "result": {
        "status": 200,
        "data": [
          {
            "innfiz": "7703245603",
            "status": "ИНН найден"
          }
        ]
      },
      "dateupdated": "2026-03-17 12:00:10"
    },
    "passport_mvd": {
      "taskId": "44444444-5555-6666-7777-888888888888",
      "dateupdated": "2026-03-17 12:00:12",
      "result": {
        "status": 200,
        "data": [
          {
            "doc_status": "Действительный"
          }
        ]
      }
    },
    "fssp_person": {
      "taskId": "10101010-2020-3030-4040-505050505050",
      "dateupdated": "2026-03-17 12:00:15",
      "result": {
        "status": 200,
        "data": []
      }
    },
    "pledge_person": {
      "taskId": "61616161-7272-8383-9494-050505050505",
      "dateupdated": "2026-03-17 12:00:18",
      "result": {
        "status": 200,
        "data": []
      }
    },
    "egrul_ip": {
      "taskId": "abab1111-cdcd-2222-efef-333344445555",
      "dateupdated": "2026-03-17 12:00:20",
      "result": {
        "status": 200,
        "data": []
      }
    }
  },
  "finished_at": "2026-03-17 12:00:21"
}

AI Summary¶

Компактные метаданные для AI и агентных систем

{
  "method": "complex_by_passport",
  "intent": "Комплексная проверка физического лица по паспортным данным",
  "endpoint": "POST https://api.newdb.net/v2",
  "required_headers": ["X-API-KEY"],
  "required_fields": ["firstname", "lastname", "secondname", "dob", "seria", "number", "method", "country"],
  "returns": ["state", "results.complex_by_passport.result.status", "results.complex_by_passport.result.data"]
}

Готовый HTML/PDF-отчет¶

После перехода запроса в complete отчет формируется через GET /v2/report:

curl 'https://api.newdb.net/v2/report?requestId=00000000-0000-4000-8000-000000000101&format=pdf' \
  --header 'X-API-KEY: YOUR_API_KEY' --output person-report.pdf

Открыть пример · Описание API отчетов