Unless stated otherwise, this page refers to Ukrainian companies and individual entrepreneurs and uses identifiers from Ukrainian public registries.
This section describes requests used to work with accidents related to an enterprise.
Accident list
GET /api/v1/enterprises/{registry_id}/accidents/{domain}
This request returns enterprise accidents within a single domain.
The registry_id and domain parameters in the request path are required. registry_id is the enterprise identifier.
Available domain values can be retrieved from the Data domains request.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00131771/accidents/work" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": {
"type": "company",
"registry_id": "00131771"
},
"domain": {
"slug": "work",
"label": "Умови праці"
},
"items": [
{
"id": 1,
"registry_id": "21.022.2026",
"authority_name": "Державна служба України з питань праці",
"enterprise_name": "ПРИКЛАД ПІДПРИЄМСТВА",
"name": "Груповий нещасний випадок",
"address": "Україна, Дніпропетровська область",
"region": "Дніпропетровська область",
"accident_type": "Виробничий",
"activity_type": "Промисловість",
"event_type_code": "23.0.0",
"event_type_name": null,
"accident_year": 2024,
"accident_at": "2025-03-26T13:38:00+00:00",
"victims_total": 2,
"victims_fatal": 0,
"links": {
"details": "https://esg.saveecobot.com/api/v1/enterprises/00131771/accident-details/1"
}
}
]
},
"stats": { "..." }
}
Pagination parameters
page: page number.
Filters
year: accident year.
Response fields
results.items[]
id: record identifier.registry_id: accident registration number, if present.authority_name: authority or source responsible for publishing these data.enterprise_name: enterprise name as shown in the source.name: accident name or description.address: event address.region: event region.accident_type: accident type.activity_type: activity type associated with the accident.event_type_code: event type code.event_type_name: event type name.accident_year: event year.accident_at: event date.victims_total: total number of victims.victims_fatal: number of fatalities.links.details: link to accident details.
Accident details
GET /api/v1/enterprises/{registry_id}/accident-details/{accident_id}
This request returns full data for a specific accident. The response contains the same set of fields as the accident list.
The registry_id and accident_id parameters in the request path are required. registry_id is the enterprise identifier. accident_id is the record identifier.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00131771/accident-details/1" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00131771" },
"object": {
"id": 1,
"registry_id": "21.022.2026",
"authority_name": "Державна служба України з питань праці",
"enterprise_name": "ПРИКЛАД ПІДПРИЄМСТВА",
"name": "Груповий нещасний випадок",
"address": "Україна, Дніпропетровська область",
"region": "Дніпропетровська область",
"accident_type": "Виробничий",
"activity_type": "Промисловість",
"event_type_code": "23.0.0",
"event_type_name": null,
"accident_year": 2024,
"accident_at": "2025-03-26T13:38:00+00:00",
"victims_total": 2,
"victims_fatal": 0
}
},
"stats": { "..." }
}
Response fields
results.object
The object fields are the same as in results.items[] in the accident list.
