Сервис предоставляет два эндпоинта:
- /case — информация по делу;
- /hearings — список дел, назначенных к слушанию в суде на дату.
Получение информации по делу
Для получения информации по делу на сайте суда используйте следующий запрос:
https://parser-api.com/parser/sudrf_custom_api/case?key=ВАШ_КЛЮЧ_ДОСТУПА&url=URL_ДЕЛА
Параметры запроса:
- key — ключ доступа к сервису (обязательный).
- url — URL дела на сайте суда, обязательно urlencoded (обязательный).
Пример запроса:
https://parser-api.com/parser/sudrf_custom_api/case?key=ВАШ_КЛЮЧ_ДОСТУПА&url=https%3A%2F%2Fkrasnogorsk--mo.sudrf.ru%2Fmodules.php%3Fname%3Dsud_delo%26srv_num%3D1%26name_op%3Dcase%26case_id%3D142483664%26case_uid%3Dd0840c49-bdf4-46bd-9d21-2aee11910ccc%26delo_id%3D1540005%26new%3D
Пример ответа на запрос:
Ответ на запрос возвращается в формате JSON. Пример ответа:
{
"success": 1, // Флаг успешности выполнения запроса. При получении 0 сделайте повторный запрос сразу же или через несколько минут.
"type_title": "Производство по гражданским и административным делам", // тип производства
"case_title": "ДЕЛО № 2-632/2020 ~ М-608/2020", // заголовок дела
"court_title": "Алейский городской суд Алтайского края", // наименование суда
"court_address": "454000, г. Челябинск, ул.Кирова, д. 161", // адрес суда
"court_phone": "(351) 728-76-01, 728-76-51 (ф.)", // телефон суда
"court_email": "7kas@sudrf.ru", // email суда
"document_name": "Определение", // наименование документа
"document_url": "/modules.php?name=sud_delo&srv_num=1&name_op=doc&number=13423456&delo_id=4&new=4&text_number=1", // ссылка на документ
"documents": [ // судебные акты и иные документы по делу. В каждом элементе всегда есть name и одно из полей content или url — в зависимости от того, публикует суд текст документа прямо на странице дела или отдельной ссылкой
{
"name": "Судебный акт #1 (Определение)", // наименование документа
"content": "<HTML><HEAD><TITLE></TITLE></HEAD><BODY>...текст судебного акта...</BODY></HTML>" // текст документа в том виде (HTML), в котором его публикует суд
},
{
"name": "Решение", // наименование документа
"url": "/modules.php?name=sud_delo&srv_num=1&name_op=doc&number=13423456&delo_id=4&new=4&text_number=1" // ссылка на страницу с текстом документа. Ссылка относительная — для перехода добавьте к ней домен суда из url запроса
}
],
"attributes": [ // основные атрибуты дела
{
"name": "Уникальный идентификатор дела", // наименование
"value": "50RS0021-01-2019-004289-49" // значение
},
{
"name": "Дата поступления",
"value": "05.11.2019"
},
{
"name": "Номер по предыдущей регистрации",
"value": "2-5688/2019 ~ М-3554/2019"
},
{
"name": "Категория дела",
"value": "Отношения, связанные с защитой прав потребителей >О защите прав потребителей >- из договоров в сфере: >строительных и связанных с ними инженерных услуг"
},
{
"name": "Судья",
"value": "Брижевская И.П."
},
{
"name": "Признак рассмотрения дела",
"value": "Рассматривается единолично судьей"
}
],
"lower_court": [ // рассмотрение в нижестоящем суде (присутствует, если на странице дела есть такой раздел)
{
"name": "Регион суда первой инстанции", // наименование
"value": "06 - Республика Ингушетия" // значение
},
{
"name": "Суд (судебный участок) первой инстанции",
"value": "Верховный Суд Республики Ингушетия"
},
{
"name": "Номер дела в первой инстанции",
"value": "3-16/2026"
},
{
"name": "Судья (мировой судья) первой инстанции",
"value": "Коригова Марем Макшариповна"
}
],
"events": [ // движения дела
[
{
"name": "Наименование события", // наименование атрибута события
"value": "Регистрация иска (заявления, жалобы) в суде и принятие его к производству" // значение
},
{
"name": "Дата",
"value": "05.11.2019"
},
{
"name": "Время",
"value": "16:07"
},
{
"name": "Зал судебного заседания",
"value": ""
},
{
"name": "Результат события",
"value": ""
},
{
"name": "Основание для выбранного результата события",
"value": ""
},
{
"name": "Примечание",
"value": ""
},
{
"name": "Дата размещения",
"value": "08.11.2019"
}
]
],
"sides": [ // стороны
[
{
"name": "Вид лица, участвующего в деле", // наименование атрибута стороны
"value": "ОТВЕТЧИК" // значение
},
{
"name": "Фамилия / наименование",
"value": "ООО \"Экоквартал\""
},
{
"name": "ИНН",
"value": ""
},
{
"name": "КПП",
"value": ""
},
{
"name": "ОГРН",
"value": ""
},
{
"name": "ОГРНИП",
"value": ""
}
],
[
{
"name": "Вид лица, участвующего в деле",
"value": "ТРЕТЬЕ ЛИЦО"
},
{
"name": "Фамилия / наименование",
"value": "Фонд специальных проектов"
},
{
"name": "ИНН",
"value": ""
},
{
"name": "КПП",
"value": ""
},
{
"name": "ОГРН",
"value": ""
},
{
"name": "ОГРНИП",
"value": ""
}
],
[
{
"name": "Вид лица, участвующего в деле",
"value": "ИСТЕЦ"
},
{
"name": "Фамилия / наименование",
"value": "Шашина Марина Михайловна"
},
{
"name": "ИНН",
"value": ""
},
{
"name": "КПП",
"value": ""
},
{
"name": "ОГРН",
"value": ""
},
{
"name": "ОГРНИП",
"value": ""
}
]
],
"enforcement_orders": [ // исполнительные листы
[
{
"name": "Дата выдачи",
"value": "30.09.2020"
},
{
"name": "Серия, номер бланка",
"value": "ФС № 028683952"
},
{
"name": "Статус",
"value": "Выдан"
}
]
],
"appeals": [ // обжалования
[
{
"name": "Дата поступления",
"value": "28.09.2020"
},
{
"name": "Вид жалобы (представления)",
"value": "Апелляционная (кассационная до 2013г) жалоба"
},
{
"name": "Заявитель",
"value": "защитником (АДВОКАТОМ)"
},
{
"name": "Дата решения по поступившей жалобе",
"value": "28.09.2020"
},
{
"name": "Решение по поступившей жалобе",
"value": "Жалоба (предст.) ПРИНЯТА К РАССМОТРЕНИЮ"
}
]
]
}
Получение списка дел, назначенных к слушанию на дату
Для получения списка дел, назначенных к слушанию в суде на конкретную дату, используйте следующий запрос:
https://parser-api.com/parser/sudrf_custom_api/hearings?key=ВАШ_КЛЮЧ_ДОСТУПА&url=URL_СПИСКА_СЛУШАНИЙ
Параметры запроса:
- key — ключ доступа к сервису (обязательный).
- url — URL списка слушаний на сайте суда с параметром
H_date=ДД.ММ.ГГГГ, обязательно urlencoded (обязательный).
Пример запроса:
https://parser-api.com/parser/sudrf_custom_api/hearings?key=ВАШ_КЛЮЧ_ДОСТУПА&url=https%3A%2F%2F3ap.sudrf.ru%2Fmodules.php%3Fname%3Dsud_delo%26srv_num%3D1%26H_date%3D21.07.2026
Пример ответа на запрос:
{
"success": 1, // Флаг успешности выполнения запроса. При получении 0 сделайте повторный запрос сразу же или через несколько минут.
"date": "21.07.2026", // дата, на которую запрошен список слушаний
"count": 14, // количество слушаний в списке
"hearings": [ // список слушаний. Набор атрибутов повторяет колонки таблицы на сайте суда и может отличаться от суда к суду
[
{
"name": "№ п/п", // наименование атрибута слушания
"value": "1." // значение
},
{
"name": "Номер дела",
"value": "55-360/2026"
},
{
"name": "Номер дела, ссылка", // ссылка на страницу дела. Ссылка относительная — для перехода добавьте к ней домен суда из url запроса
"value": "/modules.php?name=sud_delo&srv_num=1&name_op=case&case_id=3883947&case_uid=5e582ea3-9335-4c65-ac93-361977557790&delo_id=4&new=4"
},
{
"name": "Время слушания",
"value": "10:00"
},
{
"name": "Место проведения (Зал судебного заседания)",
"value": "Зал судебного заседания №5"
},
{
"name": "Информация по делу",
"value": "Коваленко С.Н. - ст.105 ч.2 пп.д,ж УК РФ; Суд (судебный участок) первой инстанции: Ставропольский краевой суд Номер дела в первой инстанции: 2-2-16/2026"
},
{
"name": "Судья",
"value": "Овчинникова Алла Юрьевна"
},
{
"name": "Результат слушания",
"value": "ВЫНЕСЕНО РЕШЕНИЕ (ОПРЕДЕЛЕНИЕ)"
},
{
"name": "Судебные акты",
"value": ""
},
{
"name": "Категория", // раздел таблицы слушаний, к которому суд отнес дело
"value": "Уголовные дела - апелляция"
}
]
]
}
Если на выбранную дату в суде не назначено ни одного дела, сервис возвращает успешный ответ с пустым списком:
{
"success": 1,
"date": "19.07.2026",
"count": 0,
"hearings": []
}
Интерпретация ответа и обработка ошибок
Общие рекомендации:
- Если поле
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. Ниже приведен список возможных ошибок с их описанием и кодами:
- url must contain sudrf.ru/
error_code = 40001
Параметр url не содержит адрес сайта суда на sudrf.ru.
- url must contain H_date=DD.MM.YYYY
error_code = 40002
В запросе к /hearings параметр url не содержит дату слушаний H_date.
- Invalid endpoint
error_code = 40003
Запрошен несуществующий эндпоинт сервиса.
Пример ответа:
{
"error": "url must contain sudrf.ru/",
"error_code": 40001
}
