kad_event_monitor — Процессуальный контроль арбитражного дела (КАД)¶
POST https://api.newdb.net/v2
Метод получает карточку одного арбитражного дела в КАД (kad.arbitr.ru) по номеру дела и возвращает не сырую карточку, а нормализованный снимок для мониторинга: статус дела, последний судебный акт, событие календаря, классифицированные процессуальные события, уровень риска, рекомендуемые действия и дельту относительно предыдущего снимка.
Раздел: Юридические лица
Связанные страницы¶
- arbitr_legal — Проверка арбитражных дел юрлиц (КАД)
- arbitr_person — Проверка арбитражных дел физлиц (КАД)
- ods_case_search — Поиск судебных дел
Когда использовать¶
- Нужно регулярно отслеживать конкретное арбитражное дело по номеру.
- Нужно быстро понять, появились ли новые процессуально значимые события.
- Нужно получить готовые сигналы для юриста, CRM, мониторинга или уведомлений: риск, действие, дата, ссылка на акт.
- Нужно сравнить текущую карточку дела с предыдущим снимком и выделить изменения.
Чем отличается от arbitr_legal / arbitr_person¶
arbitr_legal и arbitr_person ищут все арбитражные дела субъекта по ИНН/ФИО и возвращают список дел, пагинацию, карточки выбранных дел и исходные блоки КАД (cases, detailed_cases, participants, acts, calendar_events, electronic_case_files). Это удобно для первичного due diligence контрагента или физлица.
kad_event_monitor принимает уже известный case_number и превращает данные карточки одного дела в компактный мониторинговый объект. Вместо самостоятельного разбора календаря и актов клиент получает:
snapshot— стабильный снимок дела для хранения и последующего сравнения;process_events— единый список событий из календаря, актов и электронных материалов;event_typeиriskпо каждому событию;recommended_actions— практические действия по процессуальным сигналам;delta— изменения относительноprevious_snapshot, если он передан;ai_interpretation— дополнительная AI-интерпретация, если включен параметрopenai_interpretation.
Иными словами, обычные методы КАД отвечают на вопрос «какие дела есть у субъекта?», а kad_event_monitor отвечает на вопрос «что важно произошло в этом конкретном деле и требует ли это реакции?».
Заголовки¶
Content-Type: application/json
X-API-KEY: <your_token>
Входная схема¶
{
"params": {
"case_number": "string, номер арбитражного дела",
"country": "ru",
"method": "kad_event_monitor",
"previous_snapshot": "object|string, optional, предыдущий snapshot для сравнения",
"openai_interpretation": "boolean|0|1|string, optional, включить AI-интерпретацию"
},
"webhook": "https://your.host/webhook",
"requestId": "optional-string"
}
Параметры¶
| Параметр | Обязателен | Описание |
|---|---|---|
method |
да | Всегда kad_event_monitor. |
country |
да | Сейчас поддерживается ru. |
case_number |
да | Номер дела в формате КАД, например А56-795/2024. Также поддерживаются алиасы delo_case_number, case, num_case. |
previous_snapshot |
нет | Предыдущий объект snapshot из ответа метода. Нужен для расчета delta. Можно передать JSON-объект или JSON-строку. |
previous_result, previous |
нет | Алиасы для передачи предыдущего результата или снимка. |
openai_interpretation / ai_interpretation |
нет | Включает дополнительную AI-интерпретацию поверх детерминированных сигналов. |
Пример запроса¶
POST /v2 HTTP/1.1
Host: api.newdb.net
Content-Type: application/json
X-API-KEY: YOUR_TOKEN
{
"params": {
"case_number": "А56-795/2024",
"country": "ru",
"method": "kad_event_monitor"
},
"requestId": "a1962f88-2916-5779-b59d-43c023faa913"
}
Пример запроса с предыдущим снимком¶
{
"params": {
"case_number": "А56-795/2024",
"country": "ru",
"method": "kad_event_monitor",
"previous_snapshot": {
"case_number": "А56-795/2024",
"status": "Рассматривается в первой инстанции",
"latest_act": {
"date": "29.03.2024",
"type": "Решение",
"signature": "29.03.2024|решение"
},
"process_events": []
}
},
"requestId": "00000000-0000-4000-8000-000000000301"
}
Пример ответа¶
{
"params": {
"case_number": "А56-795/2024",
"country": "ru",
"method": "kad_event_monitor",
"newdb_qid": "EPHEASCTr-KegjQoAg"
},
"requestId": "a1962f88-2916-5779-b59d-43c023faa913",
"state": "complete",
"results": {
"kad_event_monitor": {
"result": {
"status": 200,
"data": [
{
"query_case_number": "А56-795/2024",
"found": true,
"snapshot": {
"case_number": "А56-795/2024",
"status": "Рассмотрение дела завершено",
"source_url": "https://kad.arbitr.ru/Card/example-card-id",
"latest_act": {
"date": "04.10.2024",
"type": "Определение о завершении процедуры банкротства",
"signature": "04.10.2024|определение о завершении процедуры банкротства"
},
"next_calendar_event": {
"date": "14.10.2024",
"description": "Ходатайство (заявление)",
"result": "О приобщении дополнительных материалов",
"signature": "14.10.2024|ходатайство (заявление)|о приобщении дополнительных материалов"
},
"process_events": [
{
"source": "calendar",
"date": "29.03.2024",
"title": "Решение",
"result": "Признать гражданина банкротом",
"link": "https://kad.arbitr.ru/Kad/PdfDocument/example.pdf",
"event_type": "decision_or_ruling",
"risk": "medium",
"recommended_action": "Проверить дату изготовления акта и сроки обжалования.",
"signature": "29.03.2024|решение|признать гражданина банкротом"
}
],
"metrics": {
"acts_count": 18,
"calendar_events_count": 34,
"electronic_case_files_count": 7,
"actionable_events_count": 4,
"high_risk_events_count": 0,
"hearing_breaks_count": 0,
"participants_count": 3,
"has_pdf_ai_analysis": true
}
},
"interpretation": {
"scope": "processual_control_only",
"risk_level": "medium",
"summary": "По делу А56-795/2024 есть процессуально значимые события для планового контроля.",
"limitations": "Интерпретация построена только по данным карточки КАД и не заменяет анализ полного текста судебных актов юристом."
},
"recommended_actions": [
{
"event_type": "decision_or_ruling",
"risk": "medium",
"date": "29.03.2024",
"action": "Проверить дату изготовления акта и сроки обжалования."
}
],
"delta": {
"has_previous_snapshot": false,
"changed": false,
"summary": "Предыдущий снимок не передан; сформирован базовый снимок для следующего сравнения.",
"changes": []
}
}
]
},
"taskId": "182afa26-fbe8-4344-a769-2b235cfc86d6",
"dateupdated": "2026-08-21 13:23:45"
}
}
}
Что находится в data[0]¶
snapshot— состояние дела, пригодное для хранения и передачи в следующий запрос какprevious_snapshot.snapshot.latest_act— последний судебный акт по данным карточки.snapshot.next_calendar_event— событие календаря из карточки КАД.snapshot.process_events— унифицированные события из календаря, актов и электронных материалов.metrics— счетчики актов, событий, материалов и риск-сигналов.interpretation— детерминированная интерпретация уровня риска и краткое резюме.recommended_actions— список действий для юриста или оператора мониторинга.delta— изменения относительно предыдущего снимка.ai_interpretation— дополнительный AI-блок, если включенopenai_interpretationи сервис AI доступен.
Типы событий и рисков¶
Возможные event_type: hearing_break, adjournment, suspension, resumption, expertise, evidence_request, claim_left_without_motion, appeal_or_cassation, interim_measures, decision_or_ruling, informational.
risk принимает значения low, medium, high.
AI Summary¶
Компактные метаданные для AI и агентных систем
{
"method": "kad_event_monitor",
"intent": "Процессуальный мониторинг конкретного арбитражного дела по номеру дела",
"endpoint": "POST https://api.newdb.net/v2",
"required_headers": ["X-API-KEY"],
"required_fields": ["case_number", "method", "country"],
"optional_fields": ["previous_snapshot", "previous_result", "previous", "openai_interpretation"],
"returns": ["state", "results.kad_event_monitor.result.status", "results.kad_event_monitor.result.data[0].snapshot", "results.kad_event_monitor.result.data[0].delta", "results.kad_event_monitor.result.data[0].recommended_actions"]
}