Enterprise certificates

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 enterprise certificates, attestations, and statements, their validity periods, statuses, and related files. For brevity, the term certificates is used throughout this page.

Example request

$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/certificates/forest?certificate_type_id=1" \
  -H "Authorization: Bearer $ESG_API_TOKEN" \
  -H 'Accept: application/json'

Example response

{
  "results": {
    "enterprise": {
      "type": "company",
      "registry_id": "00178353"
    },
    "domain": {
      "slug": "forest",
      "label": "Ліси"
    },
    "items": [
      {
        "id": 1,
        "type_id": 1,
        "type_name": "Сертифікат про походження лісоматеріалів",
        "registry_id": "CERT-001",
        "authority_name": "Держлісагентство",
        "name": "Сертифікат про походження лісоматеріалів",
        "description_lines": [
          "Виданий для партії лісоматеріалів"
        ],
        "status": "Видано",
        "issued_at": "2025-01-10",
        "valid_from": "2025-01-10",
        "valid_to": "2025-12-31",
        "is_active": true,
        "files_count": 2,
        "links": {
          "details": "https://esg.saveecobot.com/api/v1/enterprises/00178353/certificate-details/1",
          "files": "https://esg.saveecobot.com/api/v1/enterprises/00178353/certificate-files/1"
        }
      }
    ]
  },
  "stats": { "..." }
}

Pagination parameters

• page: page number.

Filters

• year: certificate year.
• certificate_type_id: certificate type identifier. Available values can be retrieved from the Certificate types request.

Response fields

results.items[]

• id: certificate identifier.
• type_id: certificate type identifier.
• type_name: certificate type name.
• registry_id: certificate number or registration number.
• authority_name: certificate authority or source.
• name: certificate name.
• description_lines[]: short certificate description split into lines.
• status: certificate status.
• issued_at: issue date.
• valid_from: validity start date.
• valid_to: validity end date.
• is_active: indicates whether the certificate is active.
• files_count: number of related files.
• links.details: link to certificate details.
• links.files: link to the separate file list.

Example request

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

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "object": {
      "id": 1,
      "type_id": 1,
      "type_name": "Сертифікат про походження лісоматеріалів",
      "registry_id": "CERT-001",
      "authority_name": "Держлісагентство",
      "name": "Сертифікат про походження лісоматеріалів",
      "description_lines": ["Виданий для партії лісоматеріалів"],
      "status": "Видано",
      "issued_at": "2025-01-10",
      "valid_from": "2025-01-10",
      "valid_to": "2025-12-31",
      "is_active": true,
      "files_count": 2,
      "links": {
        "files": "https://esg.saveecobot.com/api/v1/enterprises/00178353/certificate-files/1"
      }
    }
  },
  "stats": { "..." }
}

Response fields

results.object

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

results.object.links

• files: link to the separate certificate files list, if files exist.

Example request

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

Example response

{
  "results": {
    "enterprise": { "type": "company", "registry_id": "00178353" },
    "object": {
      "type": "certificate",
      "id": 1,
      "registry_id": "CERT-001",
      "type_id": 1,
      "type_name": "Сертифікат про походження лісоматеріалів",
      "name": "Сертифікат про походження лісоматеріалів"
    },
    "items": [
      {
        "id": 1,
        "type_id": 1,
        "type_name": "Скан-копія сертифіката",
        "name": "certificate.pdf",
        "description": "Сертифікат про походження лісоматеріалів",
        "format": "application/pdf",
        "size": 65021,
        "uploaded_at": "2025-01-10T12:00:00+02:00",
        "downloaded_at": "2025-01-11T09:00:00+02:00",
        "links": {
          "download": "https://esg.saveecobot.com/api/v1/enterprises/00178353/certificate-files/1/download/1"
        }
      }
    ]
  },
  "stats": { "..." }
}

Response fields

results.object

• type: object type. For this request, the value is certificate.
• id: certificate identifier.
• registry_id: certificate number or registration number.
• type_id: certificate type identifier.
• type_name: certificate type name.
• name: certificate name.

results.items[]

• id: certificate file identifier.
• type_id: file type identifier.
• type_name: file type name.
• name: file name.
• description: short file description.
• format: file format.
• size: file size in bytes.
• uploaded_at: date when the file was uploaded or published in the source.
• downloaded_at: date when the file was downloaded into ESG SaveEcoBot.
• links.download: file download link.

Example request

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