Skip to content

Получение ИНН по ФИО и номеру паспорта

getInnFast

Тип HTTP запроса: POST

URL вызова: https://api.id-x.org/idx/api2/getInnFast

Поддерживаются следующие форматы передачи параметров:

  • JSON, Content-Type: application/json

  • Form submit, Content-Type: application/x-www-form-urlencoded

Параметры:

Параметр Тип Обязательный Описание
accessKey String Да Ключ доступа, выданный при регистрации в Системе IDX
secretKey String Да Секретный ключ, выданный при регистрации в Системе IDX
lastName String Да Фамилия
firstName String Да Имя
midName String Нет Отчество (при наличии)
birthDate String Да Дата рождения в формате DD.MM.YYYY
passportNumber String Да Номер паспорта, серия и номер слитно без разделителей
passportDate String Нет Дата выдачи паспорта в формате DD.MM.YYYY

Функция возвращает:

Параметр Тип Обязательный Описание
resultCode Int Да Результат выполнения функции (0 – успешное завершение функции, -100 – данные не найдены, иные значения – ошибка выполнения)
resultMessage String Нет Сообщение об ошибке
operationToken String Нет Уникальный идентификатор операции
inn String Нет В случае успешного завершения возвращается ИНН

Пример вызова:

POST /idx/api2/getInnFast
Host: api.id-x.org
Content-Type: application/json
Accept: application/json

{
    "accessKey": "выданный accessKey",
    "secretKey": "выданный secretKey",
    "lastName": "Иванов",
    "firstName": "Иван",
    "midName": "Иванович",
    "birthDate": "20.01.1970",
    "passportNumber":"1234567890",
    "passportDate": "22.12.2000"
}

Пример успешного ответа, когда ИНН найден:

{
    "resultCode": 0,
    "operationToken": "a71db75acd354bb2b9f1e444e9dfa209",
    "inn": “123456789012”
}

Пример успешного ответа, когда ИНН не найден:

{
    "resultCode": -100,
    "operationToken": "fcf9b710155e485499cc53e8d6601228",
    "inn": “”
}

Пример неуспешного ответа:

{
    "resultCode": -25,
    "resultMessage": "Ошибка при подключении/обращении к поставщику сервиса"
}