У цьому розділі описані запити для роботи з судовими справами з екологічними ознаками та пов'язаними судовими документами.
Дисклеймер. Показано лише попередньо відібрані екологічно або довкіллєво релевантні судові справи та рішення. Відбір здійснюється за екологічними статтями, категоріями, ключовими словами та іншими текстовими маркерами, тому окремі релевантні документи можуть бути ще не виявлені або потребувати додаткової перевірки. Розділ перебуває у розробці, і ми поступово розширюємо покриття, точність відбору та якість звʼязування документів із підприємствами.
Перелік судових справ з екологічними ознаками
GET /api/v1/enterprises/{registry_id}/eco-court-cases
Цей запит повертає судові справи, які система пов'язала з підприємством і визначила як екологічно релевантні. Разом із переліком справ повертаються основні дані по кожній справі, кількість документів і посилання на окремий запит із документами конкретної справи.
Параметр registry_id в адресі запиту є обов'язковим — це ідентифікатор підприємства.
Приклад запиту
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-cases" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Приклад відповіді
Параметри пагінації
page: номер сторінки.
Фільтри
year: рік судової справи.
Поля відповіді
results.items[]
id: ідентифікатор судової справи.year: рік справи.cause_num: номер справи.court: назва суду.justice_kind: тип судочинства.documents_count: кількість документів у справі.enterprise_links_count: кількість зв'язків підприємства зі справою.eco_status: короткий екологічний статус справи.eco_score: внутрішня екологічна оцінка або індикатор релевантності.first_document_adjudication_at: дата найпершого документа у справі.last_document_adjudication_at: дата найновішого документа у справі.links.details: посилання на деталі справи.links.documents: посилання на окремий endpoint документів цієї справи.representative_document: короткий блок про репрезентативний документ справи.representative_document.id: ідентифікатор документа.representative_document.doc_id: зовнішній або державний ідентифікатор документа.representative_document.judgment_form: форма судового документа.representative_document.adjudication_at: дата ухвалення.representative_document.published_at: дата оприлюднення.representative_document.links.registry: посилання на сторінку документа в Єдиному державному реєстрі судових рішень.
Деталі судової справи з екологічними ознаками
GET /api/v1/enterprises/{registry_id}/eco-court-case-details/{court_case_id}
Цей запит повертає деталі конкретної судової справи з екологічними ознаками. У відповіді також повертається посилання на окремий endpoint документів цієї справи.
Параметри registry_id і court_case_id в адресі запиту є обов'язковими. registry_id — це ідентифікатор підприємства. court_case_id — це ідентифікатор судової справи.
Приклад запиту
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-case-details/11177" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Приклад відповіді
Поля відповіді
results.object
id: ідентифікатор судової справи.year: рік справи.cause_num: номер справи.court: назва суду.justice_kind: тип судочинства.documents_count: кількість документів у справі.enterprise_links_count: кількість зв'язків підприємства зі справою.eco_status: короткий екологічний статус справи.eco_score: внутрішня екологічна оцінка або індикатор релевантності.first_document_adjudication_at: дата найпершого документа у справі.last_document_adjudication_at: дата найновішого документа у справі.links.documents: посилання на окремий endpoint документів цієї справи.representative_document: короткий блок про репрезентативний документ справи.representative_document.id: ідентифікатор документа.representative_document.doc_id: зовнішній або державний ідентифікатор документа.representative_document.judgment_form: форма судового документа.representative_document.adjudication_at: дата ухвалення.representative_document.published_at: дата оприлюднення.representative_document.links.registry: посилання на сторінку документа в Єдиному державному реєстрі судових рішень.
Документи однієї судової справи з екологічними ознаками
GET /api/v1/enterprises/{registry_id}/eco-court-cases/{court_case_id}/documents
Цей запит повертає всі документи конкретної судової справи з екологічними ознаками. Разом із переліком документів повертається блок object з короткою інформацією про саму справу.
Параметри registry_id і court_case_id в адресі запиту є обов'язковими. registry_id — це ідентифікатор підприємства. court_case_id — це ідентифікатор судової справи.
Приклад запиту
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-cases/11177/documents" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Приклад відповіді
Поля відповіді
results.object
id: ідентифікатор судової справи.cause_num: номер справи.year: рік справи.court: назва суду.justice_kind: тип судочинства.
results.items[]
Поля елемента ті самі, що й у переліку документів підприємства, але без вкладеного блоку case.
Документи судових справ з екологічними ознаками підприємства
GET /api/v1/enterprises/{registry_id}/eco-court-documents
Цей запит повертає судові документи, пов'язані з підприємством. Разом із переліком документів повертається блок case, з короткою інформацією про справу.
Параметр registry_id в адресі запиту є обов'язковим — це ідентифікатор підприємства.
Приклад запиту
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-documents" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Приклад відповіді
Параметри пагінації
page: номер сторінки.
Фільтри
year: рік судового документа або справи.court_case_id: необов’язково обмежує документи однією судовою справою.
Поля відповіді
results.items[]
id: ідентифікатор документа.doc_id: зовнішній або державний ідентифікатор документа.year: рік документа.cause_num: номер судової справи.court: назва суду.judgment_form: форма документа.justice_kind: тип судочинства.status: статус документа.adjudication_at: дата ухвалення.receipt_at: дата надходження або реєстрації.published_at: дата оприлюднення.is_full_text: ознака того, що доступний повний текст.eco_score: екологічна оцінка документа.links.registry: посилання на сторінку документа в Єдиному державному реєстрі судових рішень.case: короткий блок із даними про справу.case.id: ідентифікатор справи.case.cause_num: номер справи.case.year: рік справи.case.links.documents: посилання на окремий endpoint документів цієї справи.
