Unless stated otherwise, this page refers to Ukrainian companies and individual entrepreneurs and uses identifiers from Ukrainian public registries.
This request returns the list of related persons found in permits, registries, reports, and other enterprise documents and records, together with their best role and data sources.
GET /api/v1/enterprises/{registry_id}/related-persons
The response returns a short enterprise block, the list of related persons, and pagination.
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/related-persons" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"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": { "..." }
}
Pagination parameters
page: page number.
Response fields
results.items[]
entity_public_id: public identifier of the related person.name: prepared full name for display.best_role: best or primary role of this related person with respect to the enterprise.first_actual_at: date when the relationship first became actual.last_actual_at: date of the latest known actuality of the relationship.sources[]: sources where this relationship was recorded.sources[].label: source name.sources[].count: number of confirmations from this source.
