Интерфейс: /sudact API судебной практики: поиск актов и получение текста
Поиск судебных актов по тексту или номеру дела и получение текста найденного акта для вашего приложения. Поддержку фильтров и полноту конкретного ответа проверяйте по возможностям раздела и метаданным выдачи.
Что означает статус. Поиск и выгрузка текста открываются ключом. Путь проверки живости ключа не требует.
Строка из нашего реестра серверов: Ключ: api.atomno-mcp.ru/sudact
Как проверить подключение и сообщить об ошибке
Описание, опубликованный клиент и учебный пример сами по себе не подтверждают ответ источника. Статус на странице отражает сохранённые сведения о продукте, а не проверку в момент вашего посещения.
Происхождение сведений и правовые основания — в описании источников; возможности клиента и ограничения — на странице продукта.
- Сверьте состав данных и ограничения продукта. Возьмите адрес метода и способ авторизации из инструкции подключения.
- Проверьте ключ и разрешения. Ответ 401 или 403 требует проверки доступа; он сам по себе не означает, что источник недоступен. Ответ 200 от страницы документации или health-метода тоже не подтверждает получение данных.
- При выполнении своего разрешённого запроса проверьте дату данных, нужные поля и статус источника. Ошибка, пустой ответ и отсутствие совпадений — разные результаты.
Сообщить о проблеме с этим продуктом: укажите метод, время и текст ошибки без ключа и персональных данных. Форма также позволяет скопировать обращение для отправки по почте.
Что умеет API поиска по судебной практике
Доступны поиск актов арбитражных судов, судов общей юрисдикции и Верховного суда и получение текста найденной записи. Поиск включает мировых судей; полнота зависит от источника, суда и периода. Для части актов используется исторический локальный архив. Отдельно доступны ведомственные карточки ФАС, которые не гарантируют полный текст решения.
Для получения текста передайте cases[].case_id или url из выдачи поиска, а не номер дела. Полный текст есть не у каждой записи. HTTP 200 и пустой список сами по себе не доказывают полноту проверки: учитывайте warnings, partial_errors и метаданные поиска. Вывод о том, применил суд норму или только упомянул её, нельзя гарантировать автоматически; проверяйте подтверждения в ответе norm_evidence, если они есть.
Что сервис отдаёт
Поиск судебных актов и отдельный запрос текста выбранной записи. Полный текст доступен не у каждой записи; возможности фильтров зависят от раздела.
Инструменты MCP-клиента. HTTP-методы REST API приведены в разделе «Адреса запросов».
| Возможность | Что делает | Что подаётся | Что приходит |
|---|---|---|---|
| search_cases | Поиск актов арбитражных судов, судов общей юрисдикции и Верховного суда. Поддержку разделов и фильтров проверяйте через get_search_capabilities. | query?: str, court_type?: any|vs|arbitr|soyu|fas, instance?: str, norms?: list[str], date_from?: str, date_to?: str, limit?: int, page?: int, fas_body?: str, fas_law?: str, fas_act_type?: str, case_number?: str, court?: str, region?: str, judge?: str | dict[str, Any] — результат поиска подключённого API |
| search_fas_decisions | Поиск карточек ФАС по тексту или номеру дела с фильтрами ведомства. Карточка не гарантирует полный текст решения. | query: str, body?: str, law?: str, act_type?: str, date_from?: str, date_to?: str, limit?: int | dict[str, Any] — карточки ФАС и сведения ответа |
| get_citation | Текст найденного акта или карточки по url либо case_id из выдачи. Полный текст доступен не для каждой записи. | url?: str, case_id?: str, include_full_text?: bool, anonymize_level?: none|physical_persons|all_persons | dict[str, Any] — текст и сведения ответа |
| get_search_capabilities | Текущие разделы, поддерживаемые фильтры и доступность пагинации подключённого сервера. | Без параметров | dict[str, Any] — возможности поиска |
| resolve_court_name | Кандидаты судов по имени из ограниченной выборки карточек; неоднозначность сохраняется. Это не полный справочник судов. | name: str, court_type: arbitr|soyu|vs, query?: str, case_number?: str, limit?: int | dict[str, Any] — кандидаты судов |
- Ищите по query либо по case_number с одним разделом суда; номер дела не является идентификатором записи.
- limit — целое число 1–50, по умолчанию 10: это верхняя граница числа карточек, а не обещание получить столько совпадений.
- Фильтры зависят от раздела. Возможности сервера доступны через capabilities; ограничения постраничного поиска смотрите в справочнике REST.
- В norms передаётся массив строк. Первая норма попадает в поле статьи закона источника; гарантированное AND/OR не задаётся. Проверяйте search_meta.norm_filter.
- Текст запрашивается по case_id или url из cases[]. include_full_text управляет запросом текста, а anonymize_level — режимом обезличивания; проверяйте фактический результат.
Адреса запросов
| Метод | Путь | Ключ | Что делает |
|---|---|---|---|
| GET | /sudact/health | не нужен | Проверка живости и версия сервиса |
| GET | /sudact/v1/capabilities | X-API-Key | Разделы, фильтры и поддержка пагинации |
| POST | /sudact/v1/search | X-API-Key | Поиск судебных актов по тексту или номеру дела |
| POST | /sudact/v1/citation | X-API-Key | Текст найденного акта или карточки по case_id или url из выдачи |
Текст query необязателен и по умолчанию пуст; если задан — не короче трёх символов. Для поиска без него передайте case_number длиной 1–160 символов и один court_type: vs, arbitr или soyu. case_number — номер дела, а не case_id. Поддержка фильтров и page зависит от раздела; ограничения и примеры — в справочнике REST.
api.atomno-mcp.ru, формат JSON.
Полный URL метода и формат ошибки смотрите в инструкции подключения продукта.
X-API-Key. Примеры запросов
Пример содержит полный URL судебного метода. Это учебный запрос, а не текущий ответ сервиса.
Поиск дел по тексту
Учебный пример запроса в раздел arbitr; здесь он не выполняется. Подставьте свой ключ в X-API-Key и сверяйте параметры со справочником REST.
Правовое основание и источник данных
Публикация судебных актов — обязанность судов по федеральному закону, и объём открытых сведений определяем не мы.
Федеральный закон от 22.12.2008 № 262-ФЗ, части 1 и 2 статьи 15: тексты судебных актов размещаются в интернете в полном объёме. Часть 3 той же статьи: персональные данные, кроме фамилий и инициалов участников, исключают из публикуемых текстов сами суды.
Мы не восстанавливаем данные, которые суд убрал из публикуемого текста, и не пытаемся определить участников по косвенным признакам. Своей трактовки судебного акта мы тоже не даём: ни о виновности, ни об исходе спора — читатель видит те же реквизиты и тот же текст, что опубликовал суд.
По каждому реестру — норма, которая делает сведения открытыми, перечень полей и то, чего мы сознательно не берём: источники данных и правовые основания . Первоисточник этого сервиса — Арбитражные суды, суды общей юрисдикции и Верховный суд; отдельно — карточки ФАС . Atomno MCP не аффилирован с ним.
Чем это отличается от MCP-сервера
Данные одни и те же, отличается способ обращения. Обмен по HTTP разбирает ваш код, MCP-сервер — языковая модель внутри вашего продукта или редактора.
Берите обмен по HTTP, если
- Поиск по практике встроен в ваш юридический сервис как функция интерфейса.
- Нужно наполнить собственную базу решений по теме и обновлять её по расписанию.
- Тексты уходят в вашу поисковую систему, а не в диалог с моделью.
Берите MCP-сервер, если
- Юрист общается с ассистентом и просит подобрать практику по ситуации.
- Нужен разбор найденных решений языковой моделью сразу после поиска.
- Модель сама решает, углубиться ли в полный текст найденного дела.
Режим обезличивания задаётся при получении текста; фактический результат и ограничения проверяйте в ответе сервиса.
Вопросы и ответы
Чем это отличается от бесплатного поиска на сайтах судов?
Сколько результатов вернёт поиск?
Можно ли скрыть персональные данные в выгруженном тексте?
Как получить текст выбранного судебного акта?
Как искать судебные акты по норме права?
С чего начать, если по общему запросу слишком много результатов?
Купить доступ к судебной практике
API и MCP используют одну подписку. Выберите подходящий тариф; состав доступа и лимиты указаны на странице тарифов. Почта для писем: sales@atomno.com .
Выбрать тарифОтвет сервиса — сводка сведений из открытых государственных реестров на момент запроса, а не юридическое заключение. Недоступность источника мы не выдаём за отсутствие записей.
