Адреси підприємства

Цей запит повертає перелік відомих адрес підприємства разом із регіоном, адміністративними класифікаторами та джерелами, з яких ці адреси були отримані.

GET /api/v1/enterprises/{registry_id}/addresses

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

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

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

$ 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'

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

{
  "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": { "..." }
}

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

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

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

`results.items[]`

address_name: коротка назва адреси або її тип, якщо він є.
address_text: повний текст адреси.
region: назва області або іншого великого регіону.
katottg: інформація про КАТОТТГ, якщо вона визначена для адреси.
katottg.code: код КАТОТТГ.
katottg.name: назва КАТОТТГ.
koatuu: інформація про КОАТУУ, якщо вона визначена для адреси.
koatuu.code: код КОАТУУ.
koatuu.name: назва КОАТУУ.
first_actual_at: дата, з якої адреса вперше вважається актуальною.
last_actual_at: дата останньої актуальності адреси.
sources[]: джерела, в яких зустрічається адреса.
sources[].label: назва джерела.
sources[].count: скільки разів адреса підтверджена цим джерелом.
coordinates: координати адреси, якщо доступ до них дозволений для ключа.
coordinates.latitude: широта.
coordinates.longitude: довгота.

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

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

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

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

results.items[]

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

`results.items[]`