KAZNA TECH / KAD API / Карточка дела
Структура карточки дела
Метод возвращает дело целиком одним JSON. Ниже разобрано каждое поле: что в нём лежит, зачем оно нужно и как его читать. Этого достаточно, чтобы разложить ответ по своим таблицам без проб и ошибок.
Верхний уровень
Служебные поля ответа: по ним видно, откуда и на какой момент получены данные.
| Поле | Тип | Что означает | Пример |
|---|---|---|---|
| case | string | Номер дела в том виде, в каком вы его запросили. | «А14-16010/2020» |
| uid | string | Уникальный идентификатор дела в картотеке. По нему строится ссылка на первоисточник и отслеживаются обновления. | «d0fbd9df-87a0-48b6-97e5-e30116b60235» |
| updated | string | Момент, когда карточка была собрана. По нему видно, насколько свежие данные вы держите. | «2026-09-11T06:35:04Z» |
| added_date | string | Когда дело впервые попало в систему. | |
| cached | bool | Ответ отдан из кэша: данные получены мгновенно, без обращения к источнику. | |
| source | string | Откуда получены данные. | «kad.arbitr.ru» |
| result | object | Сама карточка дела, разбор ниже. |
Шапка дела: result
Общие сведения о споре: кто, где и когда судится.
| Поле | Тип | Что означает | Пример |
|---|---|---|---|
| case-number | string | Номер дела. | «А40-100200/2024» |
| case-date | string | Дата регистрации дела. | «05.07.2024» |
| courts | string | Суд, рассматривающий дело. | «АС города Москвы» |
| card-link | string | Ссылка на карточку в первоисточнике: удобно дать юристу для ручной проверки. | |
| case-calendar-link | string | Ссылка на календарь заседаний по делу. | |
| plaintiffs | string | Истцы сводной строкой. Детальный состав сторон в объекте sides. | |
| defendants | string | Ответчики сводной строкой. | |
| third, others | string | Третьи лица и иные участники. | |
| type, kind | string | Тип и категория спора, если источник их раскрывает. | |
| instances | array | Инстанции по делу с документами. | |
| sides | object | Детальный состав сторон. |
Инстанции: result.instances[]
Каждая инстанция идёт отдельным объектом со своим списком документов.
| Поле | Тип | Что означает | Пример |
|---|---|---|---|
| data-id | string | Идентификатор инстанции. | |
| data.Success | bool | Признак успешной выгрузки данных инстанции. | |
| data.Result.TotalCount | int | Сколько всего документов в инстанции. | 6 |
| data.Result.Items | array | Документы и события. | |
| data.Result.Page, PageSize, PagesCount | int | Постраничность выгрузки документов. |
Документы: Items[]
Самая содержательная часть ответа: хронология процесса, суммы, судьи и сроки.
| Поле | Тип | Что означает | Пример |
|---|---|---|---|
| DisplayDate | string | Дата документа: основное поле для хронологии дела. | «13.08.2024» |
| PublishDate | string|null | Дата публикации в картотеке. | |
| Judges[] | array | Судьи по документу: Id, Name, Role, Group. | |
| InstStage | int | Стадия инстанции. | |
| FinishInstance | int | Признак завершения инстанции: удобно для определения статуса дела. | |
| DecisionTypeName | string|null | Тип решения словами, если указан. | |
| ClaimSum | number | Сумма иска. Для скоринга и оценки риска одно из ключевых полей. | |
| RecoverySum | number | Взысканная сумма. | |
| CaseId, InstanceId | string | Связи документа с делом и инстанцией. | |
| FileName, OriginalActFileName | string | Имена файлов судебных актов, когда они опубликованы. | |
| IsStart | bool | Документ, с которого началась инстанция. | |
| AppealDate, DeadlineDate | string|null | Даты обжалования и процессуальных сроков. |
Стороны: result.sides
Детальный состав участников, когда сводных строк plaintiffs и defendants недостаточно.
| Поле | Тип | Что означает | Пример |
|---|---|---|---|
| Result.SidesCount | int | Всего участников. | |
| Result.Plaintiffs[] | array | Истцы. | |
| Result.Defendants[] | array | Ответчики. | |
| Result.Third[] | array | Третьи лица. | |
| Result.Others[] | array | Иные участники. |
Авторизация
Токен передаётся в заголовке. Параметр в строке запроса оставлен для совместимости со старыми интеграциями.
| Способ | Как передать | Статус |
|---|---|---|
| Authorization | Authorization: Bearer {токен} | Рекомендуемый |
| X-Token | X-Token: {токен} | Поддерживается |
| X-Api-Key | X-Api-Key: {токен} | Поддерживается |
| ?token= | Параметр в строке запроса | Устаревший, работает для старых интеграций |
Статусы ответа
Если дела ещё нет в системе, приходит статус, а не ошибка: запрос уже поставлен в работу.
| Ответ | Что произошло | Что делать |
|---|---|---|
| updated заполнено | Полная карточка готова. | Использовать данные. |
| status: queued | Дело принято в работу, идёт сбор. | Повторить запрос через несколько минут. |
| status: card-parsed | Дело найдено, известен uid, собираются документы. | Повторить запрос: полная карточка уже близко. |
| status: not-found | Такого дела в картотеке нет. | Проверить номер дела. |
Полный пример ответа
# базовый адрес API ($API_BASE) выдаётся вместе с токеном
curl -H "Authorization: Bearer YOUR_TOKEN" \
"$API_BASE/api/v3/case?case=А40-100200/2024"
{
"case": "А40-100200/2024",
"uid": "6d28b354-6a08-4cfd-a07c-a055643abe91",
"cached": true,
"updated": "2026-09-11T06:17:22Z",
"source": "kad.arbitr.ru",
"result": {
"case-number": "А40-100200/2024",
"case-date": "05.07.2024",
"courts": "АС города Москвы",
"card-link": "https://kad.arbitr.ru/Card/{uid}",
"instances": [
{
"data-id": "ecbe0447-40d8-4b93-a61f-d9733edd57c1",
"data": {
"Success": true,
"Result": {
"TotalCount": 6,
"Items": [
{
"DisplayDate": "13.08.2024",
"InstStage": 1,
"ClaimSum": 0,
"RecoverySum": 0,
"Judges": [ { "Name": "…", "Role": 1 } ]
}
]
}
}
}
],
"sides": {
"Result": { "SidesCount": 0, "Plaintiffs": [], "Defendants": [] }
}
}
}Нужен доступ к API?
Дадим тестовый токен и базовый адрес, прогоните свои номера дел на реальных данных.
manager@kazna.tech