Оцінка впливу на довкілля (ОВД)

У цьому розділі описані запити для роботи зі справами, документами та громадськими слуханнями, пов'язаними з оцінкою впливу на довкілля.

Перелік справ ОВД

GET /api/v1/enterprises/{registry_id}/eia-cases

Цей запит повертає справи з оцінки впливу на довкілля, які пов'язані з підприємством. Разом із переліком справ повертаються основні дані по кожній справі, кількість документів і слухань, а також посилання на вкладені запити по кожній справі.

Параметр registry_id в адресі запиту є обов'язковим — це ідентифікатор підприємства.

Приклад запиту

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Приклад відповіді

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "items": [
      {
        "id": 9132,
        "registry_id": "7723",
        "old_registry_id": "2023123456",
        "registry_type": "Екосистема",
        "authority_name": "Департаменту агропромислового розвитку, екології та природних ресурсів Вінницької облдержадміністрації",
        "name": "Реконструкція виробничого майданчика",
        "address": "Україна, Київська область, місто Київ",
        "description": "Планована діяльність",
        "region": "Київська область",
        "published_at": "2025-03-01",
        "documents_count": 6,
        "hearings_count": 1,
        "links": {
          "details": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-case-details/9132",
          "documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/documents",
          "hearings": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/hearings"
        },
        "coordinates": null
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 6,
      "last_page": 1
    }
  },
  "stats": { "..." }
}

Параметри пагінації

page: номер сторінки.

Поля відповіді

`results.items[]`

id: ідентифікатор справи.
registry_id: реєстраційний номер справи.
old_registry_id: реєстраційний номер справи зі старого реєстру ОВД. Якщо номер відсутній, повертається null.
registry_type: тип реєстру ОВД, в якому ведеться справа: Екосистема або Старий реєстр.
authority_name: орган, який веде або оприлюднив справу.
name: назва справи.
address: адреса об'єкта справи.
description: короткий опис справи.
region: регіон справи.
published_at: дата публікації справи.
documents_count: кількість документів у справі.
hearings_count: кількість громадських слухань.
links.details: посилання на деталі справи ОВД.
links.documents: посилання на документи конкретної справи.
links.hearings: посилання на слухання конкретної справи.
coordinates: координати адреси, якщо доступ до них дозволений для ключа.
coordinates.latitude: широта.
coordinates.longitude: довгота.

Деталі справи ОВД

GET /api/v1/enterprises/{registry_id}/eia-case-details/{case_id}

Цей запит повертає повні дані конкретної справи ОВД. У відповіді ви отримаєте той самий набір полів, що й у переліку справ, а також блок links для переходу до документів і слухань цієї справи.

Параметри registry_id і case_id в адресі запиту є обов'язковими. registry_id — це ідентифікатор підприємства. case_id — це ідентифікатор справи ОВД.

Приклад запиту

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-case-details/9132" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Приклад відповіді

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "object": {
      "id": 9132,
      "registry_id": "7723",
      "old_registry_id": "2023123456",
      "registry_type": "Екосистема",
      "authority_name": "Департаменту агропромислового розвитку, екології та природних ресурсів Вінницької облдержадміністрації",
      "name": "Реконструкція виробничого майданчика",
      "address": "Україна, Київська область, місто Київ",
      "description": "Планована діяльність",
      "region": "Київська область",
      "published_at": "2025-03-01",
      "documents_count": 6,
      "hearings_count": 1,
      "coordinates": null,
      "links": {
        "documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/documents",
        "hearings": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/hearings"
      }
    }
  },
  "stats": { "..." }
}

Поля відповіді

`results.object`

Поля об'єкта ті самі, що й у results.items[] в переліку справ ОВД.

`results.object.links`

documents: посилання на документи цієї справи.
hearings: посилання на слухання цієї справи.

Документи ОВД підприємства

GET /api/v1/enterprises/{registry_id}/eia-documents

Цей запит повертає усі документи ОВД, пов'язані з підприємством. Разом із кожним документом повертається короткий блок case, який вказує, до якої справи належить кожен запис.

Параметр registry_id в адресі запиту є обов'язковим — це ідентифікатор підприємства.

Приклад запиту

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents?document_type_id=1" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Приклад відповіді

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "items": [
      {
        "id": 79733,
        "registry_id": null,
        "type_id": 1,
        "type_name": "Повідомлення про плановану діяльність",
        "name": "Повідомлення про плановану діяльність",
        "format": "pdf",
        "size": 120972,
        "uploaded_at": "2025-03-01T10:00:00+00:00",
        "downloaded_at": "2025-03-01T10:30:00+00:00",
        "links": {
          "download": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents/79733/download"
        },
        "case": {
          "id": 9132,
          "registry_id": "2023123456",
          "old_registry_id": "2023123456",
          "registry_type": "Екосистема",
          "authority_name": "Міндовкілля",
          "name": "Реконструкція виробничого майданчика",
          "address": "Україна, Київська область, місто Київ",
          "region": "Київська область",
          "published_at": "2025-03-01"
        }
      }
    ]
  },
  "stats": { "..." }
}

Параметри пагінації

page: номер сторінки.

Фільтри

document_type_id: тип документа. Доступні значення можна отримати в запиті Типи документів ОВД.

Поля відповіді

`results.items[]`

id: ідентифікатор документа.
registry_id: реєстраційний номер документа.
type_id: ідентифікатор типу документа.
type_name: назва типу документа.
name: назва файла документа.
format: формат файла.
size: розмір файла в байтах.
uploaded_at: дата, коли файл було завантажено або оприлюднено в джерелі.
downloaded_at: дата, коли файл був завантажений у систему ESG SaveEcoBot.
links.download: посилання на завантаження документа.
case: коротка інформація про справу, до якої належить документ.
case.id: ідентифікатор справи.
case.registry_id: реєстраційний номер справи.
case.old_registry_id: реєстраційний номер справи зі старого реєстру ОВД.
case.registry_type: тип реєстру ОВД: Екосистема або Старий реєстр.
case.authority_name: орган по справі.
case.name: назва справи.
case.address: адреса об'єкта справи.
case.region: регіон справи.
case.published_at: дата публікації справи.

Завантаження документа ОВД

GET /api/v1/enterprises/{registry_id}/eia-documents/{document_id}/download

Цей запит повертає бінарний файл документа ОВД для завантаження.

Параметри registry_id і document_id в адресі запиту є обов'язковими. registry_id — це ідентифікатор підприємства. document_id — це ідентифікатор документа ОВД.

Приклад запиту

$ ESG_API_TOKEN="your_api_token"
$ curl -L "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents/79733/download" \
  -H "Authorization: Bearer $ESG_API_TOKEN"

Приклад відповіді

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="eia-document.pdf"

Слухання ОВД підприємства

GET /api/v1/enterprises/{registry_id}/eia-hearings

Цей запит повертає громадські слухання по справах ОВД. Разом із переліком слухань повертається короткий блок object, який вказує, до якої справи належить кожен запис.

Параметр registry_id в адресі запиту є обов'язковим — це ідентифікатор підприємства.

Приклад запиту

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/24584661/eia-hearings" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Приклад відповіді

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "24584661" },
    "items": [
      {
        "id": 1414,
        "datetime": "2024-12-27T16:00:00+00:00",
        "url": "https://mepr.webex.com/mepr-ru/j.php?MTID=m347a70d922c095c69f36467802c02558 Номер наради: 2365 701 6692 Пароль: spM598DDXx5",
        "address": null,
        "comments": null,
        "object": {
          "id": 9035,
          "registry_id": "5333",
          "old_registry_id": null,
          "registry_type": "Екосистема",
          "authority_name": "Міністерство захисту довкілля та природних ресурсів України",
          "name": "Будівництво енергоблоків № 5, 6 з реакторною установкою АР1000 на майданчику Хмельницької АЕС",
          "address": null,
          "region": "Хмельницька область",
          "published_at": "2024-03-29"
        }
      }
    ]
  },
  "stats": { "..." }
}

Параметри пагінації

page: номер сторінки.

Поля відповіді

`results.items[]`

id: ідентифікатор слухання.
datetime: дата й час слухання.
url: посилання на громадські слухання у разі проведення онлайн.
address: адреса проведення слухання.
comments: додаткові коментарі.
object: коротка інформація про справу, до якої належить слухання.
object.id: ідентифікатор справи.
object.registry_id: реєстраційний номер справи.
object.old_registry_id: реєстраційний номер справи зі старого реєстру ОВД.
object.registry_type: тип реєстру ОВД: Екосистема або Старий реєстр.
object.authority_name: орган по справі.
object.name: назва справи.
object.address: адреса об'єкта справи.
object.region: регіон справи.
object.published_at: дата публікації справи.

Документи справи ОВД

GET /api/v1/enterprises/{registry_id}/eia-cases/{case_id}/documents

Цей запит повертає документи конкретної справи ОВД. Разом із переліком документів повертається блок object з короткою інформацією про саму справу.

Приклад запиту

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/documents?document_type_id=1" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Приклад відповіді

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "object": {
      "id": 9132,
      "registry_id": "2023123456",
      "old_registry_id": "2023123456",
      "registry_type": "Екосистема",
      "name": "Реконструкція виробничого майданчика"
    },
    "items": [
      {
        "id": 79733,
        "registry_id": "DOC-001",
        "type_id": 1,
        "type_name": "Повідомлення про плановану діяльність",
        "name": "Повідомлення про плановану діяльність.pdf",
        "format": "pdf",
        "size": 120972,
        "uploaded_at": "2025-03-01T10:00:00+00:00",
        "downloaded_at": "2025-03-01T10:30:00+00:00",
        "links": {
          "download": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents/79733/download"
        }
      }
    ]
  },
  "stats": { "..." }
}

Фільтри

document_type_id: тип документа. Доступні значення можна отримати в запиті Типи документів ОВД.

Поля відповіді

`results.object`

id: ідентифікатор справи.
registry_id: реєстраційний номер справи.
old_registry_id: реєстраційний номер справи зі старого реєстру ОВД.
registry_type: тип реєстру ОВД: Екосистема або Старий реєстр.
name: назва справи.

`results.items[]`

Поля елемента ті самі, що й у глобальному списку документів, але без вкладеного object.

Слухання у справі ОВД

GET /api/v1/enterprises/{registry_id}/eia-cases/{case_id}/hearings

Цей запит повертає слухання конкретної справи ОВД. Разом із переліком слухань повертається блок object з короткою інформацією про саму справу.

Приклад запиту

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/hearings" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Приклад відповіді

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "object": {
      "id": 9035,
      "registry_id": "5333",
      "old_registry_id": null,
      "registry_type": "Екосистема",
      "name": "Будівництво енергоблоків № 5, 6 з реакторною установкою АР1000 на майданчику Хмельницької АЕС"
    },
    "items": [
      {
        "id": 1414,
        "datetime": "2024-12-27T16:00:00+00:00",
        "url": "https://mepr.webex.com/mepr-ru/j.php?MTID=m347a70d922c095c69f36467802c02558 Номер наради: 2365 701 6692 Пароль: spM598DDXx5",
        "address": null,
        "comments": null
      }
    ]
  },
  "stats": { "..." }
}

Поля відповіді

`results.object`

id: ідентифікатор справи.
registry_id: реєстраційний номер справи.
old_registry_id: реєстраційний номер справи зі старого реєстру ОВД.
registry_type: тип реєстру ОВД: Екосистема або Старий реєстр.
name: назва справи.

`results.items[]`

Поля елемента ті самі, що й у глобальному списку слухань, але без вкладеного object.

Перелік справ ОВД

Приклад запиту

Приклад відповіді

Параметри пагінації

Поля відповіді

results.items[]

Деталі справи ОВД

Приклад запиту

Приклад відповіді

Поля відповіді

results.object

results.object.links

Документи ОВД підприємства

Приклад запиту

Приклад відповіді

Параметри пагінації

Фільтри

Поля відповіді

results.items[]

Завантаження документа ОВД

Приклад запиту

Приклад відповіді

Слухання ОВД підприємства

Приклад запиту

Приклад відповіді

Параметри пагінації

Поля відповіді

results.items[]

Документи справи ОВД

Приклад запиту

Приклад відповіді

Фільтри

Поля відповіді

results.object

results.items[]

Слухання у справі ОВД

Приклад запиту

Приклад відповіді

Поля відповіді

results.object

results.items[]

Візьміть участь в тестуванні ESG профілю підприємства у системі SaveEcoBot

`results.items[]`

`results.object`

`results.object.links`

`results.items[]`

`results.items[]`

`results.object`

`results.items[]`

`results.object`

`results.items[]`