Основные запросы
Основные запросы к сервису позволяют автоматизировать поиск на сайте pb.nalog.ru. Все запросы требуют указания ключа доступа (key).
1. Поиск по индивидуальным предпринимателям (ИП)
Для поиска информации об индивидуальных предпринимателях используйте следующий запрос:
https://parser-api.com/parser/nalog_pb_api/search_ip?key=ВАШ_КЛЮЧ&inn=ИНН
Параметры запроса:
- key — ключ доступа к сервису (обязательный).
- inn — ИНН индивидуального предпринимателя.
- ogrnip — ОГРНИП индивидуального предпринимателя.
- fio — ФИО индивидуального предпринимателя.
Обязательно должен быть указан хотя бы один из параметров поиска: inn, ogrnip или fio.
При поиске по inn или ogrnip возвращается один ИП с детальной информацией (поле status). При поиске по fio возвращается список ИП без детальной информации — чтобы получить детали по конкретной записи, повторите запрос по её 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 — ИНН юридического лица.
- ogrn — ОГРН юридического лица.
- query — наименование организации (поиск по названию).
Обязательно должен быть указан хотя бы один из параметров поиска: inn, ogrn или query.
При поиске по inn или ogrn возвращается одна организация с детальной информацией (поля address, status). При поиске по наименованию (query) возвращается список организаций без детальной информации — чтобы получить address и status по конкретной записи, повторите запрос по её 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=ВАШ_КЛЮЧ&fio=ФИО
Параметры запроса:
- key — ключ доступа к сервису (обязательный).
- inn — ИНН физического лица.
- fio — ФИО физического лица.
Обязательно должен быть указан хотя бы один из параметров поиска: inn или fio.
Пример ответа:
{
"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 — ФИО дисквалифицированного лица (обязательный).
Пример ответа:
{
"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 — ИНН физического лица.
- ogrn — ОГРН юридического лица.
- query — наименование организации (поиск по названию).
- fio — ФИО физического лица.
Обязательно должен быть указан хотя бы один из параметров поиска: inn, ogrn, query или fio.
Пример ответа:
{
"success": 1,
"limit_org": [ // массив найденных записей об ограничениях
{
"name": "ПЕТОВ ИВАН АЛЕКСЕЕВИЧ", // ФИО
"inn": "860315573220", // ИНН
"position": "Лицо, имеющее право без доверенности действовать от имени ООО \"НОРДЛАЙН\" - ДИРЕКТОР", // причастность к ЮЛ
"reason": "Причастность к ЮЛ, в отношении которого в ЕГРЮЛ внесена запись о недостоверности сведений об адресе ЮЛ", // причина ограничения
"start_date": "2021-01-27", // дата начала действия ограничения
"end_date": "2024-01-27", // дата окончания действия ограничения
"org_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"НОРДЛАЙН\"", // наименование ЮЛ
"org_inn": "8603222777" // ИНН ЮЛ
}
]
}
6. Поиск по адресам юридических лиц
Для поиска юридических лиц по адресу регистрации используйте следующий запрос:
https://parser-api.com/parser/nalog_pb_api/search_addr?key=ВАШ_КЛЮЧ&address=АДРЕС
Параметры запроса:
- key — ключ доступа к сервису (обязательный).
- address — адрес или его часть для поиска (обязательный).
- regionID — код субъекта РФ для уточнения поиска (необязательный).
Пример ответа:
{
"success": 1,
"addr": [ // массив найденных адресов
{
"address": "Г.МОСКВА, ПР-КТ ЛЕНИНГРАДСКИЙ, Д. 80", // адрес
"count": 15 // количество ЮЛ, зарегистрированных по данному адресу
}
]
}
Интерпретация ответа и обработка ошибок
Общие рекомендации:
- Если поле
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.
Возможные ошибки:
- Empty request. Please provide {param_list}
error_code = 40001
Не указан ни один из параметров поиска для выбранного метода (например, Empty request. Please provide inn, ogrn or query).
- Invalid request type
error_code = 40001
Запрос отправлен на несуществующую точку входа.
Пример ответа:
{
"error": "Empty request. Please provide inn, ogrn or query",
"error_code": 40001
}
