# API Cloud: картотека kad.arbitr

> Ищите арбитражные дела по номеру, участнику, суду или датам, а затем запрашивайте карточку дела и сведения о заседаниях и документах.

- HTML: https://poapi.ru/api-cloud/api-kadarbitr-kartoteka-arbitrazhnyh-del
- Компания: API-CLOUD
- Страница компании: https://poapi.ru/company/api-cloud
- Категории: Госуслуги
- Сайт API: https://api-cloud.ru/kad_arbitr
- Документация: https://api-cloud.ru/kad_arbitr

## Подключение и ограничения
- Авторизация: Получите token в настройках аккаунта; передавайте его как параметр token либо заголовок Token.
- Ограничения: Для GET обязателен HTTPS; передавайте один type на вызов. Запросы чувствительны к времени ответа kad.arbitr; закладывайте минимум 120 секунд.

```bash
# Задайте API_CLOUD_TOKEN; замените заполнители реквизитами своего запроса.
curl --silent --show-error --fail-with-body --get --max-time 120 'https://api-cloud.ru/api/kad_arbitr.php' \
  --data-urlencode 'type=search' \
  --data-urlencode 'participant=ИНН_ИЛИ_НАЗВАНИЕ_УЧАСТНИКА' \
  --header "Token: ${API_CLOUD_TOKEN:?Укажите токен API Cloud}"
```
- Результат: search возвращает status, PagesCount, TotalCount, NumOnPage, Page и Result. В элементе поиска caseNumber задаёт номер дела, а caseId передаётся как CaseId в caseInfo. Сохраняйте точный регистр полей; содержимое PDF возвращает отдельный fileDownload в pdfBase64.
- Проверено по документации: 2026-11-02
- Источник: https://api-cloud.ru/kad_arbitr

## Описание
Сервис API Cloud обращается к картотеке kad.arbitr.ru: метод search возвращает найденные дела, а caseInfo раскрывает карточку по номеру либо caseId. В выдаче могут быть идентификаторы, стороны, текущая инстанция, судья и материалы; PDF можно получить отдельным fileDownload. Результат поиска отражает доступность и содержимое источника в момент обработки и не заменяет проверку судебных документов.

## Когда использовать
- Фильтруйте судебный мониторинг по участнику и роли, затем открывайте дело по CaseId.
- Из найденной карточки дела получить календарь заседаний и ссылки на документы для внутренней панели наблюдения.

## Порядок интеграции
1. Вызовите search по participant или CaseNumber и проверьте status, TotalCount и Page; используйте caseNumber/caseId из Result, чтобы выбрать нужное дело.
2. Запросите caseInfo по CaseId либо CaseNumber; извлеките CourtHearings и нужные метаданные документов. Для загрузки PDF передайте URL документа в fileDownload и декодируйте pdfBase64.
3. Если Result пуст, отличайте успешный пустой поиск от TIME_MAX_CONNECT; сохраняйте CaseId для последующих запросов.

## Что проверить перед запуском
- Уточняйте широкие запросы: документация сообщает, что caseInfo может блокировать особо крупные дела с BLOCK_REQUEST. В fileDownload pdfBase64 может быть null, если файл не найден.

## Связанные API
- [API Cloud: решения ras.arbitr](https://poapi.ru/api-cloud/api-rasarbitr-resheniya-arbitrazhnyh-sudov): Находите судебные акты по тексту документа, номеру дела или участнику и получайте ссылки на документы и сведения об инстанции.
- [Банкротства Федресурса через API Cloud](https://poapi.ru/api-cloud/api-fedresurs-bankrotsva): Ищите публикации о банкротстве по имени, ИНН или номеру дела и фильтруйте результаты по статусу дела и региону.
