Unless stated otherwise, this page refers to Ukrainian companies and individual entrepreneurs and uses identifiers from Ukrainian public registries.
This is the main request that usually serves as the starting point for working with data for a specific enterprise in ESG SaveEcoBot API.
The response returns basic information about a Ukrainian enterprise, a link to the timeline, and a list of available data sections. Some sections are simple, such as addresses, contacts, or activity types, while others are domain-specific and lead to separate data on permits, registries, reports, notices, EIA, SEA, and other thematic sections.
GET /api/v1/enterprises/{registry_id}
The response returns the main enterprise data, the timeline, and sections with links to related pages.
The registry_id parameter in the request path is required. It is the enterprise identifier from a Ukrainian registry.
Example request
$ 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'
Example response
{
"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": { "..." }
}
Response fields
results.enterprise
type: enterprise type. Possible values:companyorfop.registry_id: enterprise identifier.name: full enterprise name as ofedr_updated_at.name_short: short name, if available, as ofedr_updated_at.status: current enterprise status in the state register, as ofedr_updated_at.registration_date: state registration date, as ofedr_updated_at.address: legal address of the enterprise, as ofedr_updated_at.activity: primary activity, as ofedr_updated_at.edr_updated_at: date of the latest state-register data update in the system.created_at: date when the ESG enterprise profile was created in ESG SaveEcoBot.
results.timeline
link: link to the enterprise timeline request.total: total number of timeline records, if already prepared.last_event_at: date and time of the latest timeline event, if available.
results.sections
results.sections is the list of sections available for the enterprise. Some sections are simple non-domain blocks, such as addresses or contacts. Sections that contain groups are data domains, such as air, water, waste, eia, or sea.
results.sections.{section_key}
A simple section block, for example addresses, contacts, or activity types.
label: section name.total: number of records in the section.link: link to the list endpoint.
results.sections.{section_key} with groups
A section where data is grouped into subsections.
label: name of the main section.groups: subsections grouped by business logic.
results.sections.{section_key}.groups.{group_key}
A simple subsection inside a larger section.
label: subsection name.total: number of records in the subsection.total_pdf: number of files in the subsection, if this metric applies.link: link to the list endpoint.
results.sections.{section_key}.groups.{group_key} with types
A subsection where records are additionally grouped by types.
label: subsection name.total: total number of records in the subsection.total_pdf: total number of files in the subsection, if this metric applies.types[]: list of types inside the subsection.types[].id: type identifier.types[].label: type name.types[].total: number of records of this type.types[].total_pdf: number of files of this type, if applicable.types[].link: link to the filtered list.link: link to the list endpoint.
