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

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

Метод выполняет комплексную проверку физического лица по серии и номеру паспорта РФ. В рамках одного запроса могут выполняться следующие проверки:

проверка паспорта на действительность по линии МВД (passport_mvd),
проверка паспорта и получение ИНН по линии ФНС России (passport_fns),
поиск исполнительных производств в ФССП (fssp_person),
поиск сведений о залогах и обременениях по физлицу (pledge_person),
проверка статуса ИП / сведений ЕГРИП (egrul_ip).

Состав шагов в steps и results зависит от доступных идентификаторов и внутренних переходов между источниками. Например, после получения ИНН могут запускаться дополнительные проверки по найденным данным.

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

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

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

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

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

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

Заголовки¶

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

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

{
  "params": {
    "seria": "string (серия паспорта)",
    "number": "string (номер паспорта)",
    "firstname": "string",
    "lastname": "string",
    "secondname": "string",
    "dob": "YYYY-MM-DD",
    "country": "ru",
    "regioncode": "number",
    "method": "complex_by_passport"
  },
  "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": {
    "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": "passport_fns request failed with status 405",
      "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": 405,
        "data": []
      },
      "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"]
}