Поиск ИНН по паспортным данным

Для поиска ИНН физического лица используйте следующий запрос:

https://parser-api.com/parser/nalog_inn_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&firstName=ИМЯ&patronymic=ОТЧЕСТВО&lastName=ФАМИЛИЯ&dob=ДАТА_РОЖДЕНИЯ&passportSeries=СЕРИЯ&passportNumber=НОМЕР

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

• key — ключ доступа к сервису (обязательный).
• firstName — имя (обязательный).
• patronymic — отчество (обязательный).
• lastName — фамилия (обязательный).
• dob — дата рождения в формате YYYY-MM-DD (обязательный).
• passportSeries — серия паспорта, 4 цифры (обязательный).
• passportNumber — номер паспорта, 6 цифр (обязательный).

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

https://parser-api.com/parser/nalog_inn_api/?key=ВАШ_КЛЮЧ_ДОСТУПА&firstName=Иван&patronymic=Иванович&lastName=Иванов&dob=1980-12-31&passportSeries=1234&passportNumber=123456

Пример ответа на запрос:

Ответ на запрос возвращается в формате JSON. Пример ответа:

{
  "success": 1, // Флаг успешности выполнения запроса. При получении 0 сделайте повторный запрос сразу же или через несколько минут.
  "inn": "240135834492" // ИНН физического лица
}

Интерпретация ответа и обработка ошибок

Общие рекомендации:

• Если поле success заполнено и success = 1 — перед вами успешный ответ, с которым можно работать. Только такие запросы учитываются в статистике и расходуют оплаченный лимит.
• Иначе, если поле error заполнено — запрос требует вашего внимания. Текст ошибки рекомендуется сохранить или отправить для дальнейшего анализа.
• Иначе, если поле error не заполнено — это ошибка, связанная со стабильностью источника. В таком случае мы рекомендуем игнорировать ответ и повторить запрос.

В данном разделе описаны возможные коды ответов сервиса и их значения. Каждый код ответа сопровождается пояснением и примером JSON-ответа.

1. Код ответа - 200

• Поле success = 1 - удалось получить информацию от источника. Такие и только такие запросы можно запускать в дальнейшую обработку.
• Поле success = 0 - не удалось получить информацию от источника. Запрос не будет учтен в статистике. Необходимо повторить запрос.

2. Код ответа - 403

Выдается сервисом в случае невозможности обработки запроса из-за ограничения доступа: закончилась подписка, превышен лимит и так далее. Причины ошибок отражены в поле error ответа. Ниже приведен список возможных ошибок с их описанием и кодами:

• Invalid access key error_code = 40301 Указанный ключ доступа недействителен или отсутствует.
• The subscription period has expired error_code = 40302 Доступ к сервису истек, требуется продление.
• Invalid IP error_code = 40303 Запрос выполнен с IP-адреса, который не разрешён для доступа.
• Day limit of requests exceeded error_code = 40304 Достигнут оплаченный лимит запросов на день.
• Month limit of requests exceeded error_code = 40305 Достигнут оплаченный лимит запросов на месяц.

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

{
  "error": "Invalid access key",
  "error_code": 40301
}

3. Код ответа - 400

Выдается сервисом в случае невозможности обработки запроса из-за ошибки валидации запроса, неверного или отсутствующего значения какого-либо поля. Поле error_code всегда равно 40000, подробности доступны в поле error.

Возможные ошибки валидации:

• Field firstName is required - не указано имя
• Field patronymic is required - не указано отчество
• Field lastName is required - не указана фамилия
• Field dob is required - не указана дата рождения
• Field passportSeries is required - не указана серия паспорта
• Field passportNumber is required - не указан номер паспорта
• Field passportSeries is invalid - неверный формат серии паспорта (должно быть 4 цифры)
• Field passportNumber is invalid - неверный формат номера паспорта (должно быть 6 цифр)

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

{
  "error": "Field firstName is required",
  "error_code": 40000
}