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 SEA cases and SEA documents related to an enterprise.
SEA case list
GET /api/v1/enterprises/{registry_id}/sea-cases
This request returns SEA cases related to the enterprise.
The registry_id parameter in the request path is required. It is the enterprise identifier.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-cases" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"items": [
{
"id": 150,
"registry_id": "SEA-001",
"name": "SEA case",
"published_at": "2025-01-10",
"region": "Київська область",
"is_countrywide": false,
"documents_count": 4,
"links": {
"details": "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-case-details/150",
"documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-cases/150/documents"
}
}
],
"pagination": { "current_page": 1, "per_page": 20, "total": 1, "last_page": 1 }
},
"stats": { "..." }
}
Pagination parameters
page: page number.
Response fields
results.items[]: short case objects with links to details and documents.
SEA case details
GET /api/v1/enterprises/{registry_id}/sea-case-details/{case_id}
This request returns full data for a specific SEA case.
The registry_id and case_id parameters in the request path are required. registry_id is the enterprise identifier. case_id is the SEA case identifier.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-case-details/150" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"object": {
"id": 150,
"registry_id": "SEA-001",
"name": "SEA case",
"published_at": "2025-01-10",
"region": "Київська область",
"is_countrywide": false,
"documents_count": 4,
"links": {
"documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-cases/150/documents"
}
}
},
"stats": { "..." }
}
Enterprise SEA documents
GET /api/v1/enterprises/{registry_id}/sea-documents
This request returns SEA documents related to the enterprise.
Filters
document_type_id: SEA document type identifier.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-documents" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"items": [
{
"id": 601,
"type_name": "Заява про визначення обсягу СЕО",
"name": "SEA document",
"format": "pdf",
"size": 178440,
"uploaded_at": "2025-01-12T10:15:00+02:00",
"downloaded_at": "2025-01-12T10:15:00+02:00",
"case": {
"id": 150,
"registry_id": "SEA-001",
"name": "SEA case",
"region": "Київська область",
"published_at": "2025-01-10"
},
"links": {
"download": "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-documents/601/download"
}
}
],
"pagination": { "current_page": 1, "per_page": 20, "total": 4, "last_page": 1 },
"filters": { "document_type_id": 1 }
},
"stats": { "..." }
}
Documents of an SEA case
GET /api/v1/enterprises/{registry_id}/sea-cases/{case_id}/documents
This request returns SEA documents for a specific SEA case.
The registry_id and case_id parameters in the request path are required. registry_id is the enterprise identifier. case_id is the SEA case identifier.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-cases/150/documents" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"object": { "id": 150, "registry_id": "SEA-001", "name": "SEA case" },
"items": [],
"filters": { "document_type_id": null }
},
"stats": { "..." }
}
SEA document download
GET /api/v1/enterprises/{registry_id}/sea-documents/{document_id}/download
This request returns the SEA document file for download.
The registry_id and document_id parameters in the request path are required. registry_id is the enterprise identifier. document_id is the SEA document identifier.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl -L "https://esg.saveecobot.com/api/v1/enterprises/00178353/sea-documents/601/download" \
-H "Authorization: Bearer $ESG_API_TOKEN"
