Unless stated otherwise, this page refers to Ukrainian companies and individual entrepreneurs and uses identifiers from Ukrainian public registries.
Dictionaries return domains, types, and timeline events used in ESG SaveEcoBot API.
All requests on this page are independent of a specific enterprise. They help you understand in advance which values can be used in filters and request parameters in other API endpoints.
Data domains
GET /api/v1/dictionaries/data-domains
This request returns the major data domains used in ESG SaveEcoBot API.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/dictionaries/data-domains" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Response fields
results.items[]: list of domains.slug: technical domain code used in URLs and filters.label: human-readable domain name.
Permission types
GET /api/v1/dictionaries/permission-types
Returns permission, license, declaration, and conclusion types used in the permissions section.
Filters
domain: technical domain code.
Report types
GET /api/v1/dictionaries/report-types
Returns report types used in report requests.
Filters
domain: technical domain code.
Registry types
GET /api/v1/dictionaries/registry-types
Returns registry record types used in registry requests.
Filters
domain: technical domain code.
Notice types
GET /api/v1/dictionaries/notice-types
Returns notice types used in notice requests.
Filters
domain: technical domain code.
Obligation types
GET /api/v1/dictionaries/obligation-types
Returns obligation types used in obligation requests.
Filters
domain: technical domain code.
Certificate types
GET /api/v1/dictionaries/certificate-types
Returns certificate types used in certificate requests.
Filters
domain: technical domain code.
Complaint types
GET /api/v1/dictionaries/complaint-types
Returns complaint types used in complaint requests.
Filters
domain: technical domain code.
Inspection super types
GET /api/v1/dictionaries/inspection-super-types
Returns high-level inspection categories used in inspection filtering.
Timeline events
GET /api/v1/dictionaries/timeline-events
Returns available timeline event codes together with a human-readable label and resource mapping.
Response fields
event: technical event code, for examplecreated_permission_file.label: short human-readable label.resource: technical code of the main resource type, for examplereport,permission_file,registry, orcourt_case.parent_resource: technical code of the parent resource type for nested resources, if present.
EIA document types
GET /api/v1/dictionaries/eia-document-types
Returns EIA document types used in EIA document filtering.
SEA document types
GET /api/v1/dictionaries/sea-document-types
Returns SEA document types used in SEA document filtering.
Generic response shape
All type dictionaries on this page use the same response structure:
{
"results": {
"items": [
{
"id": 1,
"type_name": "...",
"domain_slug": "air",
"domain_label": "Повітря"
}
]
},
"stats": { "request_id": "...", "response_time_ms": 12 }
}
Generic fields
id: type identifier.type_name: type name.domain_slug: technical domain code, if applicable.domain_label: human-readable domain name, if applicable.
