У цьому розділі описані запити для роботи зі скаргами, пов'язаними з підприємством, разом із типом, статусом і джерелом даних.
Перелік скарг
GET /api/v1/enterprises/{registry_id}/complaints/{domain}
Цей запит повертає скарги підприємства в межах одного домену.
Параметри registry_id і domain в адресі запиту є обов'язковими. registry_id — це ідентифікатор підприємства.
Доступні значення domain можна отримати в запиті Домени даних.
Приклад запиту
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/complaints/environmental?complaint_type_id=1" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Приклад відповіді
Параметри пагінації
page: номер сторінки.
Фільтри
year: рік скарги.complaint_type_id: ідентифікатор типу скарги. Доступні значення можна отримати в запиті Типи скарг.
Поля відповіді
results.items[]
id: ідентифікатор скарги.type_id: ідентифікатор типу скарги.type_name: назва типу скарги.registry_id: номер або зовнішній ідентифікатор скарги.authority_name: орган, до якого надійшла скарга.name: предмет скарги.description_lines[]: короткий опис скарги окремими рядками.region: регіон, якого стосується скарга.complaint_date: дата скарги.status: статус скарги.source: джерело походження скарги.links.details: посилання на деталі скарги.
Деталі скарги
GET /api/v1/enterprises/{registry_id}/complaint-details/{complaint_id}
Цей запит повертає повні дані конкретної скарги. У відповіді ви отримаєте той самий набір полів, що й у переліку скарг.
Параметри registry_id і complaint_id в адресі запиту є обов'язковими. registry_id — це ідентифікатор підприємства. complaint_id — це ідентифікатор скарги.
Приклад запиту
$ ESG_API_TOKEN="your_api_token"
$ curl "https://esg.saveecobot.com/api/v1/enterprises/00178353/complaint-details/12" \
-H "Authorization: Bearer $ESG_API_TOKEN" \
-H 'Accept: application/json'
Приклад відповіді
{
"results": {
"enterprise": { "type": "company", "registry_id": "00178353" },
"object": {
"id": 12,
"type_id": 1,
"type_name": "Скарга про порушення екологічного законодавства або про екологічний злочин",
"registry_id": null,
"authority_name": "Міндовкілля",
"name": "Скарга щодо забруднення повітря",
"description_lines": ["Звернення щодо можливих викидів"],
"region": "Київська область",
"complaint_date": "2025-05-10",
"status": "Розглянуто",
"source": "УКЦ"
}
},
"stats": { "..." }
}
Поля відповіді
results.object
Поля об'єкта ті самі, що й у results.items[] в переліку скарг.
