## Документация API service.api-assist.com kad.arbitr.ru Сервис поддерживает три типа запросов: 1. **Поиск дел** — для поиска дел по различным параметрам. 2. **Получение детальной информации по номеру дела** — для получения подробной информации о деле по его номеру. 3. **Получение детальной информации по ID дела** — для получения подробной информации о деле по его уникальному идентификатору. Все запросы требуют указания ключа доступа (`key`). --- ### 1. Поиск дел Для поиска дел используйте следующий запрос: ``` https://service.api-assist.com/parser/arbitr_api/search?key=ВАШ_КЛЮЧ_ДОСТУПА ``` **Параметры поиска:** - **page** — номер страницы поисковой выдачи. По умолчанию загружается первая страница. Если требуется получить дела вглубь выдачи, можно запросить ту же информацию с параметром `page=2` и далее. - **Inn** — ИНН или наименование участника процесса. - **InnType** — тип участника процесса, значения: - **Any** — Любой (по умолчанию). - **Plaintiff** — Истец. - **Respondent** — Ответчик. - **Third** — Третье лицо. - **Other** — Иное лицо. - **DateFrom** — Дата, с которой начинается поиск (формат `YYYY-MM-DD`). - **DateTo** — Дата, по которую ведется поиск (формат `YYYY-MM-DD`). - **Court** — наименование суда (точно как на kad.arbitr.ru). - **CaseType** — Тип дела, варианты: - **A** — административное. - **B** — банкротное. - **G** — гражданское. **Пример поискового запроса:** ``` https://service.api-assist.com/parser/arbitr_api/search?key=ВАШ_КЛЮЧ_ДОСТУПА&DateFrom=2020-10-16&DateTo=2020-11-16&Inn=РОСНЕФТЬ&InnType=Any&Court=АС%20Московской%20области ``` **Пример ответа на поисковый запрос:** Ответ на поисковый запрос возвращается в формате JSON. Пример ответа: ```json { "Success": 1, "Cases": [ { "CaseId": "7057cbe9-910b-43ab-98f6-97293fbfd6ff", // уникальный идентификатор дела "CaseNumber": "А40-180791/2024", // номер дела "CaseType": "Б", // тип дела (А - административное, Б - банкротное, Г - гражданское) "Court": "АС города Москвы", // наименование суда "StartDate": "2024-08-05", // дата регистрации дела "Plaintiffs": [ // истцы { "Name": "ПАО \"НОРВИК БАНК\"", // наименование истца "Address": "115054, Россия, г Москва, г. Москва, ул. Зацепский вал, д. 5", // адрес истца "Inn": "4346001485" // ИНН истца } ], "Respondents": [ // ответчики { "Name": "Антоненко Александр Александрович", // наименование ответчика "Address": null, // адрес ответчика (если отсутствует, возвращается null) "Inn": "463406307502" // ИНН ответчика } ] } ], "PagesCount": 1 // общее количество страниц с результатами поиска } ``` --- ### 2. Получение детальной информации по номеру дела Для получения детальной информации по номеру дела используйте следующий запрос: ``` https://service.api-assist.com/parser/arbitr_api/details_by_number?key=ВАШ_КЛЮЧ_ДОСТУПА&CaseNumber=НОМЕР_ДЕЛА ``` **Параметры:** - **CaseNumber** — номер дела (обязательный). **Пример запроса:** ``` https://service.api-assist.com/parser/arbitr_api/details_by_number?key=ВАШ_КЛЮЧ_ДОСТУПА&CaseNumber=%D0%9065-1529/2021 ``` --- ### 3. Получение детальной информации по ID дела Для получения детальной информации по уникальному идентификатору дела используйте следующий запрос: ``` https://service.api-assist.com/parser/arbitr_api/details_by_id?key=ВАШ_КЛЮЧ_ДОСТУПА&CaseId=ID_ДЕЛА ``` **Параметры:** - **CaseId** — уникальный идентификатор дела (обязательный). **Пример запроса:** ``` https://service.api-assist.com/parser/arbitr_api/details_by_id?key=ВАШ_КЛЮЧ_ДОСТУПА&CaseId=b82051d4-9713-4dcd-8de5-ef6d18d8ac66 ``` **Пример ответа на запрос детальной информации:** Ответ на запрос детальной информации возвращается в формате JSON. Пример ответа: ```json { "Success": 1, "Cases": [ { "CaseId": "6fb9afec-b71d-4183-b917-4cace5958c16", // уникальный идентификатор дела "CaseNumber": "А71-1202/2015", // номер дела "CaseType": "А", // тип дела "Plaintiffs": [ // истцы { "Name": "ООО \"Детство\"", // наименование "Address": "101000, ул. Петровка 17/3-19 (Мансурову М.С.), Москва г.", // адрес "Inn": "1841012052", // ИНН "Ogrn": "1101841004198", // ОГРН "Id": "3c79f2f9-c07f-4cfe-92a1-eb495e3fd2de" // уникальный идентификатор } ], "Respondents": [ // ответчики { "Name": "Межрайонная ИФНС России №9 по Удмуртской Республике", "Address": "426003, ул. Карла Маркса, 130, г. Ижевск", "Inn": "1835059990", "Ogrn": "1041805001501", "Id": "b49d872b-2fd3-4802-904d-8c8565ad6fea" } ], "StartDate": "2015-02-06", // дата регистрации дела "State": "Рассмотрение дела завершено", // состояние дела "Finished": true, // закрыто ли дело "CaseInstances": [ // инстанции { "Id": "5400123c-5c8a-4421-a839-c130938086c2", // уникальный идентификатор инстанции "InstanceNumber": "А71-1202/15", // номер инстанции "Name": "Первая инстанция", // тип инстанции "State": "Следующее заседание: 18.11.2020, 10:15 , №217 Матвеева Н.В.", // дополнительная информация "Court": { // суд "Code": "UDMURTIYA", // код суда "Name": "АС Удмуртской Республики" // наименование суда }, "File": { // файл с решением по инстанции "Name": "A71-1202-2015_20150507_Reshenija i postanovlenija.pdf", // наименование файла "URL": "https://kad.arbitr.ru/PdfDocument/63778dcd-c696-4863-b781-73a839cbf8a8/A71-1202-2015_20150507_Reshenija%20i%20postanovlenija.pdf" // ссылка на файл }, "Judges": [ // судьи "Бушуева Е. А." ], "MoiArbitrDocuments": [ // материалы электронного дела { "PublishDate": "2016-11-21 10:25:00", // дата публикации "RegisterDate": "2016-11-21", // дата регистрации "DocumentName": "Отзыв", // тип/название документа "CourtName": "АС Удмуртской Республики" // суд } ], "InstanceEvents": [ // события инстанции { "EventTypeName": "Определение", // тип "EventTypeId": "3f4a11f5-b269-4fe8-8243-957b5260c3d1", // уникальный идентификатор типа события "Id": "8d0e1fc6-9df7-46bb-8530-10a971190666", // уникальный идентификатор события "AdditionalInfo": "Дата и время судебного заседания 20.01.2016, 11:00, 22", // дополнительная информация "Date": "2015-12-11", // дата регистрации события "File": "https://kad.arbitr.ru/PdfDocument/8d0e1fc6-9df7-46bb-8530-10a971190666/A71-1202-2015_20151211_Opredelenie.pdf", // файл с документом по событию "PublishDate": "2015-12-12", // дата публикации события "FinishEvent": 0, // закрывающее событие? (решение) "EventContentTypeName": "Об отложении рассмотрения заявления/жалобы", // тип содержания документа "Declarer": "АНО ДАЧНОЕ НЕКОММЕРЧЕСКОЕ ТОВАРИЩЕСТВО ВНИИКОП-ОСТРОВ", // заявитель "DeclarerInn": "5003079985", // ИНН заявителя "Comment": "заявителю на руки в заседании, ответчику на руки в ячейке", // комментарий "DecisionTypeName": null, // тип решения "HasSignature": 0, // подписано "ClaimSum": 10000 // сумма исковых требований } ] } ], "CourtHearings": [ // календарь судебных заседаний { "Location": "426011, Ижевск, ул. Ломоносова 5, 22", // адрес "Summary": "Заседание по делу А71-1202/2015 в АС Удмуртской Республики. Судья Бушуева Е. А.", // комментарий "Start": "2015-03-19T11:00:00+04", // дата начала "End": "2015-03-19T12:00:00+04" // дата окончания } ] } ] } ``` ### Интерпретация ответа и обработка ошибок **Общие рекомендации:** - Если поле `Success` заполнено и `Success = 1` — перед вами успешный ответ, с которым можно работать. Только такие запросы учитываются в статистике и расходуют оплаченный лимит. - Иначе, если поле `error` заполнено — запрос требует вашего внимания. Текст ошибки рекомендуется сохранить или отправить для дальнейшего анализа. - Иначе, если поле `error` не заполнено — это ошибка, связанная со стабильностью источника. В таком случае мы рекомендуем игнорировать ответ и повторить запрос. В данном разделе описаны возможные коды ответов сервиса и их значения. Каждый код ответа сопровождается пояснением и примером JSON-ответа. #### 1. Код ответа - 200 Выдается сервисом в случае успешной валидации и успешной обработки запроса источником. Всегда сопровождается полем `Success = 1` в корне ответа. Именно такие и только такие запросы можно запускать в дальнейшую обработку. Пример ответа см. выше. #### 2. Код ответа - 403 Выдается сервисом в случае невозможности обработки запроса из-за ограничения доступа: закончилась подписка, превышен лимит и так далее. Причины ошибок отражены в поле `error` ответа. Ниже приведен список возможных ошибок с их описанием и кодами: - **Invalid access key** `error_code = 40201` Указанный ключ доступа недействителен или отсутствует. - **The subscription period has expired** `error_code = 40202` Доступ к сервису истек, требуется продление. - **Invalid IP** `error_code = 40203` Запрос выполнен с IP-адреса, который не разрешён для доступа. - **Day limit of requests exceeded** `error_code = 40204` Достигнут оплаченный лимит запросов на день. - **Month limit of requests exceeded** `error_code = 40205` Достигнут оплаченный лимит запросов на месяц. **Пример ответа:** ```json { "error": "Invalid access key", "error_code": 40201 } ``` #### 3. Код ответа - 400 Выдается сервисом в случае невозможности обработки запроса из-за ошибки валидации запроса, неверного или отсутствующего значения какого-либо поля. Поле `error_code` всегда равно `40001`, подробности доступны в поле `error`. **Пример ответа:** ```json { "error": "Invalid case type", "error_code": 40001 } ``` #### 4. Код ответа - 503 Выдается сервисом в случае успешной валидации и неуспешной обработки запроса источником. Связан с временными проблемами в работе источника, невозможностью получить информацию.