Основные запросы

Основные запросы к сервису позволяют автоматизировать поиск на сайте pb.nalog.ru. Все запросы требуют указания ключа доступа (key).

1. Поиск по индивидуальным предпринимателям (ИП)

Для поиска информации об индивидуальных предпринимателях по ИНН используйте следующий запрос:

https://parser-api.com/parser/nalog_pb_api/search_ip?key=ВАШ_КЛЮЧ&inn=ИНН

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

• key — ключ доступа к сервису (обязательный).
• inn — ИНН индивидуального предпринимателя (обязательный).

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

{
  "success": 1, // флаг успешности выполнения запроса (1 — успешно, 0 — ошибка)
  "ip": [ // массив найденных записей об индивидуальных предпринимателях
    {
      "ogrn": "319470400052172", // ОГРН
      "inn": "470700161305", // ИНН
      "okved": "47.29", // код ОКВЭД
      "okved_name": "Торговля розничная прочими пищевыми продуктами в специализированных магазинах", // наименование ОКВЭД
      "name": "АВАНЕСЯН ВАЗГЕН ИВАНИ" // ФИО индивидуального предпринимателя
    }
  ]
}

2. Поиск по организациям (ЮЛ)

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

https://parser-api.com/parser/nalog_pb_api/search_org?key=ВАШ_КЛЮЧ&inn=ИНН

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

• key — ключ доступа к сервису (обязательный).
• inn — ИНН юридического лица (обязательный).

{
  "success": 1,
  "org": [ // массив найденных организаций
    {
      "inn": "7743225906", // ИНН
      "okved": "43.12", // код ОКВЭД
      "okved_name": "Подготовка строительной площадки", // наименование ОКВЭД
      "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВЕЛЕС\"", // полное наименование ЮЛ
      "name_short": "ООО \"ВЕЛЕС\"", // краткое наименование ЮЛ
      "address": "125315, Г.МОСКВА, ПР-КТ ЛЕНИНГРАДСКИЙ, Д. 80, К. Г, Э/П/К/ОФ ТЕХ/XII/13/А3Д", // юридический адрес
      "status": "Действующее" // статус
    }
  ]
}

3. Поиск по руководителям и учредителям юридических лиц

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

https://parser-api.com/parser/nalog_pb_api/search_fiz?key=ВАШ_КЛЮЧ&inn=ИНН

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

• key — ключ доступа к сервису (обязательный).
• inn — ИНН физического лица (обязательный).

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

{
  "success": 1,
  "director": [ // массив найденных руководителей
    {
      "inn": "470700161305", // ИНН
      "name": "АВАНЕСЯН ВАЗГЕН ИВАНИ", // ФИО
      "count": 1 // количество компаний, в которых лицо является руководителем
    }
  ],
  "owner": [ // массив найденных учредителей
    {
      "inn": "470700161305", // ИНН
      "name": "АВАНЕСЯН ВАЗГЕН ИВАНИ", // ФИО
      "count": 1 // количество компаний, в которых лицо является учредителем
    }
  ]
}

4. Поиск по реестру дисквалифицированных лиц

Для поиска информации в реестре дисквалифицированных лиц по ФИО используйте следующий запрос:

https://parser-api.com/parser/nalog_pb_api/search_dis?key=ВАШ_КЛЮЧ&fio=ФИО

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

• key — ключ доступа к сервису (обязательный).
• fio — ФИО дисквалифицированного лица (обязательный, рекомендуется использовать URL-кодирование).

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

{
  "success": 1,
  "dis": [ // массив найденных записей о дисквалифицированных лицах
    {
      "number": "227700065344", // номер записи в реестре
      "name": "ГОБУЗОВ ИВАН ЮРЬЕВИЧ", // ФИО дисквалифицированного лица
      "date_of_birth": "1982-05-29", // дата рождения
      "place_of_birth": "ГОРОД ХАБАРОВСК", // место рождения
      "name_org": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"БРИЗ\"", // организация
      "position": "УЧРЕДИТЕЛЬ", // должность
      "article": "Ч.5 СТ. 14.25 КОАП РФ", // статья КоАП РФ
      "creator": "МИФНС РОССИИ №46 ПО Г.МОСКВЕ", // орган, составивший протокол
      "court": "СУ №164 РАЙОНА ЮЖНОЕ ТУШИНО ГОРОДА МОСКВЫ БАРАННИКОВА Е.", // суд
      "period": "2 г. 0 м. 0 д.", // период дисквалификации
      "start_date": "2022-06-15", // дата начала дисквалификации
      "end_date": "2024-06-14" // дата окончания дисквалификации
    }
  ]
}

5. Поиск по ограничениям в юридических лицах

Для поиска информации об ограничениях, связанных с юридическими лицами, по ИНН используйте следующий запрос:

https://parser-api.com/parser/nalog_pb_api/search_limit_org?key=ВАШ_КЛЮЧ&inn=ИНН

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

• key — ключ доступа к сервису (обязательный).
• inn — ИНН физического лица (обязательный).

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

{
  "success": 1,
  "limit_org": [ // массив найденных записей об ограничениях
    {
      "name": "ПЕТОВ ИВАН АЛЕКСЕЕВИЧ", // ФИО
      "inn": "860315573220", // ИНН
      "position": "Лицо, имеющее право без доверенности действовать от имени ООО \"НОРДЛАЙН\" - ДИРЕКТОР", // причастность к ЮЛ
      "reason": "Причастность к ЮЛ, в отношении которого в ЕГРЮЛ внесена запись о недостоверности сведений об адресе ЮЛ", // причина ограничения
      "start_date": "2021-01-27", // дата начала действия ограничения
      "end_date": "2024-01-27", // дата окончания действия ограничения
      "org_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"НОРДЛАЙН\"", // наименование ЮЛ
      "org_inn": "8603222777" // ИНН ЮЛ
    }
  ]
}

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

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

• Если поле 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 всегда равно 40001, подробности доступны в поле error.

Возможные ошибки:

• Field {field_name} is required error_code = 40001 Отсутствует обязательное поле в запросе.

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

{
  "error": "Field inn is required",
  "error_code": 40001
}