passport_fns — Проверка паспорта/ИНН через ФНС¶

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

Проверка паспорта и ИНН через сервисы ФНС.

Рекомендуем также: комплексная проверка по паспорту — complex_by_passport.

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

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

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

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

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

Заголовки¶

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

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

Поддерживается два варианта вызова:

Поиск ИНН по паспорту и ФИО (классический режим):

{
  "params": {
    "seria": "string",
    "number": "string",
    "firstname": "string",
    "lastname": "string",
    "secondname": "string",
    "dob": "string", // yyyy-mm-dd
    "country": "ru",
    "method": "passport_fns"
  },
  "requestId": "19342f89-2916-4779-b59d-43c012f1a781"
}

Прямая проверка ИНН (проверка действительности в реестре недействительных ИНН + определение региона + поиск аффилированных компаний):
```
{
  "params": {
    "inn": "7703245603",
    "country": "ru",
    "method": "passport_fns"
  },
  "requestId": "19342f89-2916-4779-b59d-43c012f1a781"
}
```

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

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

{
  "params": {
    "seria": "4015",
    "number": "350278",
    "firstname": "Александр", 
    "secondname": "Сергеевич",
    "lastname": "Малина", 
    "dob": "1990-12-17",
    "country": "ru",
    "method": "passport_fns"
  },
  "requestId": "19342f89-2916-4779-b59d-43c012f1a781"
}

Пример ответа (ИНН найден и проверен)¶

{
  "state": "complete",
  "requestId": "19342f89-2916-4779-b59d-43c012f1a781",
  "results": {
    "passport_fns": {
      "result": {
        "status": 200,
        "data": [
          {
            "innfiz": "7703245603",
            "region_code": "77",
            "region_name": "г. Москва",
            "is_invalid": false,
            "invalid_date": null,
            "invalid_inn_status": "Действителен",
            "invalid_inn_check": {
              "checked": true,
              "status": "VALID",
              "message": "ИНН действителен",
              "registry_url": "https://service.nalog.ru/invalid-inn-fl.html"
            },
            "founder_companies": [
              {
                "inn": "7701234567",
                "ogrn": "1157746123456",
                "name": "ООО \"ПРИМЕР ТЕХНОЛОДЖИ\"",
                "status": "Действующее",
                "role": "Учредитель"
              }
            ],
            "leader_companies": [
              {
                "inn": "7701234567",
                "ogrn": "1157746123456",
                "name": "ООО \"ПРИМЕР ТЕХНОЛОДЖИ\"",
                "status": "Действующее",
                "role": "Генеральный директор"
              }
            ]
          }
        ]
      }
    }
  }
}

Описание полей в `data[0]`¶

Поле	Тип	Описание
`innfiz`	string	Найденный или переданный ИНН физического лица.
`region_code`	string	Код региона РФ выдачи ИНН (первые 2 цифры ИНН).
`region_name`	string	Наименование субъекта РФ выдачи ИНН (по справочнику субъектов РФ).
`is_invalid`	boolean	`true`, если ИНН признан недействительным по реестру ФНС. `false`, если действителен.
`invalid_date`	string / null	Дата признания ИНН недействительным (если недействителен).
`invalid_inn_status`	string	Текстовый статус проверки (`"Действителен"`, `"Недействителен"` и т.д.).
`invalid_inn_check`	object	Детали проверки по официальному реестру недействительных ИНН ФНС (`https://service.nalog.ru/invalid-inn-fl.html`).
`founder_companies`	array	Список организаций из ЕГРЮЛ («Прозрачный бизнес»), в которых физлицо является учредителем/участником.
`leader_companies`	array	Список организаций из ЕГРЮЛ («Прозрачный бизнес»), в которых физлицо является руководителем (директором).

Пример ответа (ИНН не найден)¶

{
  "state": "complete",
  "results": {
    "passport_fns": {
      "result": {
        "status": 200,
        "data": []
      }
    }
  }
}

AI Summary¶

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

{
  "method": "passport_fns",
  "intent": "Проверка соответствия паспорта и ИНН физического лица через ФНС",
  "endpoint": "POST https://api.newdb.net/v2",
  "required_headers": ["X-API-KEY"],
  "required_fields": ["seria", "number", "firstname", "lastname", "secondname", "dob", "country", "method", "webhook", "requestId"],
  "returns": ["state", "results.passport_fns.result.status", "results.passport_fns.result.data"]
}