Арбитражные дела физических лиц

Сервис находит арбитражные дела физических лиц и индивидуальных предпринимателей по ИНН участника и возвращает дела со сторонами, судом, инстанцией и итоговым судебным актом.

Общая информация

Цель документации — обеспечить полное понимание и возможность эффективного использования сервиса как для конечных пользователей, так и для разработчиков.

Сервис является частью платформы Агредатор. Перед изучением данной документации ознакомьтесь со следующими обязательными документами по интеграции с платформой:

• Общие принципы работы с API
• HTTP-шлюз

Принимаемые сервисом параметры

Обязательна хотя бы одна группа сторон. У каждой стороны указывается Inn из 12 цифр: сервис ищет дела физических лиц и индивидуальных предпринимателей, по ИНН юридического лица из 10 цифр запрос отклоняется. Если сторон указано несколько, они объединяются по «И»: в выдачу попадут только те дела, где участвуют все перечисленные.

Others ищется в два прохода: сначала все перечисленные участники запрашиваются с ролью третьего лица, затем — с ролью иного лица. Дела из двух проходов сервис объединяет по идентификатору, дубликатов в выдаче не будет.

Допустимые значения data.CaseTypes:

В data.CaseTypes допускается не более одного значения — искать по нескольким типам за один запрос нельзя.

DateMin и DateMax — календарные даты. Время суток в них указать можно, но оно не применяется: границы всегда расширяются до целых суток — DateMin до начала дня, DateMax до конца.

Сервис возвращает последние 25 дел участника, от самого свежего к самому старому. Сколько дел найдено всего, видно в TotalItems — это число приходит от поставщика данных полностью, даже если оно больше 25, поэтому с длиной Items оно совпадает не всегда. При поиске по Others в TotalItems попадает большее из двух чисел, полученных за два прохода. Постраничной выдачи нет: чтобы получить дела за пределами последних 25, сузьте период запроса через DateMin и DateMax.

Единственный тип запроса — arbitr. Поля, не перечисленные в таблице, могут быть приняты сервисом, но не участвуют в обработке запроса. Сервис не поддерживает фильтрацию по категориям, исходам и суммам иска, выбор сортировки и получение следующих страниц результата.

Возвращаемые сервисом параметры

Идентификаторы дел, сторон и документов — строки. Все даты в ответе — UTC, в формате 2025-03-18T21:00:00, без обозначения часового пояса в самой строке.

Найденные дела: result.Items[]

Исход дела: Items[].DecisionType — сервис определяет его сам, по итоговому судебному акту последней инстанции и статусу дела:

Агрегации: result.Aggregations — рассчитываются по делам, включённым в result.Items, а не по полному количеству result.TotalItems.

Каждый элемент массива агрегации имеет следующую структуру:

Последняя инстанция: Items[].LastInstance — последней считается инстанция с наибольшим значением InstanceLevel.

LastInstance.Documents содержит не более одного элемента. Если итоговый судебный акт отсутствует, возвращается пустой массив.

Итоговый судебный акт: LastInstance.Documents[]

Сервис возвращает только сведения об итоговом судебном акте. Содержимое файла через info-radar-arbitr-v2 не возвращается.

Стороны дела: Items[].Sides[]

В Others объединяются третьи и иные лица: отдельно эти роли в ответе не обозначаются.

Поля, которые сервис не заполняет. Поля сохранены для совместимости с прежним форматом ответа и не содержат сведений поставщика данных:

Поля, которые часто приходят пустыми:

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

{
  "service": "info-radar-arbitr-v2",
  "type": "arbitr",
  "data": {
    "Defendants": [
      { 
        "Inn": "990000000001" 
      }
    ]
  }
}

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

{
  "success": true,
  "result": {
    "TotalItems": 1,
    "Aggregations": {
      "Year": [{ "Sum": 0, "Value": "2025", "Name": "2025", "Count": 1 }],
      "CaseType": [{ "Sum": 0, "Value": "Б", "Name": "Б", "Count": 1 }],
      "Category": [
        {
          "Sum": 0,
          "Value": "о несостоятельности (банкротстве) физических лиц",
          "Name": "о несостоятельности (банкротстве) физических лиц",
          "Count": 1
        }
      ],
      "DecisionType": [{ "Sum": 0, "Value": "ResultUnknown", "Name": "ResultUnknown", "Count": 1 }],
      "ParticipationType": [{ "Sum": 0, "Value": "Defendants", "Name": "Defendants", "Count": 1 }]
    },
    "Items": [
      {
        "Id": "5211e222-5461-464a-ac77-c7f17bdbb1cf",
        "Guid": "5211e222-5461-464a-ac77-c7f17bdbb1cf",
        "Number": "А02-542/2025",
        "Date": "2025-03-18T21:00:00",
        "Status": "Рассмотрение дела завершено",
        "Category": "о несостоятельности (банкротстве) физических лиц",
        "ClaimSum": 0.0,
        "CaseType": "Б",
        "DecisionType": "ResultUnknown",
        "LastInstance": {
          "InstanceId": "7cf628e2-c7d9-470f-987c-48ec564f811d",
          "CourtTag": "ALTAI",
          "CourtName": "АС Республики Алтай",
          "InstanceLevel": 1,
          "Documents": [
            {
              "Id": "1913934d-7a3a-4b8b-916d-6bb2812e17f2",
              "CaseId": "5211e222-5461-464a-ac77-c7f17bdbb1cf",
              "DocumentTypeName": "Определение",
              "ContentType": "О завершении реализации имущества гражданина и освобождении гражданина от исполнения обязательств",
              "AdditionalInfo": "A02-542-2025_20260608_Opredelenie.pdf",
              "DecisionTypeName": null,
              "Comment": null,
              "Date": "2026-06-07T21:00:00",
              "FileExist": true
            }
          ]
        },
        "Sides": [
          {
            "Id": "1dffb802-b0e9-4044-a605-4fa5d46941d2",
            "ObjectId": null,
            "ObjectType": null,
            "Name": "Лавров Роман Игоревич",
            "Address": "Данные скрыты",
            "Inn": "990000000001",
            "Ogrn": null,
            "Type": "Defendants"
          }
        ],
        "InstanceNumbers": []
      }
    ]
  }
}

Пример, когда дело не найдено:

  {
    "success": true,
    "result": {
      "Items": [],
      "TotalItems": 0,
      "Aggregations": {
        "Year": [],
        "CaseType": [],
        "Category": [],
        "DecisionType": [],
        "ParticipationType": []
      }
    }
  }

Пример ошибки

Ошибка приходит в одном из двух видов, и обрабатывать их нужно по-разному.

Запрос не принят. Входные параметры проверяются до постановки в обработку. Запрос отклоняется, если:

• в type не arbitr или поля нет вовсе;
• нет data или это не объект;
• не заполнена ни одна группа сторон, либо группа пришла не массивом, либо её элемент — не объект;
• в Inn не 12 цифр или поля нет;
• CaseTypes не массив, содержит неизвестное значение или больше одного значения;
• DateMin или DateMax не распознаётся как дата.

Такой запрос отклоняется сразу и получает статус 480, а что именно не так — написано в поле info:

{
  "status": 480,
  "info": "Укажите хотя бы одну сторону: data.Plaintiffs, data.Defendants или data.Others"
}

Поля success и exception в таком ответе отсутствуют, поскольку запрос не принят в обработку и результат не сформирован. Перед повторной отправкой необходимо исправить параметры в соответствии с описанием ошибки в поле info.

Сведения получить не удалось. Запрос был принят, но данные забрать не вышло. В теле ответа приходит:

{
  "success": false,
  "exception": "Поставщик данных временно недоступен, повторите запрос позже"
}

Запрос завершается с success: false без формирования частичного результата: если сведения не удалось получить хотя бы по одному найденному делу, результат по остальным делам также не возвращается. Для повторного получения сведений необходимо создать новый запрос.

Сроки и получение результата

Запрос обрабатывается асинхронно. Результат можно получить запросом GET /api/v1/requests/{id} либо через callback, если он настроен. Во время обработки запрос имеет статус 102.

По результатам эксплуатации среднее время обработки запроса составляет около одной минуты. В зависимости от количества найденных дел и текущей загрузки сервиса обработка в отдельных случаях может занимать несколько часов. В течение обработки запрос находится в статусе 102; его текущее состояние доступно при запросе статуса.

При интеграции необходимо учитывать следующие особенности:

• Повторная отправка запроса со статусом 102 не требуется. Запрос уже находится в обработке. Повторная отправка не сокращает время обработки и увеличивает нагрузку на сервис.
• Для пакетной отправки запросы необходимо равномерно распределять во времени. Частота обращений к поставщику данных ограничена, запросы обрабатываются через общую очередь сервиса.
• При настройке клиентского ожидания необходимо учитывать, что обработка запроса может занимать несколько часов. Короткий клиентский тайм-аут может завершиться до окончания обработки; для получения результата рекомендуется использовать callback или периодический опрос статуса.