Загрузка...
image

Автоматизация работы с kad.arbitr.ru

На данной странице вы можете протестировать работу сервиса API для получения информации с kad.arbitr.ru. Сервис работает через http запросы (ИНН или номер дела). В ответ на каждый запрос вы получаете JSON с нужной информацией.

По ИНН физ или юр лица вы можете получить все дела, в которых это лицо было участником (истцом, ответчиком или третьим лицом).

По номеру дела вы можете получить ИНН, ОГРН, адреса участников; инстанции дела; все события, зарегистрированные по каждой инстанции; ссылки на документы в электронном виде; даты всех судебных заседаний.

С форматом входных параметров и ответа сервера вы можете ознакомиться в разделе Документация (текстовая версия, OpenAPI версия).

Также рекомендуем ознакомиться с интерактивной версией документации, в которой можно выполнять любые запросы к сервису и сохранять примеры кода на нужном языке для дальнейшей интеграции.

В разделе Проверьте возможности API можно потестировать, какие ответы вы получите по интересующим запросам.

Для подключения к сервису отправьте заявку через форму или напишите на email: support@parser-api.com.

Отправьте заявку на подключение

Оперативно подготовим всю необходимую информацию.

image

Документация

Сервис поддерживает три типа запросов:

  1. Поиск дел — для поиска дел по различным параметрам.
  2. Получение детальной информации по номеру дела — для получения подробной информации о деле по его номеру.
  3. Получение детальной информации по ID дела — для получения подробной информации о деле по его уникальному идентификатору.

Все запросы требуют указания ключа доступа (key).

1. Поиск дел

Для поиска дел используйте следующий запрос:

https://parser-api.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://parser-api.com/parser/arbitr_api/search?key=ВАШ_КЛЮЧ_ДОСТУПА&DateFrom=2020-10-16&DateTo=2020-11-16&Inn=РОСНЕФТЬ&InnType=Any&Court=АС%20Московской%20области

Пример ответа на поисковый запрос:

Ответ на запрос возвращается в формате 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://parser-api.com/parser/arbitr_api/details_by_number?key=ВАШ_КЛЮЧ_ДОСТУПА&CaseNumber=НОМЕР_ДЕЛА

Параметры:

  • CaseNumber — номер дела (обязательный).

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

https://parser-api.com/parser/arbitr_api/details_by_number?key=ВАШ_КЛЮЧ_ДОСТУПА&CaseNumber=%D0%9065-1529/2021

3. Получение детальной информации по ID дела

Для получения детальной информации по уникальному идентификатору дела используйте следующий запрос:

https://parser-api.com/parser/arbitr_api/details_by_id?key=ВАШ_КЛЮЧ_ДОСТУПА&CaseId=ID_ДЕЛА

Параметры:

  • CaseId — уникальный идентификатор дела (обязательный).

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

https://parser-api.com/parser/arbitr_api/details_by_id?key=ВАШ_КЛЮЧ_ДОСТУПА&CaseId=b82051d4-9713-4dcd-8de5-ef6d18d8ac66

Пример ответа на запрос детальной информации:

Ответ на запрос возвращается в формате 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 не заполнено — это ошибка, связанная со стабильностью источника. В таком случае мы рекомендуем игнорировать ответ и повторить запрос сразу, затем через 5 минут, через 15 минут, и далее повторять каждый час.

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 Достигнут оплаченный лимит запросов на месяц.

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

{
  "error": "Invalid access key",
  "error_code": 40201
}

3. Код ответа - 400

Выдается сервисом в случае невозможности обработки запроса из-за ошибки валидации запроса, неверного или отсутствующего значения какого-либо поля. Поле error_code всегда равно 40001, подробности доступны в поле error.

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

{
  "error": "Invalid case type",
  "error_code": 40001
}

4. Код ответа - 523

Выдается сервисом в случае успешной валидации и неуспешной обработки запроса источником. Связан с временными проблемами в работе источника, невозможностью получить информацию.

Проверьте возможности API

Инстанции и ИНН/ОГРН участников доступны только при поиске по номеру дела. Введите ИНН или номер дела:

image