Контакти підприємства

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

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

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

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

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

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

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

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

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

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

Фільтри

type: тип контакту, наприклад phone, email або website.

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

`results.items[]`

type: тип контакту.
value: значення контакту, наприклад номер телефону, email або URL.
first_actual_at: дата першої актуальності цього контакту.
last_actual_at: дата останньої актуальності контакту.
sources[]: джерела, у яких знайдено цей контакт.
sources[].label: назва джерела.
sources[].count: кількість згадок або підтверджень із цього джерела.