Skip to content
Torhy

Tools reference

find_awards

read-onlyAnalytics

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

read-onlyAnalytics

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

read-only

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

read-onlyAnalytics

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

read-onlyAnalytics

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

read-onlyTender views

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

read-onlyTender views

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-onlyDocuments

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

read-only

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

read-only

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

read-only

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

read-only

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

read-only

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

read-onlySearches

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

read-onlySearches

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

write

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

write

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

destructive

Delete alert

Permanently deletes an alert and its stored matches.

alert_id
* (string) — Alert id from list_alerts

save_company_profile

destructive

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

destructive

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

destructive

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