All sections

Environmental Impact Assessment (EIA)

On this page

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 EIA cases, EIA documents, and EIA public hearings related to an enterprise.

EIA case list

GET /api/v1/enterprises/{registry_id}/eia-cases

This request returns EIA 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/eia-cases" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "items": [
      {
        "id": 9132,
        "registry_id": "20221012345",
        "old_registry_id": "20221012345",
        "registry_type": "Екосистема",
        "authority_name": "Ministry of Environmental Protection and Natural Resources of Ukraine",
        "name": "Planned activity case",
        "address": "Kyiv region, Boryspil district",
        "description": "Construction of an industrial site",
        "region": "Київська область",
        "published_at": "2024-10-05",
        "documents_count": 6,
        "hearings_count": 1,
        "links": {
          "details": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-case-details/9132",
          "documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/documents",
          "hearings": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/hearings"
        }
      }
    ],
    "pagination": { "current_page": 1, "per_page": 20, "total": 1, "last_page": 1 }
  },
  "stats": { "..." }
}

Pagination parameters

  • page: page number.

Response fields

  • results.items[]: short EIA case objects with links to details, documents, and hearings.

EIA case details

GET /api/v1/enterprises/{registry_id}/eia-case-details/{case_id}

This request returns full data for a specific EIA case.

The registry_id and case_id parameters in the request path are required. registry_id is the enterprise identifier. case_id is the EIA case identifier.

Example request

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

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "object": {
      "id": 9132,
      "registry_id": "20221012345",
      "old_registry_id": "20221012345",
      "registry_type": "Екосистема",
      "authority_name": "Ministry of Environmental Protection and Natural Resources of Ukraine",
      "name": "Planned activity case",
      "address": "Kyiv region, Boryspil district",
      "description": "Construction of an industrial site",
      "region": "Київська область",
      "published_at": "2024-10-05",
      "documents_count": 6,
      "hearings_count": 1,
      "links": {
        "documents": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/documents",
        "hearings": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/hearings"
      }
    }
  },
  "stats": { "..." }
}

Enterprise EIA documents

GET /api/v1/enterprises/{registry_id}/eia-documents

This request returns EIA documents related to the enterprise.

Filters

  • document_type_id: EIA document type identifier.

Example request

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "items": [
      {
        "id": 501,
        "registry_id": "20221012345-1",
        "type_id": 1,
        "type_name": "Повідомлення про плановану діяльність",
        "name": "EIA document",
        "format": "pdf",
        "size": 245133,
        "uploaded_at": "2024-10-05T11:24:18+03:00",
        "downloaded_at": "2024-10-05T11:24:18+03:00",
        "case": {
          "id": 9132,
          "registry_id": "20221012345",
          "old_registry_id": "20221012345",
          "registry_type": "Старий реєстр",
          "authority_name": "Ministry of Environmental Protection and Natural Resources of Ukraine",
          "name": "Planned activity case",
          "address": "Kyiv region, Boryspil district",
          "region": "Київська область",
          "published_at": "2024-10-05"
        },
        "links": {
          "download": "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents/501/download"
        }
      }
    ],
    "pagination": { "current_page": 1, "per_page": 20, "total": 6, "last_page": 1 },
    "filters": { "document_type_id": 1 }
  },
  "stats": { "..." }
}

Response fields

  • results.items[].case.old_registry_id: case identifier from the legacy EIA registry, when available.
  • results.items[].case.registry_type: source registry type for the case, either Екосистема or Старий реєстр.

EIA document download

GET /api/v1/enterprises/{registry_id}/eia-documents/{document_id}/download

This request returns the EIA 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 EIA document identifier.

Example request

$ ESG_API_TOKEN="your_api_token"
$ curl -L "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-documents/501/download" \
  -H "Authorization: Bearer $ESG_API_TOKEN"

Enterprise EIA hearings

GET /api/v1/enterprises/{registry_id}/eia-hearings

This request returns public hearings related to EIA cases of the enterprise.

Example request

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/24584661/eia-hearings" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "24584661" },
    "items": [
      {
        "id": 1414,
        "datetime": "2024-12-27T16:00:00+00:00",
        "url": "https://mepr.webex.com/mepr-ru/j.php?MTID=m347a70d922c095c69f36467802c02558 Номер наради: 2365 701 6692 Пароль: spM598DDXx5",
        "address": null,
        "comments": null,
        "object": {
          "id": 9035,
          "registry_id": "5333",
          "old_registry_id": null,
          "registry_type": "Екосистема",
          "authority_name": "Ministry of Environmental Protection and Natural Resources of Ukraine",
          "name": "Будівництво енергоблоків № 5, 6 з реакторною установкою АР1000 на майданчику Хмельницької АЕС",
          "address": null,
          "region": "Хмельницька область",
          "published_at": "2024-03-29"
        }
      }
    ],
    "pagination": { "current_page": 1, "per_page": 20, "total": 3, "last_page": 1 }
  },
  "stats": { "..." }
}

Response fields

  • results.items[].object.old_registry_id: case identifier from the legacy EIA registry, when available.
  • results.items[].object.registry_type: source registry type for the case, either Екосистема or Старий реєстр.

Documents of an EIA case

GET /api/v1/enterprises/{registry_id}/eia-cases/{case_id}/documents

This request returns EIA documents for a specific EIA case.

The registry_id and case_id parameters in the request path are required. registry_id is the enterprise identifier. case_id is the EIA case identifier.

Example request

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/eia-cases/9132/documents" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "object": {
      "id": 9132,
      "registry_id": "20221012345",
      "old_registry_id": "20221012345",
      "registry_type": "Старий реєстр",
      "authority_name": "Ministry of Environmental Protection and Natural Resources of Ukraine",
      "name": "Planned activity case",
      "address": "Kyiv region, Boryspil district",
      "region": "Київська область",
      "published_at": "2024-10-05"
    },
    "items": [],
    "filters": { "document_type_id": null }
  },
  "stats": { "..." }
}

Response fields

  • results.object.old_registry_id: case identifier from the legacy EIA registry, when available.
  • results.object.registry_type: source registry type for the case, either Екосистема or Старий реєстр.

Hearings of an EIA case

GET /api/v1/enterprises/{registry_id}/eia-cases/{case_id}/hearings

This request returns public hearings for a specific EIA case.

The registry_id and case_id parameters in the request path are required. registry_id is the enterprise identifier. case_id is the EIA case identifier.

Example request

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/24584661/eia-cases/9035/hearings" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "24584661" },
    "object": {
      "id": 9035,
      "registry_id": "5333",
      "old_registry_id": null,
      "registry_type": "Екосистема",
      "authority_name": "Ministry of Environmental Protection and Natural Resources of Ukraine",
      "name": "Будівництво енергоблоків № 5, 6 з реакторною установкою АР1000 на майданчику Хмельницької АЕС",
      "address": null,
      "region": "Хмельницька область",
      "published_at": "2024-03-29"
    },
    "items": [
      {
        "id": 1414,
        "datetime": "2024-12-27T16:00:00+00:00",
        "url": "https://mepr.webex.com/mepr-ru/j.php?MTID=m347a70d922c095c69f36467802c02558 Номер наради: 2365 701 6692 Пароль: spM598DDXx5",
        "address": null,
        "comments": null
      }
    ]
  },
  "stats": { "..." }
}

Response fields

  • results.object.old_registry_id: case identifier from the legacy EIA registry, when available.
  • results.object.registry_type: source registry type for the case, either Екосистема or Старий реєстр.

Participate in testing the ESG company profile
in the SaveEcoBot system in Ukraine

Make your ESG analysis flawless!
Get Demo Access