Від коду ЄДРПОУ до перевіреного запису компанії за секунди: назва, організаційно-правова форма, статус, дати реєстрації й припинення та статутний капітал із ЄДР. Без ручного пошуку, з результатом, який можна зберегти в досьє клієнта.
Перед угодою треба переконатися, що юридична особа існує, що її назва й форма збігаються з документами, що вона не перебуває в стані припинення і щодо неї не порушено справу про банкрутство. Для банків, платіжних установ, бухгалтерів, юристів та інших суб’єктів первинного фінансового моніторингу перевірка клієнта — вимога закону про запобігання та протидію легалізації (відмиванню) доходів, одержаних злочинним шляхом; її обсяг визначає оцінка ризиків самого суб’єкта. Іншим компаніям вона потрібна, щоб не підписати договір із юридичною особою, якої вже немає. Підтвердженням має бути запис із ЄДР, а не роздруківка чи знімок екрана, які надіслав контрагент.
Вручну (відкрити реєстр, зробити знімок екрана, переписати дані) це не працює, коли контрагентів сотні на місяць. Тому перевірку вбудовують в онбординг: код введено, запис повернуто, результат збережено як підтвердження.
Українську компанію знаходять за кодом ЄДРПОУ з 8 цифр (company_number) або за назвою (name). Для перевірки достатньо двох запитів:
GET /companies/search?country=UA&company_number=21673832 знаходить компанію й повертає стандартний об’єкт компанії;GET /companies/{id} повертає повний запис (використайте id з відповіді пошуку).curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=UA&company_number=21673832' \ -H 'Authorization: Bearer rk_live_...'
Скорочена відповідь на цей запит. Значення наведені для ілюстрації (дату замінено шаблоном), склад полів залежить від запису в реєстрі:
{
"data": [
{
"company_name": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО \"КИЇВСТАР\"",
"company_number": "21673832",
"legal_form": "ПрАТ",
"local_legal_form": "ПРИВАТНЕ АКЦІОНЕРНЕ ТОВАРИСТВО",
"status": "active",
"local_status": "зареєстровано",
"founding_date": "РРРР-ММ-ДД"
}
]
}
Назва в реєстрі записана великими літерами й українською, форма — скороченням, а local_status зберігає формулювання самого реєстру. Для автоматичного рішення читайте status: стандартний статус однаковий для всіх країн. Те саме на Python:
import requests
BASE = "https://api.prometiam.com/functions/v1/risk-api"
H = {"Authorization": "Bearer rk_live_..."}
def counterparty(code):
r = requests.get(f"{BASE}/companies/search", headers=H, timeout=30,
params={"country": "UA", "company_number": code})
r.raise_for_status()
data = r.json().get("data", [])
if not data:
return None # немає запису: перевірте код і тип особи
c = data[0]
return c["company_name"], c["status"], c.get("local_status")
print(counterparty("21673832"))
Нулі на початку коду ЄДРПОУ є частиною коду. Номер ПДВ — окремий номер, який присвоює податкова служба; у реєстрі його немає, тож пошук за vat для України не працює, а запит відхиляється.
| Поле | Що це означає |
|---|---|
company_name | Назва юридичної особи в реєстрі, великими літерами |
company_number, identifiers | Код ЄДРПОУ та інші ідентифікатори, які публікує реєстр |
legal_form, local_legal_form | Організаційно-правова форма: скорочення (ТОВ, ПрАТ, АТ, ДП) і формулювання реєстру |
status, local_status | Стандартний статус і формулювання реєстру; охоплює стан припинення та банкрутство |
founding_date, dissolution_date | Дата державної реєстрації та, якщо юридичну особу припинено, дата припинення |
capital_amount, capital_currency | Статутний капітал у гривнях (UAH), якщо реєстр його наводить |
Припинені юридичні особи теж є в даних, тож за кодом можна довести, що компанії вже немає; дату припинення наведено, якщо її називає реєстр. Дані оновлюються щотижня, тому свіжа зміна в реєстрі може з’явитися із запізненням.
Список контрагентів перевіряють одним викликом POST /companies/lookup (до 100 позицій). Країну задають для кожної позиції окремо, тож у списку можуть бути й іноземні компанії:
curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/companies/lookup' \
-H 'Authorization: Bearer rk_live_...' \
-H 'Content-Type: application/json' \
-d '{"items": [{"country": "UA", "company_number": "21673832"}, {"country": "ES", "company_number": "A46103834"}]}'
Кожна позиція рахується як окремий запит і коштує 1 кредит. Для кожної позиції відповідь містить status (found, not_found, error або timeout) та об’єкт company. Пакет, що не вміщується в ліміти тарифу, відхиляється одразу з помилкою 429 batch_exceeds_quota.
Реєстр змінюється й після перевірки. GET /company-events/search?country=UA&company_number=... (2 кредити) повертає події змін у реєстрі: назву, статус, організаційно-правову форму та статутний капітал. Подію датовано днем, коли зміну вперше побачено в даних реєстру (дані читаються щотижня). Адрес у подіях немає, бо реєстр їх не публікує, а подій раніше за запуск України в жовтні 2026 року немає. Без company_number той самий виклик повертає стрічку недавніх подій усієї країни: за замовчуванням за 7 днів, не далі ніж на 31 день назад.
Щоб не опитувати стрічку, додайте клієнта до моніторингу: POST /monitor з полями country (значення UA) і company_id (з відповіді пошуку). Вебхук повідомить про зміну статусу, припинення, збіг із санкційними списками (бета) та події змін у реєстрі; повний приклад — на сторінці перевірки постачальника. Моніторинг є в усіх охоплених країнах, крім Франції та Аргентини.
Prometiam автоматизує крок «перевірити в реєстрі наявність і статус юридичної особи», але не всю належну перевірку: оцінка ризиків, встановлення кінцевого бенефіціарного власника й рішення залишаються за вами. Дані адаптовані Prometiam і не є офіційним витягом з ЄДР; офіційний витяг видає реєстр (Міністерство юстиції України).
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 кредитів): один запис коштує 1 кредит, відповіді з помилками безкоштовні. Пробний період триває 14 днів і містить 500 кредитів: потрібна банківська картка, під час пробного періоду кошти не списуються, далі діє Starter, якщо ви не скасуєте підписку. Той самий об’єкт компанії працює для 31 країни, тож для іноземного контрагента нова інтеграція не потрібна. Докладніше: ціни.
Розпочати безкоштовний 14-денний пробний період · Документація API
Пробний період триває 14 днів і містить 500 кредитів. Потрібна банківська картка, під час пробного періоду кошти не списуються; далі діє тариф Starter (9,99 € на місяць), якщо ви не скасуєте підписку.