Деталі підприємства

Це основний запит, з якого зазвичай починають роботу з даними конкретного підприємства в ESG SaveEcoBot API.

У відповіді ви отримаєте базову інформацію про підприємство, посилання на таймлайн і перелік доступних секцій даних. Частина секцій є простими, наприклад, адреси, контакти або види діяльності, а частина є доменними й веде до окремих даних про дозволи, реєстри, звіти, повідомлення, ОВД, СЕО та інші тематичні розділи.

GET /api/v1/enterprises/{registry_id}

У відповіді повертаються основні дані підприємства, таймлайн і секції з посиланнями на пов’язані розділи.

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

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

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

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

{
  "results": {
    "enterprise": {
      "type": "company",
      "registry_id": "00178353",
      "name": "ПРИКЛАД ПІДПРИЄМСТВА",
      "name_short": "ПРИКЛАД",
      "status": "зареєстровано",
      "registration_date": "2004-03-12",
      "address": "Україна, Київська область, місто Київ",
      "activity": "Виробництво хімічної продукції",
      "edr_updated_at": "2026-05-10",
      "created_at": "2025-11-02T11:15:44+02:00"
    },
    "timeline": {
      "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/timeline",
      "total": 34,
      "last_event_at": "2026-05-08T16:12:00+03:00"
    },
    "sections": {
      "addresses": {
        "label": "Адреси",
        "total": 2,
        "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/addresses"
      },
      "air": {
        "label": "Повітря",
        "groups": {
          "permissions": {
            "label": "Дозволи, ліцензії та декларації",
            "total": 23,
            "types": [
              {
                "id": 1,
                "label": "Дозвіл на викиди забруднюючих речовин в атмосферне повітря",
                "total": 23,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/permissions/air?permission_type_id=1"
              }
            ],
            "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/permissions/air"
          },
          "reports": {
            "label": "Звіти",
            "total": 2,
            "total_pdf": 2,
            "types": [
              {
                "id": 9,
                "label": "Звіт про викиди забруднюючих речовин і парникових газів в атмосферне повітря від стаціонарних джерел викидів – № 2-ТП (повітря) (річна) (Держстат)",
                "total": 2,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/reports/air?report_type_id=9",
                "years": {
                  "min": 2020,
                  "max": 2021
                }
              }
            ],
            "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/reports/air"
          },
          "notices": {
            "label": "Повідомлення про наміри",
            "total": 6,
            "total_pdf": 6,
            "types": [
              {
                "id": 1,
                "label": "Заява про наміри отримати дозвіл на викиди забруднюючих речовин в атмосферне повітря",
                "total": 6,
                "total_pdf": 6,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/notices/air?notice_type_id=1"
              }
            ],
            "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/notices/air"
          }
        }
      },
      "activity_types": {
        "label": "Види економічної діяльності",
        "total": 1,
        "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/activity-types"
      },
      "eia": {
        "label": "ОВД",
        "groups": {
          "cases": {
            "label": "Справи",
            "total": 6,
            "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases"
          },
          "documents": {
            "label": "Документи",
            "total": 41,
            "total_pdf": 41,
            "types": [
              {
                "id": 1,
                "label": "Повідомлення про плановану діяльність",
                "total": 6,
                "total_pdf": 6,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents?document_type_id=1"
              },
              {
                "id": 2,
                "label": "Зауваження і пропозиції громадськості до планованої діяльності, обсягу досліджень",
                "total": 6,
                "total_pdf": 6,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents?document_type_id=2"
              },
              {
                "id": 3,
                "label": "Оголошення про початок громадського обговорення звіту з ОВД",
                "total": 5,
                "total_pdf": 5,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents?document_type_id=3"
              },
              {
                "id": 4,
                "label": "Звіт з ОВД",
                "total": 5,
                "total_pdf": 5,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents?document_type_id=4"
              },
              {
                "id": 6,
                "label": "Звіт про громадське обговорення",
                "total": 4,
                "total_pdf": 4,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents?document_type_id=6"
              },
              {
                "id": 10,
                "label": "Висновок з оцінки впливу на довкілля",
                "total": 4,
                "total_pdf": 4,
                "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents?document_type_id=10"
              }
            ],
            "link": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents"
          }
        }
      }
    }
  },
  "stats": { "..." }
}

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

`results.enterprise`

type: тип підприємства. Можливі значення: company або fop.
registry_id: ідентифікатор підприємства.
name: повна назва підприємства. Станом на edr_updated_at.
name_short: скорочена назва, якщо вона є. Станом на edr_updated_at.
status: поточний статус підприємства в ЄДР. Станом на edr_updated_at.
registration_date: дата державної реєстрації. Станом на edr_updated_at.
address: юридична адреса підприємства. Станом на edr_updated_at.
activity: основний вид діяльності. Станом на edr_updated_at.
edr_updated_at: дата останнього оновлення даних ЄДР у системі.
created_at: дата створення ESG профілю підприємства в системі ESG SaveEcoBot.

`results.timeline`

link: посилання на запит таймлайна підприємства.
total: загальна кількість записів у таймлайні, якщо його вже підготовлено.
last_event_at: дата й час останньої події у таймлайні, якщо вони доступні.

`results.sections`

results.sections — це перелік секцій, доступних для підприємства. Частина секцій є простими недоменними блоками, наприклад адреси або контакти. Секції, у яких є groups, — це домени даних, наприклад air, water, waste, eia або sea.

`results.sections.{section_key}`

Простий блок секції, наприклад, адреси, контакти або види діяльності.

label: назва секції.
total: кількість записів у секції.
link: посилання на перелік записів.

`results.sections.{section_key}` з групами

Секція, у якій дані згруповані за підсекціями.

label: назва великої секції.
groups: підсекції, згруповані за бізнес-логікою.

`results.sections.{section_key}.groups.{group_key}`

Простий підблок усередині великої секції.

label: назва підсекції.
total: кількість записів у підсекції.
total_pdf: кількість файлів у підсекції, якщо така метрика застосовується.
link: посилання на перелік записів.

`results.sections.{section_key}.groups.{group_key}` з типами

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

label: назва підсекції.
total: загальна кількість записів у підсекції.
total_pdf: загальна кількість файлів у підсекції, якщо така метрика застосовується.
types[]: перелік типів усередині підсекції.
types[].id: ідентифікатор типу.
types[].label: назва типу.
types[].total: кількість записів цього типу.
types[].total_pdf: кількість файлів цього типу, якщо застосовується.
types[].link: посилання на відфільтрований перелік.
link: посилання на перелік записів.

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

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

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

results.enterprise

results.timeline

results.sections

results.sections.{section_key}

results.sections.{section_key} з групами

results.sections.{section_key}.groups.{group_key}

results.sections.{section_key}.groups.{group_key} з типами

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