Документация SUDRF API
Пять методов. Данные отдаются по токену: он передаётся в теле запроса полем token. Токен индивидуальный — не публикуйте его и передавайте только по HTTPS.
Базовый адрес: https://sou.kazna.tech. Машиночитаемая спецификация: openapi.json, интерактивная документация со Swagger UI: https://sou.kazna.tech/docs.
Методы
/api/search/cardКарточка дела по ссылке
Основной метод. Сервис скачивает карточку с сайта суда, приводит к единому виду и ставит дело на мониторинг. Повторный запрос возвращает актуальное движение.
| Параметр | Описание |
|---|---|
case_link | Ссылка на дело на сайте суда. Обязательное поле |
token | Индивидуальный токен доступа. Обязательное поле |
force | Перезапустить обработку принудительно, в том числе для не найденных ранее дел |
/api/searchПоиск дел по номеру
Когда ссылки нет, а номер известен. Поиск можно ограничить списком судов.
| Параметр | Описание |
|---|---|
case_number | Номер дела. Обязательное поле |
token | Индивидуальный токен доступа. Обязательное поле |
courts | Список доменов судов, среди которых искать. Необязательное поле |
/api/court/listСписок судов
Все подключённые суды: домен, вид, наименование. Метод открытый, токен не нужен.
/api/court/keys-detailСловарь ключей нормализации
Соответствие полей исходных сайтов полям нормализованной карточки. Нужен, когда важно понять, откуда взялось конкретное значение.
| Параметр | Описание |
|---|---|
filter | Фильтр по итоговому полю. Необязательное поле |
/api/status-updateСводный статус обработки
Состояние очереди: not_updated, parsing_now, unavailable_now. Полезно, когда источник недоступен и нужно понять, ждать или повторять.
Запрос и ответ
Пример обезличен: поля настоящие, значения заменены.
curl -X POST https://sou.kazna.tech/api/search/card \
-H "Content-Type: application/json" \
-d '{"case_link": "https://<суд>.sudrf.ru/...&case_uid=...",
"token": "<ваш токен>"}'
{
"status": "monitoring",
"info": {
"number": "2-1234/2026 ~ М-512/2026",
"court": { "name": "Центральный районный суд г. Воронежа", "kind": "default" },
"card": {
"instance": 1, "type": "Г",
"category": "Защита прав потребителей",
"judge": "И*** И. И.",
"sides": [
{ "sideType": "1", "nameSide": "ООО «Р***»", "inn": "366***", "ogrn": "112***" },
{ "sideType": "2", "nameSide": "К*** А. А." }
],
"events": [
{ "title": "Судебное заседание", "date": "27.02.2026",
"msk_datetime": "2026-02-27T12:10:00+03:00" }
],
"enforcement_orders": [ { "status": "Выдан", "date": "10.03.2026" } ],
"appeals": [ { "type": "Апелляционная жалоба", "result": "..." } ]
}
}
}Поля ответа
Состав полей зависит от того, что публикует конкретный суд: где-то нет категории, где-то не публикуются документы. Отсутствующее поле просто не приходит.
| Поле | Что содержит |
|---|---|
status | Состояние обработки: дело собрано, стоит на мониторинге, обрабатывается сейчас или недоступно у источника. |
info.number | Номер дела в том виде, в каком его публикует суд. |
info.court | Суд: наименование и вид (районный, мировой, военный и так далее). |
card.instance | Номер инстанции: первая, апелляция, кассация. |
card.type | Тип дела: гражданское, административное, уголовное. |
card.category | Категория дела по классификатору суда. |
card.judge | Судья, рассматривающий дело. |
card.sides[] | Стороны: тип участия, наименование или ФИО, ИНН, КПП, ОГРН, ОГРНИП — в том объёме, в каком их публикует суд. |
card.events[] | Движение дела: событие, дата, время, место, результат, основание и примечание. Время приводится к московскому. |
card.documents[] | Судебные акты и документы по делу, если суд их публикует. |
card.enforcement_orders[] | Исполнительные листы: статус и дата. |
card.appeals[] | Обжалования: вид жалобы и результат рассмотрения. |
Статусы и поведение при сбоях
Сайты судов медленные и часто недоступны. Сервис не отдаёт ошибку вместо данных: он возвращает состояние, по которому видно, что делать дальше.
| Состояние | Что значит |
|---|---|
parsing_now | Дело обрабатывается. Повторите запрос через несколько минут. |
monitoring | Дело собрано и стоит на отслеживании: события обновляются сами. |
not_updated | Обновление ещё не выполнялось. |
unavailable_now | Сайт суда сейчас недоступен. Сервис повторит попытку сам. |
Сводное состояние очереди отдаёт GET /api/status-update.
Получить токен
Опишите задачу и примерный объём: откроем тестовый доступ и поможем с подключением.