Судові справи компанії на Python: перевірка списку ЄДРПОУ

Оновлено 26.09.2026

Аналітик отримав список контрагентів, клієнтів з відстрочкою чи компаній-кандидатів для угоди і має зрозуміти, хто з них судиться і в якій ролі. Вручну перевіряти кожну компанію в реєстрі судових рішень довго. Initask API повертає справи, де компанія згадана стороною, запитом `GET https://dani.initask.com/v1/company/{edrpou}/court-cases`, і скрипт на Python проходить увесь список за кілька хвилин.

Базовий запит

```python import os, requests

r = requests.get( "https://dani.initask.com/v1/company/36264680/court-cases", headers={"Authorization": f"Bearer {os.environ['INITASK_KEY']}"}, timeout=10, ) body = r.json() print(r.headers["X-RateLimit-Remaining"], body["data"]) ```

Ключ зберігається у змінній середовища `INITASK_KEY`, у тексті скрипта його немає. Без ключа доступно 100 запитів на добу з однієї IP-адреси, цього досить для невеликого списку.

Що повертає запит

Для коду 36264680 відповідь містить назву ТОВ «ТС ПЛЮС», загальну кількість справ 1 і перелік справ. Єдина справа має номер 910/11846/26, суд Господарський суд міста Києва, категорію «Справи наказного провадження», дату останнього рішення 2026-09-21 і роль «позивач або заявник». Також є посилання на сторінку справи.

Поле	Що означає
name	назва компанії, як її записано у рішеннях; null, коли справ немає
total	скільки справ знайдено
cases	справи, найсвіжіші першими
cases[].date	дата останнього рішення
cases[].role	роль компанії: позивач або заявник, відповідач або боржник, третя особа
cases[].url	сторінка справи на sud.initask.com

Кожна справа також має номер, суд і категорію. Номер справи потрібен, щоб знайти рішення в державному реєстрі, суд підказує, господарський це спір чи інший, а категорія показує предмет спору.

Звіт за портфелем компаній

Для списку контрагентів корисно звести результат у таблицю, де кожна компанія має кілька показників: загальна кількість справ, кількість справ, де вона відповідач або боржник, кількість справ за останній рік і дата найсвіжішого рішення. Роль рахується за полем `role`, свіжість за полем `date`. Відсортована за кількістю справ у ролі відповідача таблиця одразу показує, на кого варто подивитися уважніше.

Окремо корисно порахувати категорії. Якщо в компанії багато справ однієї категорії, це характер її бізнесу: наприклад, фінансова компанія постійно стягує борги і виступає позивачем. Такий портрет точніший за просту кількість справ.

Звідки дані і де тексти

Дані беруться з відкритих даних Єдиного державного реєстру судових рішень, які публікує Державна судова адміністрація. Сервіс sud.initask.com звʼязує сторони рішень з кодами ЄДРПОУ, і тому пошук за кодом працює навіть там, де в самому рішенні назва компанії записана з помилками. Тексти рішень у відповідь не входять: якщо для аналізу потрібен зміст, скрипт зберігає посилання на сторінку справи, і юрист відкриває потрібні вручну.

Порожня історія

Компанія без справ отримує відповідь 200 з `total: 0`, порожнім переліком `cases` і `name`, що дорівнює null. Скрипт має обробляти цей випадок як нормальний результат: компанію перевірено, і справ у неї немає. У звіті такі компанії варто позначати окремо, щоб було видно, що їх перевірили.

Коди і помилки

Код ЄДРПОУ юридичної особи має 8 цифр. Коротший код шлюз доповнює нулями зліва, тому коди, які в таблиці втратили нулі на початку, працюють. Відповідь 400 приходить, якщо в коді є сторонні символи або він довший за 8 знаків. Коди з такою помилкою варто записувати в журнал і перевіряти джерело списку.

Код відповіді	Що робити у скрипті
200	обробити дані, навіть якщо справ нуль
400	записати код у журнал помилок і пропустити
429	зачекати стільки секунд, скільки в заголовку Retry-After, і повторити

Заголовки `X-RateLimit-Remaining` і `X-RateLimit-Reset` показують залишок і момент скидання ліміту. Для великого списку скрипт може стежити за залишком і сам робити паузу.

Ліміти і кеш

Відповідь кешується на 60 хвилин, тому повторний запуск скрипта протягом години не витрачає ліміт на ті самі коди.

План	Запитів	Ціна, грн на місяць
Безкоштовний	100 на добу	0
Старт	10000 на місяць	990
Про	100000 на місяць	2990

Що робити

Запустіть приклад з кодом 36264680 і подивіться повну відповідь.
Пройдіть свій список кодів з обробкою 400 і 429.
Зведіть результат у таблицю з кількістю справ за ролями і свіжістю.
Додайте до звіту дані з картки компанії за ЄДРПОУ і API тендерів.
Опис полів у документації судових справ, тарифи на сторінці Ціни і ліміти.

Питання і відповіді

Як отримати судові справи компанії в Python?

Запит requests.get до https://dani.initask.com/v1/company/{edrpou}/court-cases з ключем у заголовку Authorization повертає total і перелік cases з номером, судом, категорією, датою і роллю.

Як обробити компанію без справ?

Відповідь 200 з total: 0, порожнім cases і name, що дорівнює null. Це нормальний результат: компанію перевірено, справ немає.

Чи треба дописувати нулі на початку коду ЄДРПОУ?

Ні, коротший код шлюз доповнює нулями зліва до 8 цифр.