Довідник інструментів
find_awards
лише читанняАналітикаFind completed tenders and winners
Finds award decisions in completed Prozorro procurements with winners, expected vs awarded value, discount and number of bidders, plus summary statistics (average discount, median award, average bids). Covers procurements stored within the analytics window (default 730 days).
- query (string | null) — Keywords in tender titles/descriptions
- cpv (array | null) — CPV / ДК 021 codes or prefixes
- regions (array | null) — Ukrainian regions by name or slug
- buyer_edrpou (string | null) — Buyer EDRPOU
- supplier_edrpou (string | null) — Winner EDRPOU / tax number
- date_from (string | null) — Award date on or after (YYYY-MM-DD)
- date_to (string | null) — Award date on or before (YYYY-MM-DD)
- value_min (number | null) — Minimum award value
- value_max (number | null) — Maximum award value
- competitive_only (boolean) — Exclude direct contracts and negotiated procedures
- limit (integer) — Awards per page
- cursor (string | null) — next_cursor from the previous page
get_buyer_profile
лише читанняАналітикаBuyer (procuring entity) profile
Profiles a procuring entity by EDRPOU: number and expected value of its procurements, completed, cancelled and unsuccessful shares, typical procedures, top CPV categories, awards with average discount, most frequent winners and currently open tenders.
- edrpou * (string) — EDRPOU code (8 digits) or a sole trader's tax number (10 digits)
get_company_profile
лише читанняGet company profiles
Returns the organization's saved company profiles (name, EDRPOU, CPV codes, regions, keywords, value range, EU countries and capabilities) used to personalise searches and alerts.
- profile_id (string | null) — Profile id; omit to list all profiles
get_price_benchmark
лише читанняАналітикаPrice benchmark for a CPV code
Computes the distribution of awarded unit prices (n, min, 25th percentile, median, 75th percentile, max, mean) for a CPV code from single-item lots with a quantity, excluding obvious outliers. Falls back to the distribution of award totals when no unit prices exist. Includes the awards closest to the median.
- cpv * (string) — One CPV / ДК 021 code or prefix, e.g. 09134200-9 or 0913
- unit (string | null) — Unit of measure as code (KGM, LTR, H87) or name (кг, л, шт); default: the most common unit
- query (string | null) — Keywords to narrow the items, e.g. 'А-95'
- regions (array | null) — Ukrainian regions by name or slug
- date_from (string | null) — Award date on or after
- date_to (string | null) — Award date on or before
- vat (string) — Filter awards by VAT inclusion
get_supplier_profile
лише читанняАналітикаSupplier (competitor) profile
Profiles a supplier by EDRPOU or tax number: wins and total awarded value, average discount, top buyers, CPV categories, participation vs wins where bids are disclosed, and recent wins.
- edrpou * (string) — EDRPOU code (8 digits) or a sole trader's tax number (10 digits)
get_ted_notice
лише читанняПерегляди тендерівGet EU tender notice (TED)
Returns details of a TED notice: description, lots, links to procurement documents, buyer contacts, place of performance, estimated value, deadline and the notice PDF. Data © European Union, TED.
- publication_number * (string) — TED publication number, e.g. 712345-2026
get_tender
лише читанняПерегляди тендерівGet Prozorro tender details
Returns full details of a Prozorro tender. Includes items with CPV codes and delivery, lots, key dates, payment terms, guarantee, qualification criteria, questions, the document list, disclosed bids, award decisions with discounts, contracts and cancellation details.
- tender * (string) — Tender id UA-YYYY-MM-DD-NNNNNN-x, 32-character internal id or a prozorro.gov.ua link
get_tender_documents
лише читанняДокументиRead tender documents
Lists the documents of a Prozorro tender or returns their extracted text. Without document_ids it returns the document list (title, type, format, date) at no cost. With document_ids it downloads up to 3 files and returns the requested text page of each. Supported formats: PDF, DOCX, DOC, XLSX, XLS, ODT, RTF, HTML, TXT, ZIP archives and e-signed .p7s files (the signed content and the signer are extracted). Scans without a text layer are flagged needs_ocr. Each document opened for the first time in 30 days counts towards the monthly Documents limit.
- tender * (string) — Tender id UA-..., internal id or prozorro.gov.ua link
- document_ids (array | null) — Ids of up to 3 documents to extract; omit to list the documents only
- page (integer) — Text page (about 12,000 characters each)
get_usage
лише читанняGet plan and usage
Returns the organization's current plan, subscription status, usage of each metered limit in the current billing period, object caps and the plan's features.
list_alert_matches
лише читанняList alert matches
Lists tenders and TED notices that matched the organization's alerts, newest first.
- alert_id (string | null) — Only matches of this alert
- days (integer) — Matches from the last N days
- limit (integer) — Matches per page
- cursor (string | null) — next_cursor from the previous page
list_alerts
лише читанняList alerts
Lists the organization's saved alerts with their filters, sources, channels, frequency, status and the number of matches in the last 30 days.
list_watched_tenders
лише читанняList watched tenders
Lists the organization's watched tenders with their current status, deadline and the latest detected changes.
- limit (integer) — Tenders per page
- cursor (string | null) — next_cursor from the previous page
lookup_cpv
лише читанняFind CPV / ДК 021 codes
Looks up CPV 2008 / ДК 021:2015 codes (9,458 codes, Ukrainian and English names) by words or by code, with parent levels; for a single exact code the direct sub-codes are listed too. Does not count towards any limit.
- query * (string) — Words in Ukrainian or English (e.g. 'ремонт даху', 'laptops') or a code/prefix
- level (string | null) — Restrict results to one hierarchy level
- limit (integer) — Maximum number of codes
search_ted
лише читанняПошукиSearch EU tenders (TED)
Searches EU public procurement notices on TED (Tenders Electronic Daily). Queries the official TED Search API live (results cached for one hour) for competition notices and returns the English and original-language titles, buyer, country, CPV codes, publication date, deadline, estimated value and a link to the notice. Falls back to the stored copy when TED is unavailable. Data © European Union, TED.
- query (string | null) — Keywords (any EU language); "exact phrase" supported
- countries (array | null) — Buyer countries as ISO 3166 alpha-3 codes or names, e.g. ['POL', 'DEU', 'Lithuania']
- cpv (array | null) — CPV codes or prefixes, e.g. ['45233', '72000000']
- published_from (string | null) — Published on or after (YYYY-MM-DD)
- deadline_from (string | null) — Tender deadline on or after (YYYY-MM-DD); defaults to today when only_open
- only_open (boolean) — Only notices whose submission deadline has not passed
- limit (integer) — Notices per page
- cursor (string | null) — next_cursor from the previous page
search_tenders
лише читанняПошукиSearch Prozorro tenders
Searches Ukrainian public tenders stored from Prozorro (refreshed every 5 minutes). By default only open tenders (enquiry and bid submission periods) are returned, ranked by relevance. Each result has the tender id, title, buyer, region, expected value, bid deadline, status, main CPV code, a link to prozorro.gov.ua and a short snippet. Returns up to 50 results per page with a cursor.
- query (string | null) — Keywords in Ukrainian or English. Word forms are matched (ремонт = ремонту); supports "exact phrase", OR between alternatives and -word to exclude.
- cpv (array | null) — CPV / ДК 021 codes or prefixes, e.g. ['45261000-4', '4526', '09']; sub-codes are included
- regions (array | null) — Ukrainian regions by name or slug, e.g. ['Київська область', 'lviv', 'kyiv']
- statuses (array | null) — Tender statuses; default ['active.enquiries', 'active.tendering'] (open for bids)
- methods (array | null) — procurementMethodType values, e.g. belowThreshold, aboveThreshold, priceQuotation
- category (string | null) — Main procurement category
- value_min (number | null) — Minimum expected value, UAH
- value_max (number | null) — Maximum expected value, UAH
- buyer_edrpou (string | null) — Buyer EDRPOU code (8 digits)
- published_from (string | null) — Published on or after (YYYY-MM-DD)
- published_to (string | null) — Published on or before (YYYY-MM-DD)
- deadline_from (string | null) — Bid deadline on or after (YYYY-MM-DD)
- deadline_to (string | null) — Bid deadline on or before (YYYY-MM-DD)
- international_funding (boolean | null) — True: only tenders with international funders listed; False: without
- profile_id (string | null) — Company profile id, or 'default', whose codes, regions, keywords and value range fill empty filters
- sort (string) — Sort order
- limit (integer) — Tenders per page
- cursor (string | null) — next_cursor from the previous page
create_alert
зміна данихCreate alert
Creates a saved alert that matches new Prozorro tenders (and optionally TED notices) against filters and notifies the user by email and/or Telegram. Frequency and channels depend on the plan; the number of alerts is limited by the plan.
- name * (string) — Alert name
- query (string | null) — Keywords (same syntax as search_tenders)
- cpv (array | null) — CPV / ДК 021 codes or prefixes
- regions (array | null) — Ukrainian regions (names or slugs)
- methods (array | null) — procurementMethodType values
- category (string | null) — Main category
- value_min (number | null) — Minimum expected value, UAH
- value_max (number | null) — Maximum expected value, UAH
- buyer_edrpou (string | null) — Only tenders of this buyer
- countries (array | null) — EU countries for TED matches (ISO alpha-3 or names)
- sources (array | null) — Data sources; default ['prozorro']
- channels (array | null) — Delivery channels; default ['email']
- frequency (string) — realtime, daily (07:30 Kyiv) or weekly (Monday)
- profile_id (string | null) — Fill empty filters from this company profile ('default' allowed)
watch_tender
зміна данихWatch tender for changes
Adds a Prozorro tender to the organization's watchlist; changes of status, deadlines, documents, questions, complaints, awards, contracts and cancellations are recorded every 15 minutes and sent to the user. The number of watched tenders is limited by the plan.
- tender * (string) — Tender id UA-..., internal id or prozorro.gov.ua link
- note (string | null) — Private note
delete_alert
незворотна діяDelete alert
Permanently deletes an alert and its stored matches.
- alert_id * (string) — Alert id from list_alerts
save_company_profile
незворотна діяSave company profile
Creates or updates a company profile of the organization (codes, regions, keywords, value range, EU countries, capabilities). The number of profiles is limited by the plan.
- name * (string) — Company name
- cpv_codes (array | null) — CPV / ДК 021 codes or prefixes the company supplies
- regions (array | null) — Ukrainian regions served (names or slugs)
- keywords (array | null) — Keywords describing the products/services
- value_min (number | null) — Preferred minimum expected value, UAH
- value_max (number | null) — Preferred maximum expected value, UAH
- countries (array | null) — EU countries of interest for TED (ISO alpha-3 or names)
- edrpou (string | null) — Company EDRPOU or sole trader tax number
- capabilities (string | null) — Short description of capabilities, experience, certificates
- profile_id (string | null) — Id of the profile to update; omit to create a new one
- make_default (boolean) — Make this the profile used when 'default' is requested
unwatch_tender
незворотна діяStop watching tender
Removes a tender from the organization's watchlist and deletes its recorded change history.
- tender * (string) — Tender id UA-... or internal id of a watched tender
update_alert
незворотна діяUpdate alert
Updates an existing alert: name, filters (each provided filter replaces the old value), sources, channels, frequency or active state.
- alert_id * (string) — Alert id from list_alerts
- name (string | null) — New name
- query (string | null) — New keywords; empty string removes them
- cpv (array | null) — New CPV codes (replaces the old list)
- regions (array | null) — New regions (replaces the old list)
- methods (array | null) — New procedure types (replaces the old list)
- category (string | null) — New category; 'any' removes it
- value_min (number | null) — New minimum value; 0 removes it
- value_max (number | null) — New maximum value; 0 removes it
- countries (array | null) — New TED countries (replaces the old list)
- sources (array | null) — New sources
- channels (array | null) — New channels
- frequency (string | null) — New frequency
- is_active (boolean | null) — Pause (false) or resume (true) the alert