Unless stated otherwise, this page refers to Ukrainian companies and individual entrepreneurs and uses identifiers from Ukrainian public registries.
This request returns phone numbers, email addresses, websites, and other enterprise contact data together with the sources where they were found.
GET /api/v1/enterprises/{registry_id}/contacts
The response returns a short enterprise block, the contact list, 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/contacts?type=email" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": {
"type": "company",
"registry_id": "00178353"
},
"items": [
{
"type": "email",
"value": "[email protected]",
"first_actual_at": "2024-01-01",
"last_actual_at": "2026-05-01",
"sources": [
{
"label": "ЄДР",
"count": 1
}
]
}
],
"pagination": {
"current_page": 1,
"per_page": 20,
"total": 3,
"last_page": 1
}
},
"stats": { "..." }
}
Pagination parameters
page: page number.
Filters
type: contact type, for examplephone,email, orwebsite.
Response fields
results.items[]
type: contact type.value: contact value, for example a phone number, email address, or URL.first_actual_at: date when this contact first became actual.last_actual_at: date of the latest known actuality of the contact.sources[]: sources where this contact was found.sources[].label: source name.sources[].count: number of mentions or confirmations from this source.
