ИНН физлица

P.0031.INN.BAS

Возвращает ИНН физического лица или сообщает об отсутствии ИНН.

Идентификаторы объекта: ФИО, дата рождения, серия и номер паспорта. Для уточнения поиска могут быть использованы дополнительные идентификаторы: дата выдачи паспорта.

Источник данных — ФНС.

Иcпользуемые источники: check_person/person_inn.

Время генерации отчёта:

  • 50-й перцентиль — 0,56 с;
  • 95-й перцентиль — 10,9 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
queryType string Обязательный Тип запроса.
Фиксированное значение: MULTIPART
query string Обязательный Значение простого запроса.
Фиксированное значение:  
data object Обязательный Идентификаторы объекта поиска
Параметры объекта data
last_name string Обязательный Фамилия
first_name string Обязательный Имя
patronymic string Обязательный Отчество. В случае отсутствия отчества указывается -
birth string Обязательный Дата рождения
passport string Обязательный,
если не указан паспорт иностранного гражданина
Серия и номер паспорта гражданина РФ
foreign_passport string Обязательный,
если не указан паспорт гражданина РФ
Серия и номер паспорта иностранного гражданина
passport_date string Необязательный Дата выдачи паспорта

В запросе, помимо ФИО, даты рождения и даты выдачи документа, достаточно передавать только один из документов лица:

  • passport,
  • foreign_passport.

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

Пример тела запроса по паспорту гражданина РФ

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "last_name": "Иванов",
    "first_name": "Иван",
    "patronymic": "Иванович",
    "birth": "11.02.1991",
    "passport": "1234 123456",
    "passport_date": "30.05.2018"
  }
}

Пример тела запроса по паспорту иностранного гражданина

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "last_name": "Иванов",
    "first_name": "Иван",
    "patronymic": "Иванович",
    "birth": "11.02.1991",
    "foreign_passport": "ID 123456789",
    "passport_date": "30.05.2018"
  }
}

Структура отчёта

Данные отчёта находятся в объекте data[].content.check_person.inn тела ответа.

Поле Тип Описание
value string ИНН
status string Статус запроса.
Возможные значения: FOUND — ИНН найден, NOT_FOUND — ИНН не существует, ERROR — данные по физлицу не найдены

Пример данных отчёта

{
  "data": [
    {
      "report_type_uid": "P.0031.INN.BAS_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/person_inn",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "inn": {
            "status": "FOUND",
            "value": "123456789012"
          }
        }
      }
    }
  ]
}

Пример данных отчёта, если информация об ИНН не найдена

{
  "data": [
    {
      "report_type_uid": "P.0031.INN.BAS_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/person_inn",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "inn": {
            "status": "NOT_FOUND",
            "value": ""
          }
        }
      }
    }
  ]
}