API тендерів компанії: замовник і переможець у Prozorro

За кодом ЄДРПОУ шлюз повертає підсумок участі компанії у публічних закупівлях Prozorro (кількість тендерів замовника і їх очікувану суму, кількість перемог і суму договорів) і перелік тендерів обраної ролі: номер UA-…, назву, статус, суму, дату і посилання, найсвіжіші першими.

Де застосовують: Оцінка контрагента за досвідом у держзакупівлях, пошук постачальників з перемогами, аналітика ринку закупівель.

Запит

GEThttps://dani.initask.com/v1/company/{edrpou}/tenders

Параметр	Де	Опис
`edrpou` обовʼязковий	шлях	Код ЄДРПОУ (8 цифр) або РНОКПП підприємця (10 цифр).
`role`	запит	buyer: тендери, які компанія оголосила як замовник; winner: тендери, які вона виграла. Без параметра buyer.
`limit`	запит	Скільки тендерів у переліку, від 1 до 200. Без параметра 50.

Приклади

curl

curl -H "Authorization: Bearer $INITASK_KEY" "https://dani.initask.com/v1/company/42062483/tenders?role=buyer&limit=3"

JavaScript

const r = await fetch("https://dani.initask.com/v1/company/42062483/tenders?role=buyer&limit=3", {
  headers: { Authorization: `Bearer ${process.env.INITASK_KEY}` },
});
const { ok, data, error } = await r.json();
console.log(r.headers.get("X-RateLimit-Remaining"), data);

Python

import os, requests

r = requests.get(
    "https://dani.initask.com/v1/company/42062483/tenders?role=buyer&limit=3",
    headers={"Authorization": f"Bearer {os.environ['INITASK_KEY']}"},
    timeout=10,
)
body = r.json()
print(r.headers["X-RateLimit-Remaining"], body["data"])

Змінна INITASK_KEY містить ваш ключ. Без ключа запит теж пройде в межах 100 запитів на добу.

Відповідь

Справжня відповідь на запит /v1/company/42062483/tenders?role=buyer&limit=3, масиви скорочено до трьох елементів.

{
  "ok": true,
  "data": {
    "edrpou": "42062483",
    "name": "Управління з питань ветеранської політики Дніпропетровської обласної державної адміністрації",
    "as_buyer": 8,
    "buyer_sum": 294448,
    "as_winner": 0,
    "win_sum": 0,
    "buyer_url": "https://tender.initask.com/zamovnyk/42062483",
    "winner_url": "https://tender.initask.com/uchasnyk/42062483",
    "role": "buyer",
    "total": 8,
    "items": [
      {
        "tenderID": "UA-2026-09-26-000029-a",
        "title": "Надання послуг із соціально-психологічної адаптаціі  ветеранів  війни, членів їх сімей членів сімей загиблих (померлих) ветеранів війни, членів сімей загиблих (померлих) Захисників і Захисниць України шляхом  відшкодування вартості послуг",
        "status": "complete",
        "amount": 33460,
        "currency": "UAH",
        "date": "2026-09-26T00:49:57.199203+03:00",
        "url": "https://tender.initask.com/tender/UA-2026-09-26-000029-a"
      },
      {
        "tenderID": "UA-2026-09-26-000026-a",
        "title": "Надання послуг із соціально-психологічної адаптаціі  ветеранів  війни, членів їх сімей членів сімей загиблих (померлих) ветеранів війни, членів сімей загиблих (померлих) Захисників і Захисниць України шляхом  відшкодування вартості послуг",
        "status": "complete",
        "amount": 33460,
        "currency": "UAH",
        "date": "2026-09-26T00:48:10.518734+03:00",
        "url": "https://tender.initask.com/tender/UA-2026-09-26-000026-a"
      },
      {
        "tenderID": "UA-2026-09-26-000021-a",
        "title": "Надання послуг із соціально-психологічної адаптаціі  ветеранів  війни, членів їх сімей членів сімей загиблих (померлих) ветеранів війни, членів сімей загиблих (померлих) Захисників і Захисниць України шляхом  відшкодування вартості послуг",
        "status": "complete",
        "amount": 33460,
        "currency": "UAH",
        "date": "2026-09-26T00:35:07.804193+03:00",
        "url": "https://tender.initask.com/tender/UA-2026-09-26-000021-a"
      }
    ]
  },
  "meta": {
    "source": "tender.initask.com",
    "cached": false
  }
}

`edrpou`	код
`name`	назва з Prozorro
`as_buyer`	тендерів як замовник
`buyer_sum`	очікувана сума тендерів замовника, грн
`as_winner`	перемог як учасник
`win_sum`	сума перемог, грн
`buyer_url`	сторінка тендерів замовника
`winner_url`	сторінка перемог учасника
`role`	роль переліку: buyer або winner
`total`	скільки всього тендерів у цій ролі
`items`	тендери, найсвіжіші першими; null, коли перелік тимчасово недоступний
`items[].tenderID`	номер тендера в Prozorro
`items[].title`	назва закупівлі
`items[].status`	статус у Prozorro
`items[].amount`	очікувана сума замовника або сума перемоги
`items[].currency`	валюта
`items[].date`	дата оголошення або перемоги
`items[].url`	сторінка тендера

Помилки

HTTP	error	Коли
400	`bad_request`	код має довжину, відмінну від 5-8 або 10 цифр, role поза buyer і winner або limit поза 1-200
429	`rate_limited`	ліміт вичерпано, дивіться Retry-After
502, 504	`upstream_*`	джерело даних недоступне, ліміт не витрачається

Джерело і свіжість

Дані: Prozorro (публічні закупівлі), tender.initask.com. Шлюз тримає відповідь у кеші 10 хв, поле meta.cached показує, звідки вона.

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

Звідки дані про тендери?

З відкритого API Prozorro: сервіс tender.initask.com завантажує тендери і рахує підсумки за кодом замовника і переможця.

Чому у відповіді нулі?

Нулі означають, що у завантажених тендерах компанія не була ні замовником, ні переможцем. Поле name тоді дорівнює null, а items порожній масив.

Як отримати тендери, які компанія виграла?

Додайте role=winner: у items прийдуть перемоги з сумою договору і датою перемоги. Параметр limit задає до 200 тендерів за запит.

Повʼязані ендпоінти

Отримати ключ API

Ключ прийде листом з каси Initask. Безкоштовний ключ дає 100 запитів на добу, платний тариф додається до того самого ключа.