Пов’язані персони підприємства

Цей запит повертає перелік пов'язаних персон, яких знайдено в дозволах, реєстрах, звітах та інших документах і записах підприємства, а також їхню найкращу роль і джерела даних.

GET /api/v1/enterprises/{registry_id}/related-persons

У відповіді ви отримаєте короткий блок про підприємство, перелік пов’язаних персон і пагінацію.

Параметр registry_id в адресі запиту є обов'язковим — це ідентифікатор підприємства.

Приклад запиту

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

Приклад відповіді

{
  "results": {
    "enterprise": {
      "type": "company",
      "registry_id": "00178353"
    },
    "items": [
      {
        "entity_public_id": "97cbaf13-8fc7-4608-a480-fea3ef813dab",
        "name": "Петренко Іван Анатолійович",
        "best_role": "Бенефіціар",
        "first_actual_at": "2024-01-01",
        "last_actual_at": "2026-05-01",
        "sources": [
          {
            "label": "ЄДР: бенефіціари",
            "count": 1
          }
        ]
      },
      {
        "entity_public_id": "855a8db6-24a6-4f2c-a64b-ef216e04a3c1",
        "name": "Дудник Олександр Петрович",
        "best_role": "Керівник",
        "first_actual_at": "2025-10-02",
        "last_actual_at": "2025-10-02",
        "sources": [
          {
            "label": "ЄДР підрозділів: підписанти",
            "count": 1
          },
          {
            "label": "Звіт 2-ТП водгосп (ДАВР): контактні відомості",
            "count": 2
          },
          {
            "label": "Декларація про відходи",
            "count": 24
          }
        ]
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 4,
      "last_page": 1
    }
  },
  "stats": { "..." }
}

Параметри пагінації

page: номер сторінки.

Поля відповіді

`results.items[]`

entity_public_id: публічний ідентифікатор пов'язаної персони.
name: підготовлене ПІБ для відображення.
best_role: найкраща або основна роль цієї пов'язаної персони щодо підприємства.
first_actual_at: дата першої актуальності зв'язку.
last_actual_at: дата останньої актуальності зв'язку.
sources[]: джерела, у яких зафіксовано цей зв'язок.
sources[].label: назва джерела.
sources[].count: кількість підтверджень із цього джерела.

Приклад запиту

Приклад відповіді

Параметри пагінації

Поля відповіді

results.items[]

Візьміть участь в тестуванні ESG профілю підприємства у системі SaveEcoBot

`results.items[]`