Court cases with environmental attributes

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.

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": 11797,
        "year": 2024,
        "cause_num": "910/12345/24",
        "court": "Верховний Суд",
        "justice_kind": "Господарська справа",
        "documents_count": 8,
        "enterprise_links_count": 1,
        "eco_status": "relevant",
        "eco_score": 0.93,
        "first_document_adjudication_at": "2024-06-14",
        "last_document_adjudication_at": "2025-03-01",
        "representative_document": {
          "id": 42531,
          "doc_id": "134007731",
          "judgment_form": "Ухвала",
          "adjudication_at": "2025-03-01",
          "published_at": "2025-03-05"
        },
        "links": {
          "details": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-case-details/11797",
          "documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-documents?court_case_id=11797"
        }
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 2,
      "last_page": 1
    }
  },
  "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 court document list for this case.

Example request

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-case-details/11797" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "object": {
      "id": 11797,
      "year": 2024,
      "cause_num": "910/12345/24",
      "court": "Верховний Суд",
      "justice_kind": "Господарська справа",
      "documents_count": 8,
      "enterprise_links_count": 1,
      "eco_status": "relevant",
      "eco_score": 0.93,
      "first_document_adjudication_at": "2024-06-14",
      "last_document_adjudication_at": "2025-03-01",
      "representative_document": {
        "id": 42531,
        "doc_id": "134007731",
        "judgment_form": "Ухвала",
        "adjudication_at": "2025-03-01",
        "published_at": "2025-03-05"
      },
      "links": {
        "documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-documents?court_case_id=11797"
      }
    }
  },
  "stats": { "..." }
}

Response fields

results.object

The object fields are the same as in results.items[] in the court case list.

Filters

• court_case_id: filter 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?court_case_id=11797" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "items": [
      {
        "id": 42531,
        "doc_id": "134007731",
        "year": 2025,
        "cause_num": "910/12345/24",
        "court": "Верховний Суд",
        "judgment_form": "Ухвала",
        "justice_kind": "Господарська справа",
        "status": "published",
        "adjudication_at": "2025-03-01",
        "receipt_at": "2025-03-03",
        "published_at": "2025-03-05",
        "is_full_text": true,
        "eco_score": 0.93,
        "case": {
          "id": 11797,
          "cause_num": "910/12345/24",
          "year": 2024,
          "links": {
            "documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eco-court-documents?court_case_id=11797"
          }
        }
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 8,
      "last_page": 1
    }
  },
  "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, for example ruling or decision.
• 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.
• case: short information about the parent case.
• case.links.documents: link to the document list for the parent case.