Search Prozorro.Sale auctions
search_auctionsFind Ukrainian public asset auctions by procedure type, region, keyword, price, and owner. Filter by open-for-bids status to see what you can bid on now.
Instructions
Find auctions of Ukrainian public assets. The entry point for any "what is available" question.
WHEN TO USE: the user describes what they are looking for rather than naming one auction. For a specific auction id, call get_auction instead.
KEY PARAMETERS
procedure_type: name the asset programme whenever the user implies one ("land", "privatisation", "lease"). This switches to per-type feeds and covers far more relevant auctions. Family names ("landRental") expand to every format; exact values ("landRental-english") are used as-is. Call list_procedure_types if unsure of the vocabulary.
open_for_bids: true for "what can I bid on" — keeps only auctions whose deadline has not passed.
keyword: Ukrainian free text over title, description, items, classification, locality. All words must match.
region / classification / min_value / max_value / published_from / published_to: narrowing filters.
seller / seller_edrpou: the body RUNNING the auction (often a regional SPFU office).
property_owner / property_owner_edrpou: the organisation the asset BELONGS to — the university, hospital or school whose premises are leased out. Use this when the user names an institution: on lease auctions the institution is almost never the seller. EDRPOU is exact, prefer it. Published by the legitimatePropertyLease family only; elsewhere owner and seller are the same body.
changed_since + changed_until: scan a specific historical period instead of recent activity.
scan_pages: raise (up to 40) when a broad query comes back thin or truncated.
EXAMPLE — everything Lviv Polytechnic put up for lease this year: {"procedure_type":["legitimatePropertyLease"],"property_owner_edrpou":"02071010", "changed_since":"2026-01-01","changed_until":"2026-08-06","scan_pages":40}
EXAMPLE — property lease near Lviv, still open, under 50 000 UAH: {"procedure_type":["legitimatePropertyLease"],"open_for_bids":true,"region":"Львів","max_value":50000,"limit":10}
EXAMPLE — everything privatisation-related sold in July 2026: {"procedure_type":["smallPrivatization","largePrivatization"],"status":["complete"], "changed_since":"2026-07-01","changed_until":"2026-07-31","scan_pages":25}
RETURNS: compact auction summaries (id, title, status, price, region, seller, propertyOwner, deadlines, auctionUrl) plus a "scanned" block. ALWAYS relay that block's window and truncation to the user — an empty result means "not in the scanned window", never "does not exist".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results to return. Default 20. | |
| region | No | Substring of the oblast or settlement name, e.g. "Львів", "Київська". | |
| seller | No | Substring of the selling entity name. | |
| status | No | Procedure statuses to keep, e.g. ["active_tendering"] for auctions still accepting bids, ["complete"] for concluded sales. Omit for all statuses. | |
| keyword | No | Free text matched against title, description, item descriptions, classification names and locality. Ukrainian works best. All words must appear. | |
| max_value | No | Maximum starting price, in the auction currency. | |
| min_value | No | Minimum starting price, in the auction currency. | |
| scan_pages | No | How many feed pages (100 auctions each) may be scanned. Higher covers more of the window at the cost of latency. Default 8. | |
| published_to | No | Keep only auctions published on or before this ISO date. | |
| changed_since | No | ISO date or instant that bounds the change window to scan. Defaults to 7 days ago. Older auctions are only visible if they were modified inside the window. | |
| changed_until | No | Upper bound of the change window, ISO date or instant. Defaults to now. | |
| open_for_bids | No | Shortcut for "I want to bid": keeps only auctions whose bidding deadline has not passed and whose status still accepts bids. | |
| seller_edrpou | No | Registration code (ЄДРПОУ) of the selling entity, e.g. "42899921". Leading zeros optional. | |
| classification | No | CAV/CPV classification code or prefix, e.g. "07" for land or "07123000-7" exactly. | |
| procedure_type | No | Asset programme or exact selling method. A family name such as "landRental" or "smallPrivatization" expands to every auction format it supports; an exact value such as "landRental-english" is used as-is. Call list_procedure_types for the vocabulary. | |
| property_owner | No | Substring of the name of the organisation the asset BELONGS to (балансоутримувач) — the university, hospital or school whose property is being auctioned, as opposed to the body running the sale. Published by the legitimatePropertyLease family only; other programmes have no owner distinct from the seller, so combine with keyword there. | |
| published_from | No | Keep only auctions published on or after this ISO date, e.g. "2026-01-01". | |
| property_owner_edrpou | No | Registration code (ЄДРПОУ) of that organisation, e.g. "02071010" for Lviv Polytechnic. Leading zeros optional. Exact and far more reliable than a name substring. |