API kad.arbitr (Картотека арбитражных дел)

Документация по работе с API kad.arbitr (Картотека арбитражных дел)

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP GET на URL нашего API: https://api-cloud.ru/api/kad_arbitr.php с персональным ключом API и параметрами.

Пример отправки GET запроса на PHP:

function get_rez($url) {
		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
		curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ 
		$res = curl_exec($ch);
		curl_close($ch);
		return $res;
	}

  $data = [
    'type' => 'Тип запроса (type)',
    ...
    Необходимы для запроса параметры
    ...
    'token' => 'Токен',
    ];

    // Структурированная ссылка для GET запроса
    $url = 'https://api-cloud.ru/api/kad_arbitr.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)

Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.

История изменений/обновлений API

Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа

type (Метод)	Описание	Параметры в запросе
	В одном запросе возможно отправить только 1 тип
search	Общий поиск дел по базе kad.arbitr • Дата дела • Номер дела • Тип дела • Идентификатор дела • Судья • Текущая инстанция • Истец • Ответчик	Обязательные token - персональный ключ API Дополнительные (можно указать хоть один, хоть несколько) CaseNumber - Номер дела Разрешено: кирилица, цифры, знаки "- /" courts - Суд(ы) (Значения) Разрешено: латиница, соответствие маске. Возможность указания нескольких судов через запятую. participant - Участник дела, ИНН, ФИО участника или название организации Разрешено: латиница, кирилица, цифры, знаки "-" startDate - Дата начала поиска Разрешено: формат (дд.мм.гггг) finishDate - Дата окончания поиска Разрешено: формат (дд.мм.гггг) page - номер страницы поиска (по умолчанию: 1) Разрешено: цифры
caseInfo	Подробная информация о деле • ID дела • Ссылка на дело на kad.arbitr.ru • Дата регистрации документа • Номер инстанции • Название файла • Ссылка для загрузки файла • Уровень инстанции • Название суда • Тип документа • Уточнения по типу документа	Поиск по номеру дела: Обязательные CaseNumber - номер дела в формате 000-0000/0000 Разрешено: кирилица, цифры, знаки "- /" token - персональный ключ API Поиск по ID дела: Обязательные CaseId - id (caseId) из результата метода search Разрешено: латиница, цифры, знак "-" token - персональный ключ API

Важная информация:

Если в ответе вы получили пустой массив "Result", то это тоже считается успешным запросом, поскольку обработчик выполнил свою работу, а результата нет по причине, что его нет на источнике.
Обратите внимание, что скорость загрузки результата зависит напрямую от ресурса источника
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200, т.е. получили результат.

Максимальное количество попыток соединения 3 раза. Если в результате этих попыток ресурс не вернет ответа, то API CLOUD вернет ответ {"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}

Примеры запросов

Пример запроса "search" HTTP GET на URL нашего API

https://api-cloud.ru/api/kad_arbitr.php?type=search&participant=Иванов Иван&token=53ba1b7a55abbB014aa97*****22079

Пример успешного запроса по типу search в формате JSON
Есть данные для вывода

{
  "status": 200,
  "PagesCount": "40", // Всего страниц поиска
  "TotalCount": "596901", // Всего найдено дел
  "NumOnPage": "25", // Дел на странице
  "Page": "1", // Текущая страница поиска
  // Массив с результатами поиска
  "Result": [
    {
      "date": "03.05.2024", // Дата дела
      "caseNumber": "А76-14779/2024", // Номер дела
      "type": "civil", // Тип дела
      "typeTitle": "Гражданское дело", // Расшифровка типа дела
      "caseId": "377fdbb0-56c4-49a1-8866-1929b39e605d", // Идентификатор дела (для запроса caseInfo)
      "url": "https://kad.arbitr.ru/Card/377fdbb0-56c4-49a1-8866-1929b39e605d", // Ссылка на дело
      "judge": "Малыхина В. В.", // Судья
      "instance": "АС Челябинской области", // Текущая инстанция
      // Истец
      "plaintiff": [
        {
          "name": "Чичиланов Иван Васильевич", // ФИО, название
          "adress": "Данные скрыты ", // Адрес
          "inn": "745306469940 " // ИНН
        }
      ],
      // Ответчик
      "respondent": [
        {
          "name": "Саширин Андрей Викторович", // ФИО, название
          "adress": "Данные скрыты ", // Адрес
          "inn": "744911319354 " // ИНН
        }
      ]
    }
  ],
  "inquiry": {
    "price": 0.4,
    "balance": 363.16,
    "speed": 0,
    "attempts": 1
  }
}

Поиск не дал результата

{
  "status": 200, // Статус ответа
  "PagesCount": "0",
  "TotalCount": "0",
  "NumOnPage": "25",
  "Page": "1",
  // Массив с результатами
  "Result": [],
  "inquiry": {
    "price": 0.4,
    "balance": 361.16,
    "speed": 1,
    "attempts": 1
  }
}

Пример запроса "caseInfo" HTTP GET на URL нашего API Поиск по номеру дела:

https://api-cloud.ru/api/kad_arbitr.php?type=caseInfo&CaseNumber=А76-14779/2024&token=53ba1b7a55abbB014aa97*****22079

Поиск по id дела из результата метода search:

https://api-cloud.ru/api/kad_arbitr.php?type=caseInfo&CaseId=377fdbb0-56c4-49a1-8866-1929b39e605d&token=53ba1b7a55abbB014aa97*****22079

Пример успешного запроса по типу caseInfo в формате JSON
Есть данные для вывода

{
  "status": 200, // Статус ответа
  "found": true, // Информация найдена true / false не найдена
  // Результат поиска
  "Result": {
  // Массив с информацией о деле
  "CaseInfo": {
    "CaseId": "a1b872f8-355f-4ab9-9f00-09bb91959f73", // id дела
    "CaseNumber": "А57-10677/2024", // Номер дела
    "StartDateUnix": "1713906000", // Старт дела UNIXTIME
    "StartDate": "24.04.2024", // Старт дела
    "finish": "false", // Законченное дело true / false - в процессе
    "State": "Рассматривается в первой инстанции", // Состояние дела
    "typeCode": "bankruptcy", // Код дела
    "typeTitle": "Банкротное дело" // Расшифровка кода дела
  },
  // Массив с участниками процесса
  "Participants": {
    // Истцы
    "Plaintiffs": [
      {
        "Id": "ba32ce23-abd3-4249-b224-6be033de636b", // id
        "Name": "Симаков Максим Иванович", // ФИО, название организации
        "Address": "Данные скрыты", // Адрес
        "INN": "645399785646", // ИНН
        "BirthDate": null // Дата рождения
      }
    ],
    // Ответчики
    "Respondents": [
      {
        "Id": "e29cb64c-9f23-4b5a-b430-0f87b5e4c135", // id
        "Name": "Симаков Максим Иванович", // ФИО, название организации
        "Address": "Данные скрыты", // Адрес
        "INN": "645399785646", // ИНН
        "BirthDate": null // Дата рождения
      }
    ],
    // Третьи лица
    "Thirds": [
      {
        "Id": "1a85449c-014b-45d3-bde5-3e7bd0c9b4d9", // id
        "Name": "АО Почта Банк", // ФИО, название организации
        "Address": "107061, Россия, Москва, Москва, пл Преображенская 8", // Адрес
        "INN": null, // ИНН
        "BirthDate": null // Дата рождения
      },
      {
        "Id": "24d4feb2-79e1-4533-8af6-5ddb787d18c7", // id
        "Name": "ПАО «Совкомбанк»", // ФИО, название организации
        "Address": "156000, Россия, Костромская область, г. Кострома, пр-кт Текстильщиков, д. 46", // Адрес
        "INN": "4401116480", // ИНН
        "BirthDate": null // Дата рождения
      }
    ],
    // Иные
    "Others": []
  },
  // Массив с экземплярами дела
  "CaseInstances": [
    {
      "Id": "06f8e856-9371-448f-ba1d-2e619ba7c68e", // id
      "InstanceNumber": "А57-10677/2024", // Номер дела
      "InstanceLevel": 1, // Уровень инстанции
      "NextInstanceEvent": "Следующее заседание: 04.06.2024, 10:10 , 1410", // Информация о следующем заседании
      // Суд
      "Court": {
        "Id": "c9d9f36b-5fba-4d15-a4c4-e8497a93d6cd", // id
        "Name": "АС Саратовской области", // Название
        "Url": "http://saratov.arbitr.ru/" // Ссылка на суд
      },
      // Судья
      "Judges": [
        {
          "Id": "56189697-270d-4caa-bad9-452e5aac9da6", // id
          "Name": "Королева И. Ю." // ФИО
        }
      ],
      // Массив с событиями
      "InstanceEvents": [
        {
          "EventTypeName": "Определение", // Название события
          "EventTypeId": "3f4a11f5-b269-4fe8-8243-957b5260c3d1", // id
          "AdditionalInfo": "Дата и время судебного заседания 04.06.2024, 10:10, 1410", // Дополнительная информация
          // Массив с описанием
          "ContentTypes": [
          "Принять к производству заявление о признании должника банкротом. Назначить судебное заседание по рассмотрению обоснованности заявления о признании должника банкротом (ст.42 ФЗ О несостоятельности)"
          ],
          "Date": "03.05.2024", // Дата
          "File": "https://kad.arbitr.ru/Kad/PdfDocument/a1b872f8-355f-4ab9-9f00-09bb91959f73/9d85909a-7d33-4b44-a92f-ce01b6575a11/A57-10677-2024_20240503_Opredelenie.pdf", // Ссылка на файл
          "Declarers": null, // Заявитель
          "DeclarerInn": null, // ИНН заявителя
          "Comment": null, // Комментарий
          "ClaimSum": 0 // Сумма претензии
        },
        {
          "EventTypeName": "Ходатайство (заявление)",
          "EventTypeId": "61c185a2-275e-4596-9764-67d79107fc89",
          "AdditionalInfo": "",
          "Date": "24.04.2024", // Дата
          "File": null, // Ссылка на файл
          "Declarers": null, // Заявитель
          "DeclarerInn": null, // ИНН заявителя
          "Comment": null, // Комментарий
          "ClaimSum": 0 // Сумма претензии
        },
        {
          "EventTypeName": "Заявление (исковое заявление)", // Название события
          "EventTypeId": "f51e61ff-f4c6-4493-85c9-fb38c1d7828f", // id
          "AdditionalInfo": ". Сумма исковых требований 1567424,91", // Дополнительная информация
          "Date": "24.04.2024", // Дата
          "File": null, // Ссылка на файл
          "Declarers": "Симаков Максим Иванович", // Заявитель
          "DeclarerInn": "645399785646", // ИНН заявителя
          "Comment": null, // Комментарий
          "ClaimSum": 1567424.91 // Сумма претензии
        }
      ]
    }
  ],
},
  "inquiry": {
    "price": 0.5,
    "balance": 302.96,
    "speed": 2,
    "attempts": 1
  }
}

Поиск не дал результата

{
  "status": 200, // Статус ответа
  "found": false, // Результат поиска false - не найдено
  "Result": [],
  "inquiry": {
    "price": 0.5,
    "balance": 284.61,
    "speed": 5,
    "attempts": 1
  }
}

Поиск не дал результатов, либо ресурс не вернул ответа за отведенный промежуток времени

{"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}

Список courts (суд) для метода search

courts	Наименование суда
VS	Верховный Суд РФ
VAS	Высший Арбитражный Суд РФ
FASVVO	АС Волго-Вятского округа
FASVSO	АС Восточно-Сибирского округа
FASDVO	АС Дальневосточного округа
FASZSO	АС Западно-Сибирского округа
FASMO	АС Московского округа
FASPO	АС Поволжского округа
FASSZO	АС Северо-Западного округа
FASSKO	АС Северо-Кавказского округа
FASUO	АС Уральского округа
FASCO	АС Центрального округа
1AAS	1 арбитражный апелляционный суд
2AAS	2 арбитражный апелляционный суд
3AAS	3 арбитражный апелляционный суд
4AAS	4 арбитражный апелляционный суд
5AAS	5 арбитражный апелляционный суд
6AAS	6 арбитражный апелляционный суд
7AAS	7 арбитражный апелляционный суд
8AAS	8 арбитражный апелляционный суд
9AAS	9 арбитражный апелляционный суд
10AAS	10 арбитражный апелляционный суд
11AAS	11 арбитражный апелляционный суд
12AAS	12 арбитражный апелляционный суд
13AAS	13 арбитражный апелляционный суд
14AAS	14 арбитражный апелляционный суд
15AAS	15 арбитражный апелляционный суд
16AAS	16 арбитражный апелляционный суд
17AAS	17 арбитражный апелляционный суд
18AAS	18 арбитражный апелляционный суд
19AAS	19 арбитражный апелляционный суд
20AAS	20 арбитражный апелляционный суд
21AAS	21 арбитражный апелляционный суд
ALTAI-KRAI	АС Алтайского края
AMURAS	АС Амурской области
ARHANGELSK	АС Архангельской области
ASTRAHAN	АС Астраханской области
BELGOROD	АС Белгородской области
BRYANSK	АС Брянской области
VLADIMIR	АС Владимирской области
VOLGOGRAD	АС Волгоградской области
VOLOGDA	АС Вологодской области
VORONEJ	АС Воронежской области
MSK	АС города Москвы
SPB	АС города Санкт-Петербурга и Ленинградской области
SEVASTOPOL	АС города Севастополя
DNR	АС Донецкой Народной Республики
EAO	АС Еврейской автономной области
CHITA	АС Забайкальского края
ZAPOROZHYE	АС Запорожской области
IVANOVO	АС Ивановской области
IRKUTSK	АС Иркутской области
ASKB	АС Кабардино-Балкарской Республики
KALININGRAD	АС Калининградской области
KALUGA	АС Калужской области
KAMCHATKA	АС Камчатского края
ASKCHR	АС Карачаево-Черкесской Республики
KEMEROVO	АС Кемеровской области
KIROV	АС Кировской области
KOMI-PERM	АС Коми-Пермяцкого АО
KOSTROMA	АС Костромской области
KRASNODAR	АС Краснодарского края
KRANSOYARSK	АС Красноярского края
KURGAN	АС Курганской области
KURSK	АС Курской области
LIPETSK	АС Липецкой области
LNR	АС Луганской Народной Республики
MAGADAN	АС Магаданской области
ASMO	АС Московской области
MURMANSK	АС Мурманской области
NNOV	АС Нижегородской области
NOVGOROD	АС Новгородской области
NOVOSIB	АС Новосибирской области
OMSK	АС Омской области
ORENBURG	АС Оренбургской области
OREL	АС Орловской области
PENZA	АС Пензенской области
PERM	АС Пермского края
PRIMKRAY	АС Приморского края
PSKOV	АС Псковской области
ADYG	АС Республики Адыгея
ALTAI	АС Республики Алтай
UFA	АС Республики Башкортостан
BURYATIA	АС Республики Бурятия
MAHACHKALA	АС Республики Дагестан
INGUSHETIA	АС Республики Ингушетия
KALMYK	АС Республики Калмыкия
KARELIA	АС Республики Карелия
KOMI	АС Республики Коми
KRYM	АС Республики Крым
MARI-EL	АС Республики Марий Эл
ASRM	АС Республики Мордовия
YAKUTSK	АС Республики Саха
ALANIA	АС Республики Северная Осетия
TATARSTAN	АС Республики Татарстан
TYVA	АС Республики Тыва
KHAKASIA	АС Республики Хакасия
ROSTOV	АС Ростовской области
RYAZAN	АС Рязанской области
SAMARA	АС Самарской области
SARATOV	АС Саратовской области
SAKHALIN	АС Сахалинской области
EKATERINBURG	АС Свердловской области
SMOLENSK	АС Смоленской области
STAVROPOL	АС Ставропольского края
TAMBOV	АС Тамбовской области
TVER	АС Тверской области
TOMSK	АС Томской области
TULA	АС Тульской области
TUMEN	АС Тюменской области
UDMURTIYA	АС Удмуртской Республики
ULYANOVSK	АС Ульяновской области
KHABAROVSK	АС Хабаровского края
HMAO	АС Ханты-Мансийского АО
KHERSON	АС Херсонской области
CHEL	АС Челябинской области
CHECHNYA	АС Чеченской Республики
CHUVASHIA	АС Чувашской Республики
CHUKOTKA	АС Чукотского АО
YAMAL	АС Ямало-Ненецкого АО
YAROSLAVL	АС Ярославской области
KUDIMKAR	ПСП Арбитражного суда Пермского края
NARYANMAR	ПСП Арбитражный суд Архангельской области
SIP	Суд по интеллектуальным правам

История изменений API kad.arbitr (Картотека арбитражных дел)

дата	что изменилось
04.10.2024	Тип запроса search: Добавлен новый параметр поиска. courts - Суд(ы). Указание суда или нескольких судов через запятую.
25.09.2024	В типе запроса caseInfo в выводе добавили массив с описанием события InstanceEvents -> ContentTypes

Возможные коды ошибок

код (error)	Описание ошибки (message)
888	ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы
766	MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры
602	TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса
504	TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой
503	TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе
502	MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token
500	MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type
499	WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498	TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс.
460	NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры
456	MAX_LIMIT Превышено количество одновременных соединений (потоки)
404	TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
2002	courts_INCORRECT_VALUE Суд не соответствует маске
123	IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111	PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
015	DATE_ERROR Ошибка значения переданной даты
005	TEST_TIME_OFF Закончился период тестирования
003	TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
002	TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
001	API_SUSPENDED Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.

Пример ответа с ошибкой

{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}