Українські компанії перебувають в ЄДР, який веде Міністерство юстиції, а ключ юридичної особи — код ЄДРПОУ з 8 цифр. Нижче можна спробувати пошук, побачити той самий запит як виклик API й дізнатися, що містить запис і чого в ньому немає.
Код ЄДРПОУ (8 цифр) або назва компанії
curl "https://api.prometiam.com/functions/v1/risk-api/companies/search?company_number=21673832&country=UA" \ -H "Authorization: Bearer YOUR_API_KEY"
Під «ЄДР API» тут мається на увазі один REST-запит, що повертає запис української компанії у форматі JSON. Ви надсилаєте код ЄДРПОУ або назву, а у відповіді — назва, організаційно-правова форма, статус, дата реєстрації, статутний капітал у гривнях і код ЄДРПОУ. Об’єкт компанії такий самий, як для інших країн, тож в інтеграції для України достатньо змінити параметр country.
API — послуга Prometiam, а не самого реєстру. Воно не замінює офіційного витягу з ЄДР, який видає реєстр (Міністерство юстиції України), і потрібне там, де перевірка має відбуватися автоматично: під час онбордингу клієнтів, перед оплатою постачальнику, у CRM чи ERP. Що саме публікує Міністерство і чого немає у відкритих даних з початку воєнного стану, пояснює окремий посібник: ЄДР: відкриті дані й API.
Код ЄДРПОУ юридичної особи складається з 8 цифр, початкові нулі зберігаються, наприклад 21673832 (ПрАТ «Київстар»). Коротший номер читається з відновленими початковими нулями, а префікс UA необов’язковий. Остання цифра контрольна, але перевірка лише орієнтовна: кілька справжніх кодів її не проходять, тому код із неправильною контрольною цифрою все одно шукається, а інструмент лише попереджає.
Десятицифровий номер — це податковий номер фізичної особи, а не код компанії, і API його відхиляє. Якщо код формально правильний, але запису немає, причин може бути кілька: компанії немає у відкритих даних, вона належить до тих, яких ми не надаємо (ФОП, асоціації, громадські об’єднання, філії), або код введено з помилкою.
Пошук за кодом — один запит. Якщо відома лише назва, використовуйте name=: назву можна писати кирилицею або латиницею, латинський запис знаходиться через транслітерацію. Відповідь лежить під ключем data:
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=UA&company_number=21673832' \ -H 'Authorization: Bearer rk_live_...'
Скорочений приклад відповіді (справжня містить більше полів):
{
"data": [{
"id": 60000021673832,
"country": "UA",
"company_number": "21673832",
"company_name": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО \"КИЇВСТАР\"",
"short_name": "ПРАТ \"КИЇВСТАР\"",
"legal_form": "ПрАТ",
"local_legal_form_name": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО",
"status": "active",
"local_status": "active",
"founding_date": "1997-09-03",
"capital_amount": 654763100,
"capital_currency": "UAH"
}],
"meta": { "country": "UA", "data_as_of": "2026-10-27" }
}
Назва зберігається українською, як у реєстрі. У founding_date стоїть дата першої державної реєстрації: окремої дати заснування реєстр не публікує. meta.data_as_of показує, на яку дату відповідь актуальна.
Пошук за кодом або назвою коштує 1 кредит, відповідь із помилкою — нічого. Кілька кодів за один виклик можна перевірити через POST /companies/lookup: кожен код рахується як один запит.
| Поле | Що містить для України |
|---|---|
company_name, short_name | Назва юридичної особи українською, як у реєстрі |
company_number | Код ЄДРПОУ (8 цифр) |
legal_form, local_legal_form_name | Організаційно-правова форма: ТОВ, ПрАТ, АТ, ДП та інші |
status, local_status | Статус, зокрема стан припинення й банкрутство |
founding_date, registration_date | Дата першої державної реєстрації (одна й та сама дата) |
dissolution_date | Дата припинення, якщо реєстр її наводить |
capital_amount, capital_currency | Статутний капітал у гривнях (UAH), якщо реєстр його наводить |
statusРеєстр записує стан юридичної особи словами. API повертає його як стандартний status, однаковий для всіх країн. Запис, який реєстр показує як «зареєстровано, свідоцтво про державну реєстрацію недійсне», віддається зі status active і local_status certificate_void.
| У реєстрі | status |
|---|---|
| зареєстровано | active |
| зареєстровано, свідоцтво про державну реєстрацію недійсне | active (local_status certificate_void) |
| в стані припинення | in_liquidation |
| порушено справу про банкрутство | insolvent |
| порушено справу про банкрутство (санація) | in_restructuring |
| припинено, скасовано | deregistered |
| припинено в результаті реорганізації (злиття, приєднання, поділу, перетворення) | merged |
Для України є події змін у реєстрі: назва, статус, організаційно-правова форма й статутний капітал, через GET /company-events/search?country=UA&company_number=21673832 (2 кредити). Адреси в подіях немає, бо реєстр її не публікує. Подію датовано днем, коли зміну вперше побачено в даних реєстру (дані читаються щотижня), а подій раніше за запуск України в жовтні 2026 року немає.
POST /monitor надсилає вебхук про зміну статусу, припинення, збіг із санкційними списками (бета) та ці події. Моніторинг не витрачає кредитів; кількість компаній під наглядом залежить від тарифу (3 у пробному періоді, 25 у Starter, 250 у Professional, 2 500 у Scale).
Contains data from the Unified State Register of Legal Entities, Individual Entrepreneurs and Public Organisations (EDR), Ministry of Justice of Ukraine, published as open data on data.gov.ua under the Creative Commons Attribution licence (CC BY 4.0). Adapted by Prometiam.
Тарифи публічні, розмова з відділом продажів не потрібна. Starter коштує 9,99 € на місяць (1 000 кредитів), Professional — 29,99 € (10 000 кредитів), Scale — 99,99 € (50 000 кредитів), Enterprise — за домовленістю. Пошук компанії або її запис коштує 1 кредит, перевірка за санкційними списками (бета) — 3 кредити; відповіді з помилками безкоштовні. Пробний період триває 14 днів і містить 500 кредитів: потрібна банківська картка, під час пробного періоду кошти не списуються, далі діє Starter, якщо ви не скасуєте підписку. Докладніше: ціни.
Розпочати безкоштовний 14-денний пробний період · Документація API
Пробний період триває 14 днів і містить 500 кредитів. Потрібна банківська картка, під час пробного періоду кошти не списуються; далі діє тариф Starter (9,99 € на місяць), якщо ви не скасуєте підписку.