Основные запросы
Основные запросы к сервису позволяют автоматизировать поиск на сайте 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, citizenship, registration_date, реквизиты налоговых органов, okved_additional, msp, tax_modes). При поиске по fio возвращается список ИП без детальной информации — чтобы получить детали по конкретной записи, повторите запрос по её inn.
Пример ответа:
{
"success": 1, // флаг успешности выполнения запроса (1 — успешно, 0 — ошибка)
"ip": [ // массив найденных записей об индивидуальных предпринимателях
{
"ogrn": "304550435800434", // ОГРНИП
"inn": "550106065148", // ИНН
"okved": "49.4", // код основного ОКВЭД
"okved_name": "Деятельность автомобильного грузового транспорта и услуги по перевозкам", // наименование основного ОКВЭД
"name": "АНДРЕЙЧЕНКО СЕРГЕЙ АЛЕКСАНДРОВИЧ", // ФИО индивидуального предпринимателя
// --- поля ниже присутствуют только при поиске по inn/ogrnip (детальная карточка) ---
"status": "Действующее", // статус (Действующее / Прекратило деятельность)
"citizenship": "гражданин Российской Федерации", // сведения о гражданстве (гражданин Российской Федерации / иностранный гражданин / лица без гражданства)
"registration_date": "2004-12-23", // дата присвоения ОГРНИП
"tax_registration_date": "2026-06-15", // дата постановки на учёт в налоговом органе
"reg_authority": { // налоговый орган, осуществивший регистрацию по месту жительства
"code": 5543, // код
"name": "Межрайонная инспекция Федеральной налоговой службы № 12 по Омской области" // наименование
},
"tax_authority": { // налоговый орган по месту постановки на учёт
"code": 5503,
"name": "Межрайонная инспекция Федеральной налоговой службы № 1 по Омской области"
},
"okved_additional": [ // дополнительные виды деятельности (ОКВЭД, заявительные)
{ "code": "41.20", "name": "Строительство жилых и нежилых зданий" },
{ "code": "45.2", "name": "Техническое обслуживание и ремонт автотранспортных средств" }
// ... остальные коды
],
"msp": { // сведения о субъекте МСП (null, если не в реестре)
"category": "Микропредприятие", // категория (Микропредприятие / Малое предприятие / Среднее предприятие)
"date": "2016-08-01" // дата внесения в реестр субъектов МСП
},
"tax_modes": ["Автоматизированная упрощенная система налогообложения"] // применяемые специальные налоговые режимы; пустой массив — не применяются
}
]
}
Возможные значения tax_modes (наименования соответствуют формулировкам pb.nalog.ru): «Упрощенная система налогообложения», «Единый сельскохозяйственный налог», «Патентная система налогообложения», «Налог на профессиональный доход», «Автоматизированная упрощенная система налогообложения», «Единый налог на вменённый доход», «Соглашение о разделе продукции».
2. Поиск по организациям (ЮЛ)
Для поиска информации о юридических лицах используйте следующий запрос:
https://parser-api.com/parser/nalog_pb_api/search_org?key=ВАШ_КЛЮЧ&inn=ИНН
Параметры запроса:
- key — ключ доступа к сервису (обязательный).
- inn — ИНН юридического лица.
- ogrn — ОГРН юридического лица.
- query — наименование организации (поиск по названию).
Обязательно должен быть указан хотя бы один из параметров поиска: inn, ogrn или query.
При поиске по inn или ogrn возвращается одна организация с детальной информацией (реквизиты, руководитель, учредители, финансовые сведения и т.д.). При поиске по наименованию (query) возвращается список организаций без детальной информации — чтобы получить детали по конкретной записи, повторите запрос по её inn.
Все суммы (authorized_capital, income, expense, sum, arrear_sum и др.) указаны в рублях.
{
"success": 1,
"org": [ // массив найденных организаций
{
"inn": "7743225906", // ИНН
"okved": "43.12", // код основного ОКВЭД
"okved_name": "Подготовка строительной площадки", // наименование основного ОКВЭД
"name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВЕЛЕС\"", // полное наименование ЮЛ
"name_short": "ООО \"ВЕЛЕС\"", // краткое наименование ЮЛ
"address": "125315, Г.МОСКВА, ПР-КТ ЛЕНИНГРАДСКИЙ, Д. 80, К. Г, Э/П/К/ОФ ТЕХ/XII/13/А3Д", // юридический адрес
// --- поля ниже присутствуют только при поиске по inn/ogrn (детальная карточка) ---
"status": "Действующая организация", // статус
"ogrn": "1177746974833", // ОГРН
"kpp": "774301001", // КПП
"registration_date": "2017-09-18", // дата регистрации (присвоения ОГРН)
"tax_registration_date": "2017-09-18", // дата постановки на учёт в налоговом органе
"formation_method": "Создание юридического лица", // способ образования
"reg_authority": { // налоговый орган, осуществивший регистрацию по месту нахождения
"code": 7746,
"name": "Межрайонная инспекция Федеральной налоговой службы № 46 по г. Москве"
},
"tax_authority": { // налоговый орган по месту постановки на учёт
"code": 7743,
"name": "Инспекция Федеральной налоговой службы № 43 по г. Москве"
},
"authorized_capital": 10000, // размер капитала (руб.)
"capital_type": "УСТАВНЫЙ КАПИТАЛ", // вид капитала (уставный / складочный / уставный фонд / паевые взносы)
"okved_additional": [ // дополнительные виды деятельности (ОКВЭД, заявительные)
{ "code": "33.12", "name": "Ремонт машин и оборудования" },
{ "code": "41.10", "name": "Разработка строительных проектов" }
// ... остальные коды
],
"msp": { // сведения о субъекте МСП (null, если не в реестре)
"category": "Малое предприятие", // категория (Микропредприятие / Малое предприятие / Среднее предприятие)
"date": "2017-10-10" // дата внесения в реестр субъектов МСП
},
"tax_modes": [], // применяемые специальные налоговые режимы (значения — см. раздел ИП); пустой массив — ОСНО / режимы не применяются
"director": [ // сведения о лицах, имеющих право без доверенности действовать от имени ЮЛ
{
"inn": "773313082272", // ИНН
"name": "ЛАЗАРЕВ РУСЛАН НИКОЛАЕВИЧ", // ФИО
"position": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР", // должность
"count": 1 // количество ЮЛ, в которых лицо является руководителем
}
],
"owner": [ // сведения об учредителях (участниках, единственном акционере)
{
"inn": "773313082272", // ИНН
"name": "ЛАЗАРЕВ РУСЛАН НИКОЛАЕВИЧ", // ФИО
"count": 1 // количество ЮЛ, в которых лицо является учредителем
}
],
"income_expenses": [ // суммы доходов и расходов по данным бухгалтерской отчётности, по годам
{ "year": 2025, "income": 91831000, "expense": 94259000 },
{ "year": 2024, "income": 177802000, "expense": 152937000 }
],
"avg_headcount": [ // среднесписочная численность работников, по годам
{ "year": 2025, "count": 15 },
{ "year": 2024, "count": 19 }
],
"taxes_paid": [ // уплаченные налоги и сборы, по годам и КБК
{ "year": 2025, "kbk": "Р.3.", "kbk_name": "Транспортный налог", "sum": 80372 }
// ... остальные записи
],
"arrears": [ // недоимка и задолженность по пеням и штрафам, по периодам и КБК
{
"year": 2026,
"period": 6, // номер периода (месяц)
"kbk": "Ф.3.",
"kbk_name": "Налог на добавленную стоимость",
"arrear_sum": 1755387, // недоимка
"penalty_sum": 0, // пени
"fine_sum": 0, // штрафы
"total_sum": 1755387 // итого
}
// ... остальные записи
],
"offenses": [ // сведения о налоговых правонарушениях: по одной записи на год с суммой штрафа. Пустой массив — нарушений нет
{ "year": 2024, "fine_sum": 15000 } // fine_sum — общая сумма штрафа за год, руб.
],
"has_bailiff_debt": false, // наличие превышающей 1000 руб. задолженности, направленной на взыскание судебному приставу
"has_no_reporting": false, // непредставление налоговой отчётности более года
"flags_date": "2026-06-01" // дата актуальности сведений has_bailiff_debt и has_no_reporting
}
]
}
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
}
