pravo_search — Поиск судебных дел¶

POST https://api.newdb.net/v2

Метод ищет судебные дела в ГАС Правосудие и связанных источниках судов общей юрисдикции. Поиск выполняется по карточке дела, участникам процесса и текстам судебных актов.

В ответе возвращается список найденных дел с карточкой дела, списком участников и списком актов. Для дальнейшей детализации конкретного дела используйте pravo_cases_details.

Раздел: ГАС Правосудие

Связанные страницы¶

Когда использовать¶

Используйте метод, когда нужно найти судебные дела по ФИО, названию организации, номеру дела, судье, категории, ссылке на суд, участникам процесса или тексту судебного акта.

Типовые кейсы¶

Поиск дел по ФИО физлица
Поиск дел по организации-истцу или ответчику
Фильтрация по номеру дела, категории или судье
Поиск по тексту судебного акта

Заголовки¶

Content-Type: application/json X-API-KEY:

Входная схема (request)¶

{
  "params": {
    "query": "string",
    "country": "ru",
    "method": "pravo_search",
    "limit": 100
  },
  "requestId": "optional-string"
}

Как работает поиск¶

По коду метод формирует запрос и добавляет AND-условия только для тех фильтров, которые переданы в params.

Для текстовых полей используется поиск по подстроке без учета регистра: lower(field) LIKE '%value%'
Для party_role и party_role_2 используется точное сравнение по полю cp.role_text после приведения к верхнему регистру
Если передан act_text, поиск идет по тексту судебных актов
Если передан общий поисковый текст q / query / fio / nameorg, он ищется сразу по нескольким полям карточки и участников
Хотя старые интеграции могут передавать newdb_qid, в коде этого метода он не участвует в фильтрации
Нужно передать хотя бы один поисковый фильтр, иначе метод вернёт ошибку

Основные фильтры¶

Параметр	Алиасы	По какому полю фильтрует	Какой поиск используется	Какие значения принимает
`q`	`query`, `fio`, `nameorg`	`c.case_number`, `c.case_header`, `c.judge_name`, `c.case_info`, `cp.party_name`	По подстроке, без учета регистра	Любой текст: ФИО, номер дела, организация, фрагмент карточки
`lastname` + `firstname` + `secondname`	Нет	Те же поля, что и `q`	Части объединяются в одну строку и ищутся по подстроке	Части ФИО
`case_info`	`caseInfo`	`c.case_info`	По подстроке, без учета регистра	Любой текст из карточки дела
`case_url`	`url`	`c.case_url`	По подстроке, без учета регистра	URL карточки дела или его фрагмент
`court_url`	Нет	`c.court_url`	По подстроке, без учета регистра	URL суда или его фрагмент
`category`	`category_text`	`c.category_text`	По подстроке, без учета регистра	Текст категории дела
`case_number`	`delo_case_number`	`c.case_number`	По подстроке, без учета регистра	Номер дела или его часть
`judge_name`	`judge`, `judge_fio`	`c.judge_name`	По подстроке, без учета регистра	ФИО судьи или часть ФИО
`act_text`	Нет	`ca.act_text`	По подстроке, без учета регистра	Фрагмент текста судебного акта

Фильтры по участникам¶

Метод поддерживает до двух независимых фильтров по участникам дела.

Параметр	Алиасы	По какому полю фильтрует	Какой поиск используется	Какие значения принимает
`party_name`	`partyName`, `party`	`cp.party_name`	По подстроке, без учета регистра	ФИО или название участника
`party_role`	`role`	`cp.role_text`	Точное сравнение после `UPPER()`	Роль участника в том виде, как она хранится в источнике
`party_name_2`	`partyName_2`	`cp.party_name`	По подстроке, без учета регистра	Второй участник для дополнительного фильтра
`party_role_2`	`role_2`	`cp.role_text`	Точное сравнение после `UPPER()`	Роль второго участника

Оба блока работают как независимые фильтры по участникам, поэтому можно, например, искать дело, где одновременно:

есть участник party_name="Антосенко Александр Иванович"
и есть участник party_name_2="Региональная служба взыскания" с ролью party_role_2="ИСТЕЦ"

Какие значения можно передавать¶

`limit`¶

Тип: целое число
По умолчанию: 100
Минимум: 1
Максимум: 1000
Если передать больше 1000, значение будет принудительно ограничено до 1000

`party_role`, `party_role_2`¶

По коду сравнение идет с полем role_text, а не role_code. Это значит:

передавать нужно текстовую роль участника
сравнение точное, но регистр не важен, потому что значение приводится к верхнему регистру
допустимые значения зависят от данных источника

Типовые значения:

АДВОКАТ
АДМИНИСТРАТИВНЫЙ ИСТЕЦ
АДМИНИСТРАТИВНЫЙ ОТВЕТЧИК
ВЗЫСКАТЕЛЬ
ДОЛЖНИК
ЗАИНТЕРЕСОВАННОЕ ЛИЦО
ЗАИНТЕРЕСОВАННОЕ ЛИЦО, в отношении которого подано заявление
ЗАИНТЕРЕСОВАННОЕ ЛИЦО, В ОТНОШЕНИИ КОТОРОГО ПОДАНО ЗАЯВЛЕНИЕ
ЗАЯВИТЕЛЬ
ИСТЕЦ
ОТВЕТЧИК
ПРЕДСТАВИТЕЛЬ
ПРОКУРОР
ТРЕТЬЕ ЛИЦО
другие значения, если они присутствуют в карточке дела

`country`¶

Для метода используется значение ru

`method`¶

Актуальное значение: pravo_search

Обязательность параметров¶

Формально метод требует:

country
method
хотя бы один поисковый фильтр

Если не передать ни одного фильтра поиска, код вернёт ошибку с требованием указать хотя бы одно из полей:

case_info
case_url
court_url
category
case_number
judge_name
act_text
party_name
party_name_2
q или fio

Пример запроса¶

Ниже старый рабочий формат запроса, который стоит учитывать для обратной совместимости. Параметр query в коде поддерживается и попадает в общий текстовый поиск.

POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: YOUR_TOKEN

{
  "params": {
    "query": "Антосенко Александр Иванович",
    "country": "ru",
    "method": "pravo_search",
    "newdb_qid": "EMMrIIKmwL7ZMygA"
  },
  "requestId": "a3962f18-3919-5473-b51d-44c133faa911"
}

Пример расширенного запроса¶

POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: YOUR_TOKEN

{
  "params": {
    "query": "Антосенко Александр Иванович",
    "party_name_2": "Региональная служба взыскания",
    "party_role_2": "ИСТЕЦ",
    "category": "взыскании сумм по договору займа",
    "judge_name": "Семенова",
    "country": "ru",
    "method": "pravo_search",
    "limit": 50
  },
  "requestId": "a3962f18-3919-5473-b51d-44c133faa911"
}

Пример ответа¶

Ниже пример в формате, который соответствует текущему коду поиска: в data[] возвращаются карточки дел с вложенными parties и acts.

{
  "params": {
    "query": "Антосенко Александр Иванович",
    "country": "ru",
    "method": "pravo_search",
    "newdb_qid": "EMMrIIKmwL7ZMygA"
  },
  "requestId": "a3962f18-3919-5473-b51d-44c133faa911",
  "datecreated": "2026-04-16 22:41:28",
  "state": "complete",
  "balance": 9578,
  "tasks": 1,
  "is_repeat": false,
  "results": {
    "pravo_search": {
      "taskId": "6cf346c9-a8be-460b-b038-81930a6f04fd",
      "dateupdated": "2026-04-16 22:41:34",
      "result": {
        "status": 200,
        "data": [
          {
            "case_id": 11051155,
            "row_num": "16.",
            "case_url": "http://zhigulevsky.sam.sudrf.ru/modules.php?name=sud_delo&srv_num=1&name_op=case&case_id=115225941&case_uid=6ae69d13-bd99-4771-bc03-70dbde712a96&delo_id=1540005&new=",
            "case_info": "КАТЕГОРИЯ: Споры, связанные с имущественными правами → Иски о взыскании сумм по договору займа, кредитному договору ИСТЕЦ(ЗАЯВИТЕЛЬ): ООО ПКО \"Региональная служба взыскания\" ОТВЕТЧИК: Антосенко Александр Иванович",
            "court_url": "http://zhigulevsky.sam.sudrf.ru",
            "judge_name": "Семенова Н.Ю.",
            "case_header": "Гражданские дела - первая инстанция",
            "case_number": "2-1435/2025",
            "region_code": "63",
            "region_name": "Самарская область",
            "result_text": "Вынесено решение по делу",
            "review_date": "2025-08-13",
            "hearing_date": "2025-08-13",
            "hearing_time": "12:00:00",
            "category_text": "Споры, связанные с имущественными правами → Иски о взыскании сумм по договору займа, кредитному договору",
            "received_date": "2025-07-18",
            "unique_case_id": "63RS0029-02-2025-002581-08",
            "proceeding_sign": "Рассмотрено единолично судьей",
            "delo_case_number": "ДЕЛО № 2-1435/2025",
            "source_json": {},
            "parties": [
              {
                "party_id": 24870760,
                "role_code": "defendant",
                "role_text": "ОТВЕТЧИК",
                "party_name": "Антосенко Александр Иванович"
              },
              {
                "party_id": 24870762,
                "role_code": "plaintiff",
                "role_text": "ИСТЕЦ",
                "party_name": "ООО ПКО \"Региональная служба взыскания\""
              }
            ],
            "acts": []
          }
        ],
        "meta": {
          "search_text": "Антосенко Александр Иванович",
          "case_info": "",
          "case_url": "",
          "court_url": "",
          "category": "",
          "case_number": "",
          "judge_name": "",
          "act_text": "",
          "party_filters": [],
          "limit": 100,
          "case_ids": [
            11051155
          ],
          "count": 1
        }
      }
    }
  }
}

Старый формат ответа¶

В старых интеграциях мог использоваться упрощённый ответ, где в data[] возвращались не карточки дел, а найденные участники. Пример такого ответа допустимо использовать как исторический, но для новой документации ориентиром должен быть текущий формат из кода выше.

Что есть в ответе¶

Поле	Описание
`results.pravo_search.result.status`	HTTP-подобный статус обработки результата
`results.pravo_search.result.data[]`	Список найденных дел
`results.pravo_search.result.meta.search_text`	Итоговый текст общего поиска, собранный из `q`, `query`, `fio`, `nameorg` или ФИО-полей
`results.pravo_search.result.meta.party_filters`	Примененные фильтры по участникам
`results.pravo_search.result.meta.case_ids`	Список `case_id` найденных дел
`results.pravo_search.result.meta.count`	Количество найденных дел

Поля объекта дела `data[]`¶

По коду в объект дела попадают:

поля карточки дела
parties: агрегированный список участников дела
acts: агрегированный список актов дела

`parties[]`¶

Поле	Описание
`party_id`	Идентификатор участника
`role_code`	Технический код роли
`role_text`	Текстовая роль участника
`party_name`	Имя физлица или название организации

`acts[]`¶

Поле	Описание
`act_id`	Идентификатор акта
`act_title`	Заголовок акта
`act_text`	Текст акта

AI Summary¶

Компактные метаданные для AI и агентных систем

{
  "method": "pravo_search",
  "intent": "Поиск судебных дел в ГАС Правосудие по карточке дела, участникам и тексту актов",
  "endpoint": "POST https://api.newdb.net/v2",
  "required_headers": ["X-API-KEY"],
  "required_fields": ["country", "method"],
  "search_fields": [
    "q",
    "query",
    "fio",
    "nameorg",
    "lastname",
    "firstname",
    "secondname",
    "case_info",
    "case_url",
    "court_url",
    "category",
    "case_number",
    "judge_name",
    "act_text",
    "party_name",
    "party_role",
    "party_name_2",
    "party_role_2"
  ],
  "returns": [
    "state",
    "results.pravo_search.taskId",
    "results.pravo_search.result.status",
    "results.pravo_search.result.data",
    "results.pravo_search.result.meta"
  ]
}