parser / data.ru
← Проверки для людей
ФНС России · API · Пилот

Поиск своего ИНН

Получение собственного ИНН пользователя по ФИО, дате рождения и паспорту РФ через API.

Что делает продукт

Передаёт данные в сервис ФНС и возвращает ИНН либо явный ответ об отсутствии сведений. Предназначен только для поиска собственного ИНН: ваша система получает подтверждение пользователя, а сервер автоматически передаёт его ФНС.

Источник и ограничения

Паспортные данные и результат не сохраняются в истории. При капче, ошибке или таймауте возвращается ошибка. Поддержан паспорт РФ. Положительный поиск по реальным данным пока не проверен.

Источник — ФНС России

Документация API

POST /v1/inn/self · HTTPS · JSON

Передавайте персональный ключ в заголовке X-API-Key. Все проверки выполняются через API вашей системы.

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

ПолеТипОбязательноОписание
last_name / first_namestringДаФамилия и имя, до 50 символов.
middle_namestringНетОтчество; при отсутствии не передавайте поле.
birth_date / issue_datestringДаДата рождения и выдачи паспорта, YYYY-MM-DD.
passport_seriesstringДа4 цифры серии паспорта РФ.
passport_numberstringДа6 цифр номера паспорта РФ.
self_lookup_confirmedbooleanДаtrue — пользователь подтвердил поиск только своего ИНН и передачу данных в ФНС.

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

Значения приведены для иллюстрации формата; замените их своими данными.

curl -X POST 'https://parser-data.ru/v1/inn/self' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"last_name": "Иванов", "first_name": "Иван", "middle_name": "Иванович", "birth_date": "1990-01-01", "passport_series": "0000", "passport_number": "000000", "issue_date": "2010-01-01", "self_lookup_confirmed": true}'

Ответ · HTTP 200

Синхронный ответ; установите таймаут клиента 150 секунд. Паспортные данные и результат не записываются в историю.

{
  "product": "inn_person",
  "status": "completed",
  "source": "fns_self_inn",
  "checked_at": "2026-10-27T12:00:00+00:00",
  "data": {
    "found": false,
    "inn": null
  }
}

При found=true поле inn содержит строку из 12 цифр. found=false означает только отсутствие сведений по переданным данным. Подтверждение автоматически передаётся ФНС; ваша система должна получить его от пользователя. Поддержан только поиск собственного ИНН по паспорту РФ.

Ошибки и ограничения

HTTP 401 — неверный ключ; 422 — некорректные параметры; 429 — лимит или занятый источник. Ошибка источника не является отрицательным результатом проверки.

HTTP 503: SOURCE_CAPTCHA_REQUIRED, SOURCE_TIMEOUT, SOURCE_REJECTED_INPUT, SOURCE_INVALID_RESPONSE, SOURCE_UNAVAILABLE. Ошибка находится в error.code. Один активный запрос; интервал минимум 31 секунда. Положительный поиск по реальным паспортным данным пока не проверен.

Справочник методов API · Схема OpenAPI (JSON) · Общие правила подключения