Інтегровані довкіллєві дозволи (ІДД)

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

Перелік справ ІДД

GET /api/v1/enterprises/{registry_id}/integrated-permit-cases

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

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

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

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

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

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "43732948" },
    "items": [
      {
        "id": 123,
        "registry_id": "000123/26",
        "status": "Попередній розгляд",
        "operator_name": "ТОВ \"ПРИКЛАД ОПЕРАТОР\"",
        "industrial_site_name": "Промисловий майданчик 1",
        "industrial_site_address": "Київська обл., Бориспільський р-н, м. Приклад, вул. Промислова, 1",
        "region": "Київська область",
        "submitted_at": "2026-05-01",
        "last_progress_at": "2026-05-14T09:30:00+03:00",
        "documents_count": 12,
        "installations_count": 2,
        "hearings_count": 1,
        "links": {
          "details": "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-case-details/123",
          "documents": "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-cases/123/documents",
          "hearings": "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-cases/123/hearings"
        }
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 3,
      "last_page": 1
    }
  },
  "stats": { "..." }
}

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

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

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

`results.items[]`

id: ідентифікатор справи ІДД.
registry_id: номер заяви.
status: поточний статус справи.
operator_name: оператор установки.
industrial_site_name: коротка назва проммайданчика або справи.
industrial_site_address: адреса проммайданчика зі справи.
region: регіон справи.
submitted_at: дата подання заяви.
last_progress_at: дата й час останнього зафіксованого руху справи з хронології реєстру.
documents_count: кількість документів у справі.
installations_count: кількість установок у справі.
hearings_count: кількість слухань у справі.
links.details: посилання на деталі справи ІДД.
links.documents: посилання на документи конкретної справи.
links.hearings: посилання на слухання конкретної справи.

Деталі справи ІДД

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

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

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

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

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-case-details/1" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

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

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "43732948" },
    "object": {
      "id": 123,
      "registry_id": "000123/26",
      "status": "Попередній розгляд",
      "operator_name": "ТОВ \"ПРИКЛАД ОПЕРАТОР\"",
      "industrial_site_name": "Промисловий майданчик 1",
      "industrial_site_address": "Київська обл., Бориспільський р-н, м. Приклад, вул. Промислова, 1",
      "region": "Київська область",
      "submitted_at": "2026-05-01",
      "last_progress_at": "2026-05-14T09:30:00+03:00",
      "registry_created_at": null,
      "registry_updated_at": "2026-05-14T09:30:00+03:00",
      "registry_url": "https://eco.gov.ua/intehrovanyi-dozvil/example-case-id",
      "documents_count": 12,
      "installations_count": 2,
      "hearings_count": 1,
      "progress": [
        {
          "sort_order": 1,
          "title": "Попередній розгляд",
          "date": "14.05.2026 о 09:30",
          "description": "Заява на отримання інтегрованого довкіллєвого дозволу на розгляді протягом 30 робочих днів."
        }
      ],
      "application_details": {
        "operator_address": "Україна, 01001, м. Київ, вул. Прикладна, буд. 10",
        "operator_contacts": {
          "phones": ["380441112233"],
          "emails": ["[email protected]"]
        },
        "contact_person": {
          "name": "Іваненко Іван Іванович",
          "role": "Директор з екології"
        },
        "prepared_by": {
          "name": "Петренко Олена Сергіївна"
        },
        "production_metrics": {
          "power_tons_per_day": 250,
          "operating_days_per_year": 320,
          "operating_hours_per_day": 16,
          "employees_count": 75
        }
      },
      "installations": [
        {
          "id": 501,
          "title": "Установка термічної обробки",
          "eia_case_number": "20261234567",
          "eia_case": {
            "id": 8801,
            "registry_id": "20261234567",
            "new_registry_id": null,
            "name": "Будівництво та експлуатація виробничого комплексу"
          },
          "installation_address": "Київська обл., Бориспільський р-н, м. Приклад",
          "industrial_site_address": "Київська обл., Бориспільський р-н, м. Приклад, вул. Промислова, 1",
          "cadastral_numbers": [
            "3210500000:01:001:0001",
            "3210500000:01:001:0002"
          ],
          "site_coordinates": {
            "latitude": 50.4501,
            "longitude": 30.5234,
            "is_swapped": false
          },
          "centroid_coordinates": {
            "latitude": 50.4505,
            "longitude": 30.523,
            "is_swapped": false
          },
          "sanitary_zone_summary": "Санітарно-захисна зона визначена відповідно до профільної документації.",
          "legal_documents": [
            {
              "title": "Право на земельну ділянку",
              "value": "Договір оренди земельної ділянки від 01.04.2026"
            }
          ],
          "documents_count": 6,
          "links": {
            "documents": "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-cases/123/documents?installation_id=501",
            "eia_case": "https://esg.saveecobot.com/api/v1/enterprises/43732948/eia-case-details/8801"
          }
        }
      ],
      "hearings": [
        {
          "id": 12,
          "title": "Громадське слухання щодо справи ІДД",
          "description": "Обговорення зауважень і пропозицій до заяви.",
          "starts_at": "2026-05-20T10:00:00+03:00",
          "ends_at": "2026-05-20T12:00:00+03:00",
          "location": "Будинок культури",
          "address": "м. Приклад, вул. Центральна, 5",
          "external_url": "https://eco.gov.ua/intehrovanyi-dozvil/example-hearing"
        }
      ]
    }
  },
  "stats": { "..." }
}

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

`results.object`

Поля id, registry_id, status, operator_name, industrial_site_name, industrial_site_address, region, submitted_at, documents_count, installations_count, hearings_count збігаються з переліком справ.

registry_created_at: дата створення запису в реєстрі, якщо вона є в джерелі.
registry_updated_at: дата останнього оновлення запису в реєстрі.
last_progress_at: дата й час останньої події з хронології руху справи.
registry_url: посилання на картку справи в офіційному реєстрі.
progress: етапи руху справи.
application_details: структуровані дані, витягнуті з основної заяви.
installations: перелік установок у межах справи.
hearings: слухання в межах справи.

`results.object.application_details`

operator_address: адреса оператора з основної заяви.
operator_contacts: телефони та email оператора.
contact_person: контактна особа по справі.
prepared_by: хто заповнив заяву.
production_metrics: короткі виробничі показники з нетехнічного резюме.

`results.object.installations[]`

id: ідентифікатор установки в ESG SaveEcoBot.
title: назва установки.
eia_case_number: номер пов’язаної справи ОВД, якщо його знайдено в заяві.
eia_case: коротка інформація про пов’язану справу ОВД, якщо її вдалося зіставити з даними ESG SaveEcoBot.
installation_address: адреса установки.
industrial_site_address: адреса проммайданчика для цієї установки.
cadastral_numbers: кадастрові номери, знайдені в заяві.
site_coordinates: координати проммайданчика установки.
centroid_coordinates: координати центроїда установки.
sanitary_zone_summary: короткий текстовий блок про санітарно-захисну зону.
legal_documents: правовстановлюючі та дозвільні документи, зазначені в заяві.
documents_count: кількість документів, прив’язаних до цієї установки.
links.documents: посилання на документи справи ІДД з фільтром installation_id для цієї установки.
links.eia_case: посилання на endpoint Деталі справи ОВД, якщо установка пов’язана зі справою ОВД в даних ESG SaveEcoBot.

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

GET /api/v1/enterprises/{registry_id}/integrated-permit-documents

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

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

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

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-documents" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

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

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "43732948" },
    "items": [
      {
        "id": 1,
        "name": "Заява про отримання інтегрованого довкіллєвого дозволу.pdf",
        "format": "pdf",
        "size": 654321,
        "uploaded_at": "2026-04-16T20:27:12+00:00",
        "section": "case",
        "installation_title": null,
        "links": {
          "download": "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-documents/1/download"
        },
        "case": {
          "id": 1,
          "registry_id": "000056/26",
          "industrial_site_name": "ТОРГТЕХНІКА",
          "region": "Вінницька область"
        }
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 35,
      "last_page": 2
    }
  },
  "stats": { "..." }
}

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

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

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

`results.items[]`

id: ідентифікатор документа.
name: назва документа.
format: формат файла.
size: розмір файла в байтах.
uploaded_at: дата документа з реєстру або сторінки справи.
section: рівень документа: case або installation.
installation_title: назва установки, якщо документ прив’язаний до установки.
links.download: посилання на завантаження документа.
case: коротка інформація про справу ІДД.

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

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

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

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

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-cases/1/documents?installation_id=3" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

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

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "43732948" },
    "object": {
      "id": 1,
      "registry_id": "000056/26",
      "industrial_site_name": "ТОРГТЕХНІКА"
    },
    "items": [
      {
        "id": 36,
        "name": "Усі відомості про установку Завод по виробництву пульпи м.Вінниця.pdf",
        "format": "pdf",
        "size": 123456,
        "uploaded_at": "2026-03-12T15:26:00+00:00",
        "section": "installation",
        "installation_title": "Завод по виробництву пульпи м.Вінниця",
        "links": {
          "download": "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-documents/36/download"
        }
      }
    ]
  },
  "stats": { "..." }
}

Фільтри

installation_id: якщо передано, повертаються лише документи вибраної установки в межах справи.

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

GET /api/v1/enterprises/{registry_id}/integrated-permit-hearings

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

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

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

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

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

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "43732948" },
    "items": [
      {
        "id": 12,
        "title": "Громадське слухання щодо справи ІДД",
        "description": "Обговорення зауважень і пропозицій до заяви на отримання інтегрованого довкіллєвого дозволу.",
        "starts_at": "2026-05-10T10:00:00+03:00",
        "ends_at": "2026-05-10T12:00:00+03:00",
        "location": "Вінницька міська рада",
        "address": "м. Вінниця, вул. Соборна, 59",
        "external_url": "https://eco.gov.ua/intehrovanyi-dozvil/example-hearing",
        "case": {
          "id": 1,
          "registry_id": "000056/26",
          "industrial_site_name": "ТОРГТЕХНІКА"
        }
      }
    ]
  },
  "stats": { "..." }
}

Це приклад структури відповіді. У поточних живих даних слухань може ще не бути, тому items може бути порожнім.

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

`results.items[]`

id: ідентифікатор слухання.
title: назва слухання.
description: текстовий опис.
starts_at: дата і час початку, якщо є.
ends_at: дата і час завершення, якщо є.
location: коротка назва місця проведення.
address: адреса проведення.
external_url: зовнішнє посилання на джерело.
case: коротка інформація про справу ІДД.

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

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

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

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

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/43732948/integrated-permit-cases/1/hearings" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

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

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "43732948" },
    "object": {
      "id": 1,
      "registry_id": "000056/26",
      "industrial_site_name": "ТОРГТЕХНІКА"
    },
    "items": [
      {
        "id": 12,
        "title": "Громадське слухання щодо справи ІДД",
        "description": "Обговорення зауважень і пропозицій до заяви на отримання інтегрованого довкіллєвого дозволу.",
        "starts_at": "2026-05-10T10:00:00+03:00",
        "ends_at": "2026-05-10T12:00:00+03:00",
        "location": "Вінницька міська рада",
        "address": "м. Вінниця, вул. Соборна, 59",
        "external_url": "https://eco.gov.ua/intehrovanyi-dozvil/example-hearing"
      }
    ]
  },
  "stats": { "..." }
}

Це приклад структури відповіді. У поточних живих даних для конкретної справи масив items може бути порожнім.

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

GET /api/v1/enterprises/{registry_id}/integrated-permit-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/43732948/integrated-permit-documents/1/download" \
  -H "Authorization: Bearer $ESG_API_TOKEN"

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

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

Перелік справ ІДД

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

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

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

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

results.items[]

Деталі справи ІДД

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

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

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

results.object

results.object.application_details

results.object.installations[]

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

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

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

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

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

results.items[]

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

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

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

Фільтри

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

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

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

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

results.items[]

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

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

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

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

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

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

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

`results.items[]`

`results.object`

`results.object.application_details`

`results.object.installations[]`

`results.items[]`

`results.items[]`