Основные запросы
Основные запросы к сервису позволяют выполнять поиск по различным типам данных и получать детальную информацию. Все запросы требуют указания ключа доступа (key). Для запросов поиска можно использовать параметр fizRegionID или orgRegionID (ID региона) — если он не указан, поиск будет выполнен по всем регионам. Список регионов можно получить с помощью справочного запроса (см. раздел Справочные запросы).
1. Поиск по базе физических лиц
https://parser-api.com/parser/fedresurs_api/search_fiz?key=ВАШ_КЛЮЧ_ДОСТУПА&lastName=ФАМИЛИЯ&firstName=ИМЯ
Параметры:
- lastName - фамилия
- firstName - имя
- patronymic - отчество
- fizAddress - адрес
- fizCode - код: ИНН, ОГРНИП или СНИЛС
- fizRegionID - ID региона поиска. Список регионов можно получить с помощью справочного запроса
- fizCategoryID - ID категории физического лица. Список категорий можно получить с помощью справочного запроса
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"total_count": "245", // общее число найденных записей
"records": [
{
"category": "Физическое лицо", // Категория должника
"debtor": "Петров Алексей Сергеевич", // ФИО должника
"inn": "301110252258", // ИНН
"ogrn": "315618400012345", // ОГРНИП (для ИП)
"snils": "153-649-617 88", // СНИЛС
"region": "Астраханская область", // Регион
"address": "416247, Астраханская обл., г. Камызяк, ул. Ленина, д. 25", // Адрес
"id": "B033421DBEEC3E0AC5E4057B08BA3858" // идентификатор для запроса детальной информации или списка сообщений
}
]
}
2. Поиск по базе юридических лиц
https://parser-api.com/parser/fedresurs_api/search_ur?key=ВАШ_КЛЮЧ_ДОСТУПА&orgName=НАИМЕНОВАНИЕ
Параметры:
- orgName - наименование организации для поиска
- orgAddress - адрес
- orgCode - код: ОКПО, ИНН или ОГРН
- orgRegionID - ID региона поиска. Список регионов можно получить с помощью справочного запроса
- orgCategoryID - ID категории организации. Список категорий можно получить с помощью справочного запроса
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"total_count": "87", // общее число найденных записей
"records": [
{
"category": "Обычная организация", // Категория должника
"debtor": "ДАЧНОЕ НЕКОММЕРЧЕСКОЕ ТОВАРИЩЕСТВО \"ВАСИЛЕК\" С ПРАВОМ ПРОПИСКИ", // Наименование должника
"inn": "6101037720", // ИНН
"ogrn": "1066100042843", // ОГРН
"region": "Ростовская область", // Регион
"address": "Ростовская обл., Азовский р-н, п. Овощной, д. 73", // Адрес
"id": "69F4C34B68D37E2800A4913941096D2E" // идентификатор для запроса детальной информации или списка сообщений
}
]
}
3. Поиск по базе арбитражных управляющих
https://parser-api.com/parser/fedresurs_api/search_manager?key=ВАШ_КЛЮЧ_ДОСТУПА&lastName=ФАМИЛИЯ
Параметры:
- lastName - фамилия
- firstName - имя
- patronymic - отчество
- regNum - номер в реестре
- sroID - идентификатор СРО
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"total_count": "152", // общее число найденных записей
"records": [
{
"name": "Смирнов Владимир Петрович", // ФИО арбитражного управляющего
"reg_num": "", // Регистрационный номер
"date_registered": "", // Дата регистрации в Росреестре
"sro": "Не состоит в СРО", // Наименование СРО
"message_count": "268", // Количество сообщений
"id": "06f1216e-1eda-4be0-b395-a4ad26e3f872" // идентификатор для запроса детальной информации или списка сообщений
}
]
}
4. Получение детальной информации о юридическом лице
https://parser-api.com/parser/fedresurs_api/get_org?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ИДЕНТИФИКАТОР
Параметры:
- id - идентификатор организации (обязательный). Получается из результата поиска
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"record": {
"name": "ДНТ \"ВАСИЛЕК\"", // Краткое наименование
"full_name": "ДАЧНОЕ НЕКОММЕРЧЕСКОЕ ТОВАРИЩЕСТВО \"ВАСИЛЕК\" С ПРАВОМ ПРОПИСКИ", // Полное наименование
"address": "Ростовская обл., Азовский р-н, п. Овощной, д. 73", // Адрес
"phone": "", // Телефон
"region": "Ростовская область", // Регион ведения дела о банкротстве
"category": "Обычная организация", // Категория должника
"inn": "6101037720", // ИНН
"ogrn": "1066100042843", // ОГРН
"okpo": "12345678", // ОКПО
"form": "Садоводческие, огороднические или дачные некоммерческие товарищества" // Организационно-правовая форма
}
}
5. Получение детальной информации о физическом лице
https://parser-api.com/parser/fedresurs_api/get_person?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ИДЕНТИФИКАТОР
Параметры:
- id - идентификатор физического лица (обязательный). Получается из результата поиска
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"record": {
"last_name": "Петров", // Фамилия
"first_name": "Алексей", // Имя
"second_name": "Сергеевич", // Отчество
"dob": "23.02.1992", // Дата рождения
"birthplace": "с. Солодники Черноярского р-на Астраханской обл.", // Место рождения
"phone": "", // Телефон
"region": "Астраханская область", // Регион ведения дела о банкротстве
"inn": "301110252258", // ИНН
"ogrnip": "315618400012345", // ОГРНИП
"snils": "153-649-617 88", // СНИЛС
"prev_name": "", // Ранее имевшиеся ФИО
"category": "Физическое лицо", // Категория должника
"address": "416247, Астраханская обл., г. Камызяк, ул. Ленина, д. 25", // Место жительства
"additional_info": "", // Дополнительная информация
"is_trades_tab": 0 // 1 - присутствует вкладка Торги, 0 - отсутствует
}
}
6. Получение детальной информации об арбитражном управляющем
https://parser-api.com/parser/fedresurs_api/get_manager?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ИДЕНТИФИКАТОР
Параметры:
- id - идентификатор арбитражного управляющего (обязательный). Получается из результата поиска
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"messages_count": "1162", // количество сообщений
"record": {
"last_name": "Смирнов", // Фамилия
"first_name": "Константин", // Имя
"second_name": "Петрович", // Отчество
"inn": "614110320620", // ИНН
"reg_number": "14835", // Регистрационный номер
"date_registered": "05.10.2016", // Дата регистрации в Росреестре
"sro": "ААУ \"ЦФОП АПК\" - Ассоциация арбитражных управляющих \"Центр финансового оздоровления предприятий агропромышленного комплекса\"", // Наименование СРО
"sro_id": "72499a1b-120d-4e2e-b595-2a1b9f4ae70d", // идентификатор СРО для получения детальной информации
"date_entered": "14.07.2016" // Дата вступления в СРО
}
}
7. Получение детальной информации о СРО
https://parser-api.com/parser/fedresurs_api/get_sro?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ИДЕНТИФИКАТОР
Параметры:
- id - идентификатор СРО (обязательный). Получается из детальной информации об арбитражном управляющем
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"record": {
"name": "ААУ \"ЦФОП АПК\" - Ассоциация арбитражных управляющих \"Центр финансового оздоровления предприятий агропромышленного комплекса\"", // Наименование
"reg_number": "0032", // Регистрационный номер
"date_registered": "29.12.2010", // Дата регистрации
"inn": "7707030411", // ИНН
"ogrn": "1107799002057", // ОГРН
"date_registered_rosreestr": "22.11.2010", // Дата регистрации в Росреестре
"address_sro": "107031, г Москва, ул. Б. Дмитровка, д. 32, стр. 1", // Юридический адрес по данным СРО
"address_rosreestr": "107996, г. Москва, ул. Б. Дмитровка, д. 32, стр. 1", // Юридический адрес по данным Росреестра
"address_post": "107031, г. Москва, ул. Б. Дмитровка, д. 32, стр. 1", // Почтовый адрес
"phone": "8(495)668-09-90, 8(495) 668-09-91", // Телефон/Факс
"email": "partnerapk@partnerapk.ru", // Адрес электронной почты
"site": "www.partnerapk.ru", // Адрес в интернете
"director": "Полонянкин Андрей Викторович", // Руководитель
"contact_person": "Иванова Мария Петровна", // Контактное лицо
"manager_count": "463" // Количество управляющих
}
}
8. Получение списка сообщений юридического лица
https://parser-api.com/parser/fedresurs_api/get_org_messages?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ИДЕНТИФИКАТОР
Параметры:
- id - идентификатор организации (обязательный). Получается из результата поиска
- from_record - номер записи, с которой начинать выборку. Используется для постраничной навигации
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"total_count": "327", // общее количество сообщений
"records": [
{
"id": "2EA27B840541E8E81A14D50B68BE85C8", // идентификатор сообщения для запроса детальной информации
"date": "16.10.2025 14:48:09", // Дата публикации
"type": "Сообщение о собрании кредиторов", // Тип сообщения
"manager_name": "Смирнов Константин Петрович", // ФИО арбитражного управляющего
"manager_id": "91997569-a6c8-4c9f-9c67-7b9d39cbfd3d" // идентификатор арбитражного управляющего
}
]
}
9. Получение списка сообщений физического лица
https://parser-api.com/parser/fedresurs_api/get_person_messages?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ИДЕНТИФИКАТОР
Параметры:
- id - идентификатор физического лица (обязательный). Получается из результата поиска
- from_record - номер записи, с которой начинать выборку. Используется для постраничной навигации
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"total_count": "156", // общее количество сообщений
"records": [
{
"id": "2EA27B840541E8E81A14D50B68BE85C8", // идентификатор сообщения для запроса детальной информации
"date": "16.10.2025 14:48:09", // Дата публикации
"type": "Сообщение о собрании кредиторов", // Тип сообщения
"manager_name": "Смирнов Константин Петрович", // ФИО арбитражного управляющего
"manager_id": "91997569-a6c8-4c9f-9c67-7b9d39cbfd3d" // идентификатор арбитражного управляющего
}
]
}
10. Получение списка сообщений арбитражного управляющего
https://parser-api.com/parser/fedresurs_api/get_manager_messages?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ИДЕНТИФИКАТОР
Параметры:
- id - идентификатор арбитражного управляющего (обязательный). Получается из результата поиска
- from_record - номер записи, с которой начинать выборку. Используется для постраничной навигации
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"total_count": "1162", // общее количество сообщений
"records": [
{
"id": "2EA27B840541E8E81A14D50B68BE85C8", // идентификатор сообщения для запроса детальной информации
"date": "16.10.2025 14:48:09", // Дата публикации
"type": "Сообщение о собрании кредиторов", // Тип сообщения
"debtor_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВАСИЛЕК\"", // Наименование/ФИО должника
"debtor_id": "A9EDCD59625A318B5844906167B6B047" // идентификатор должника
}
]
}
11. Получение детальной информации о сообщении
https://parser-api.com/parser/fedresurs_api/get_message?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ИДЕНТИФИКАТОР
Параметры:
- id - идентификатор сообщения (обязательный). Получается из списка сообщений
Результат:
{
"success": 1, // 1 - успешный ответ, 0 - ошибка
"record": {
"id": "2EA27B840541E8E81A14D50B68BE85C8", // идентификатор сообщения
"act": "о завершении конкурсного производства", // Судебный акт
"act_type": "", // Тип судебного акта
"num": "4898769", // Номер сообщения
"date_published": "09.04.2020", // Дата публикации
"type": "Сообщение о судебном акте", // Тип сообщения
"debtor_name": "ДАЧНОЕ НЕКОММЕРЧЕСКОЕ ТОВАРИЩЕСТВО \"ВАСИЛЕК\" С ПРАВОМ ПРОПИСКИ", // Наименование/ФИО должника
"debtor_inn": "6101037720", // ИНН должника
"case_num": "А53-32631/2016", // Номер дела
"manager_name": "Смирнов Константин Петрович (ИНН 614110320620, СНИЛС 145-659-767 11)", // ФИО арбитражного управляющего
"text": "Решением Арбитражного суда Ростовской области по делу №А53–32631/2016 от 12.10.2017 в отношении дачного некоммерческого товарищества «Василек» введена процедура банкротства – конкурсное производство, должник признан банкротом...", // Текст сообщения
"relative_not_actual_id": null, // Идентификатор связанного аннулированного сообщения
"is_actual": 1, // 1 - не аннулировано, 0 - аннулировано
"dob": "15.03.1985", // Дата рождения должника (для физ. лиц)
"snils": "123-456-789 00" // СНИЛС должника (для физ. лиц)
}
}
Дополнительные поля для сообщений о проведении торгов:
{
"trade_type": "Вид торгов",
"trade_place": "Место проведения торгов",
"trade_app_start_date": "Дата и время начала подачи заявок",
"trade_app_end_date": "Дата и время окончания подачи заявок",
"lots": [
{
"num": "Номер лота",
"description": "Описание",
"start_price": "Начальная цена",
"step": "Шаг",
"deposit": "Задаток",
"type": "Классификация имущества"
}
]
}
Справочные запросы
Справочные запросы предоставляют дополнительную информацию, необходимую для работы с основными запросами.
1. Получение списка регионов
https://parser-api.com/parser/fedresurs_api/get_regions?key=ВАШ_КЛЮЧ_ДОСТУПА
Сокращенный пример ответа:
{
"1": "Алтайский край",
"10": "Амурская область",
"11": "Архангельская область"
}
2. Получение категорий физических лиц
https://parser-api.com/parser/fedresurs_api/get_fiz_categories?key=ВАШ_КЛЮЧ_ДОСТУПА
Пример ответа:
{
"9": "Индивидуальный предприниматель",
"22": "Физическое лицо",
"10": "Крестьянское (фермерское) хозяйство",
"12": "Отсутствующий должник"
}
3. Получение категорий юридических лиц
https://parser-api.com/parser/fedresurs_api/get_org_categories?key=ВАШ_КЛЮЧ_ДОСТУПА
Пример ответа:
{
"1": "Обычная организация",
"2": "Градообразующая организация",
"3": "Сельскохозяйственная организация",
"4": "Кредитная организация",
"23": "Негосударственный пенсионный фонд"
}
Интерпретация ответа и обработка ошибок
Общие рекомендации:
- Если поле
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.
Пример ответа:
{
"error": "Empty id",
"error_code": 40001
}