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 court cases that have environmental attributes and with court documents related to an enterprise.
Court cases with environmental attributes are identified automatically by SaveEcoBot methodology. The presence of a case or document in this section does not itself mean that the enterprise has violated the law or has been found guilty.
List of court cases with environmental attributes
GET /api/v1/enterprises/{registry_id}/eco-court-cases
This request returns court cases related to the enterprise. Together with the list, the response includes core case data, document counts, and a link to the dedicated endpoint for documents of that case.
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/eco-court-cases" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"items": [
{
"id": 11177,
"year": 2025,
"cause_num": "160/33103/24",
"court": "Дніпропетровський окружний адміністративний суд",
"justice_kind": "Адміністративна справа",
"documents_count": 6,
"enterprise_links_count": 4,
"eco_status": "confirmed",
"eco_score": 6,
"first_document_adjudication_at": "2025-01-13",
"last_document_adjudication_at": "2025-06-23",
"representative_document": {
"id": 29780,
"doc_id": "124432600",
"judgment_form": "Судове рішення",
"adjudication_at": "2025-01-13",
"published_at": "2025-01-17",
"links": {
"registry": "https://reyestr.court.gov.ua/Review/124432600"
}
},
"links": {
"details": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-case-details/11177",
"documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-cases/11177/documents"
}
}
]
},
"stats": { "..." }
}
Pagination parameters
page: page number.
Filters
year: court case year.
Response fields
results.items[]
id: court case identifier.year: court case year.cause_num: case number.court: court name.justice_kind: justice kind label.documents_count: number of related court documents.enterprise_links_count: number of enterprise links on the case.eco_status: internal environmental relevance status.eco_score: internal environmental relevance score.first_document_adjudication_at: earliest document adjudication date in the case.last_document_adjudication_at: latest document adjudication date in the case.representative_document: short information about one representative court document, if available.links.details: link to case details.links.documents: link to the dedicated document endpoint for that case.representative_document.links.registry: link to the document page in the Unified State Register of Court Decisions.
Court case details
GET /api/v1/enterprises/{registry_id}/eco-court-case-details/{court_case_id}
This request returns full data for a specific court case.
The registry_id and court_case_id parameters in the request path are required. registry_id is the enterprise identifier. court_case_id is the court case identifier.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-case-details/11177" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"object": {
"id": 11177,
"year": 2025,
"cause_num": "160/33103/24",
"court": "Дніпропетровський окружний адміністративний суд",
"justice_kind": "Адміністративна справа",
"documents_count": 6,
"enterprise_links_count": 4,
"eco_status": "confirmed",
"eco_score": 6,
"first_document_adjudication_at": "2025-01-13",
"last_document_adjudication_at": "2025-06-23",
"representative_document": {
"id": 29780,
"doc_id": "124432600",
"judgment_form": "Судове рішення",
"adjudication_at": "2025-01-13",
"published_at": "2025-01-17",
"links": {
"registry": "https://reyestr.court.gov.ua/Review/124432600"
}
},
"links": {
"documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-cases/11177/documents"
}
}
},
"stats": { "..." }
}
Response fields
results.object
The object fields are the same as in results.items[] in the court case list.
Documents of one court case with environmental attributes
GET /api/v1/enterprises/{registry_id}/eco-court-cases/{court_case_id}/documents
This request returns all documents of one court case with environmental attributes. The response also includes an object block with short information about the case itself.
The registry_id and court_case_id parameters in the request path are required. registry_id is the enterprise identifier. court_case_id is the court case identifier.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-cases/11177/documents" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"object": {
"id": 11177,
"cause_num": "160/33103/24",
"year": 2025,
"court": "Дніпропетровський окружний адміністративний суд",
"justice_kind": "Адміністративна справа"
},
"items": [
{
"id": 29785,
"doc_id": "129703236",
"year": 2025,
"cause_num": "160/33103/24",
"court": "Дніпропетровський окружний адміністративний суд",
"judgment_form": "Судове рішення",
"justice_kind": "Адміністративна справа",
"status": 1,
"adjudication_at": "2025-06-23",
"receipt_at": "2025-08-23",
"published_at": "2025-08-25",
"is_full_text": true,
"eco_score": 0,
"links": {
"registry": "https://reyestr.court.gov.ua/Review/129703236"
}
}
]
},
"stats": { "..." }
}
Response fields
results.object
id: court case identifier.cause_num: case number.year: court case year.court: court name.justice_kind: justice kind label.
results.items[]
The item fields are the same as in the enterprise court document list, but without the nested case block.
Court documents with environmental attributes of the enterprise
GET /api/v1/enterprises/{registry_id}/eco-court-documents
This request returns court documents related to the enterprise. Together with the list, the response includes a short case block that points to the parent court case.
The registry_id parameter in the request path is required. It is the enterprise identifier.
Filters
court_case_id: optionally limit documents to a single court case.year: filter documents by year.
Example request
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-documents" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"items": [
{
"id": 29785,
"doc_id": "129703236",
"year": 2025,
"cause_num": "160/33103/24",
"court": "Дніпропетровський окружний адміністративний суд",
"judgment_form": "Судове рішення",
"justice_kind": "Адміністративна справа",
"status": 1,
"adjudication_at": "2025-06-23",
"receipt_at": "2025-08-23",
"published_at": "2025-08-25",
"is_full_text": true,
"eco_score": 0,
"links": {
"registry": "https://reyestr.court.gov.ua/Review/129703236"
},
"case": {
"id": 11177,
"cause_num": "160/33103/24",
"year": 2025,
"links": {
"documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-cases/11177/documents"
}
}
}
]
},
"stats": { "..." }
}
Pagination parameters
page: page number.
Response fields
results.items[]
id: court document identifier.doc_id: identifier of the document in the court registry.year: document year.cause_num: case number.court: court name.judgment_form: document form.justice_kind: justice kind label.status: document status.adjudication_at: document adjudication date.receipt_at: date when the registry received the document.published_at: date when the document was published.is_full_text: whether full document text is available.eco_score: internal environmental relevance score.links.registry: link to the document page in the Unified State Register of Court Decisions.case: short information about the parent case.case.id: parent case identifier.case.cause_num: parent case number.case.year: parent case year.case.links.documents: link to the dedicated document endpoint for the parent case.
