Справочник

Фильтры практики

Страница сформирована из манифеста шлюза GET /v1/tools

Фильтры передаются объектом filters в /v1/practice/search, /v1/search (слой practice), /v1/research, /v1/answer, /v1/practice/list и /v1/practice/facets. Какие фильтры фактически применены, видно по полю filters_applied ответа. Значения перечислений передавайте буква в букву, как в таблице: шлюз сравнивает их точно, другое написание вернет 422.

JSON

{
  "filters": {
    "instance": "апелляция",
    "date_from": "2025-01-01",
    "norm": {
      "law_key": "237-ФЗ",
      "article": "22.1"
    }
  }
}

Фильтры

Фильтр	Тип	Описание
`title`	строка	Подстрока в названии документа
`number`	строка	Точный номер документа (напр. `88а-10365/2026`)
`case_number`	строка	Точное сохраненное значение реквизита номера дела/производства из источника; его роль указана в `case_number_kind`
`case_number_kind`	enum	Роль реквизита `case_number`: `proceeding` \| `first_instance` \| `unknown`
`date_from`	дата YYYY-MM-DD	Принят не раньше
`date_to`	дата YYYY-MM-DD	Принят не позже
`court`	строка	Подстрока в наименовании суда (один), напр. `Третьего кассационного суда`
`courts`	список строк (до 8)	Несколько судов через ИЛИ; значения – подстроки наименования, как оно записано в акте: `Второго кассационного суда`, `Арбитражного суда Московского округа`, `Верховного Суда`
`organ`	строка	Принявший орган (ищется в суде и названии – покрывает письма госорганов)
`act_type`	строка	Вид документа (подстрока: постановление, кассационное определение…)
`judge`	строка	Судья (подстрока, напр. фамилия)
`instance`	enum	`первая` \| `апелляция` \| `первая кассация` \| `вторая кассация`
`segment`	enum	`Судебные акты` \| `Разъяснения судов` \| `Разъяснения госорганов`
`status`	enum	`действует` \| `отменён` \| `изменён` – судьба самого акта по данным корпуса на дату среза; отметки об отмене пока не заполнены, поэтому «действует» означает лишь, что отмена в корпусе не обнаружена
`review_outcome`	enum	`отменён` \| `изменён` \| `оставлен без изменений` – результат рассмотрения: что этот кассационный/апелляционный акт сделал с актом нижестоящего суда
`doc_key`	строка	Поиск внутри одного документа (Ctrl+F по акту): идентификатор из выдачи; запрос ищется только в его тексте, выдача – фрагменты с совпадениями
`norm`	объект `{"law_key": "237-ФЗ", "article": "22"}`	Акты, применяющие норму (по разметке `practice_citations`, сверка EXISTS); без `article` – закон целиком; во всех инструментах практики

Дополнительно в перечислении

В /v1/practice/list и /v1/practice/facets действуют все фильтры выше и следующие уточнения.

Фильтр	Тип	Описание
`norm`	объект `{"law_key": "237-ФЗ", "article": "22"}`; `article` необязателен	Дела, где хотя бы один акт применяет норму (по разметке примененных норм `practice_citations`; сверка EXISTS, `total` не раздувается); без `article` – закон целиком

Примечания

unit=cases (legacy-дефолт /v1/practice/list) считает группы: по УИД, без него – по нормализованному сохраненному реквизиту case_number и суду, без обоих – акт=группа. case_number может быть номером производства; поэтому без УИД результат не гарантирует сквозной спор. Семантика и пределы – в disclaimer каждого ответа.
status у судебного акта означает «по данным корпуса на дату среза»: «действует» = отмена не обнаружена в нашей выборке (полнота проверки отмен корпусом не гарантируется); отмененные акты не скрываются – они значимы для периода своего действия.
review_outcome – про акт нижестоящего суда (что этот кассационный/апелляционный акт с ним сделал), не про судьбу самого документа (ее показывает status).