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 known enterprise addresses together with the region, administrative classifiers, and sources from which these addresses were obtained.
GET /api/v1/enterprises/{registry_id}/addresses
The response returns a short enterprise block, the address 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/addresses" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Example response
{
"results": {
"enterprise": {
"type": "company",
"registry_id": "00178353"
},
"items": [
{
"address_name": "Юридична адреса",
"address_text": "Україна, Київська область, місто Київ",
"region": "Київська область",
"katottg": {
"code": "UA80000000000093317",
"name": "місто Київ"
},
"koatuu": null,
"first_actual_at": "2024-01-01",
"last_actual_at": "2026-05-01",
"sources": [
{
"label": "ЄДР",
"count": 1
}
],
"coordinates": {
"latitude": 50.4501,
"longitude": 30.5234
}
}
],
"pagination": {
"current_page": 1,
"per_page": 20,
"total": 2,
"last_page": 1
}
},
"stats": { "..." }
}
Pagination parameters
page: page number.
Response fields
results.items[]
address_name: short address name or address type, if available.address_text: full address text.region: name of the region or another large administrative area.katottg: KATOTTG information, if determined for the address.katottg.code: KATOTTG code.katottg.name: KATOTTG name.koatuu: KOATUU information, if determined for the address.koatuu.code: KOATUU code.koatuu.name: KOATUU name.first_actual_at: date from which the address is first considered actual.last_actual_at: last known actual date of the address.sources[]: sources where the address appears.sources[].label: source name.sources[].count: how many times the address is confirmed by this source.coordinates: address coordinates, if they are allowed for the API key.coordinates.latitude: latitude.coordinates.longitude: longitude.
